Retrospective finding — refs #10.
Context
RepoKit standardises commits, changelogs, docs and checklists — but says nothing about issue
labels. In practice, repos either run GitHub's stock labels untouched or invent a local scheme
mid-project; cross-repo project boards then have no consistent vocabulary to filter on. A
standard needs to work for both public and private repos, for solo repos and for multi-person
board-driven ones, without adding ceremony to repos that barely use issues.
Proposal
A standard/labels.md reference defining a small layered scheme:
- Keep GitHub defaults (
bug, enhancement, documentation, question, …) as the base —
they cost nothing and external contributors know them.
- Namespace conventions (adopt only the namespaces the repo needs):
area:<topic> — repo-defined functional areas; the namespace is standard, values are local.
agent:<name> — work authored/held by an AI agent (e.g. agent:claude).
- Workflow verdicts for board-driven repos:
rework (implementation failed review),
needs-respec (spec was wrong — back to backlog), blocked.
campaign:<name> (or similar) — time-boxed cross-cutting efforts (an audit's follow-up
batch), so they can be swept in one filter.
- Fixed colours per namespace so labels read the same across repos.
- Bootstrap: a documented one-liner (
gh label clone or a small script in scripts/) to
apply the set to a new or existing repo; scaffolding applies it automatically.
Tasks
Acceptance criteria
- A new scaffolded repo gets the base set automatically; an existing repo can adopt it with one
command.
- The scheme is documented as layered/opt-in — a solo private repo is compliant with defaults
only.
— 🤖 Claude, on behalf of @PBNZ
Retrospective finding — refs #10.
Context
RepoKit standardises commits, changelogs, docs and checklists — but says nothing about issue
labels. In practice, repos either run GitHub's stock labels untouched or invent a local scheme
mid-project; cross-repo project boards then have no consistent vocabulary to filter on. A
standard needs to work for both public and private repos, for solo repos and for multi-person
board-driven ones, without adding ceremony to repos that barely use issues.
Proposal
A
standard/labels.mdreference defining a small layered scheme:bug,enhancement,documentation,question, …) as the base —they cost nothing and external contributors know them.
area:<topic>— repo-defined functional areas; the namespace is standard, values are local.agent:<name>— work authored/held by an AI agent (e.g.agent:claude).rework(implementation failed review),needs-respec(spec was wrong — back to backlog),blocked.campaign:<name>(or similar) — time-boxed cross-cutting efforts (an audit's follow-upbatch), so they can be swept in one filter.
gh label cloneor a small script inscripts/) toapply the set to a new or existing repo; scaffolding applies it automatically.
Tasks
standard/labels.md(scheme, colours, when to adopt which namespace).rework/needs-respecsemantics aredefined in exactly one place.
Acceptance criteria
command.
only.
— 🤖 Claude, on behalf of @PBNZ