Decision 0035 · Superseded
Open the spec issue
at acceptance
Decision 0029 opens a public spec issue as part of "spec it", so teammates can read and comment on a draft without opening the repository.
- Status
- Superseded
- Built from:
- da88c48
Status: Superseded (2026-10-29). Was Accepted (2026-10-28). Amends 0029 (the spec issue opens at "spec it", labelled draft). Spec: 021. Amended by 0044 (acceptance also happens on "build it" or "ship it"; no body sync). Superseded by 0044 (no spec issue).
Context
Decision 0029 opens a public spec issue as part of "spec it", so teammates can read and comment on a draft without opening the repository. In practice the maintainer reviews drafts locally: early issues published unreviewed text on a public repository, and each revision before acceptance cost a sync.
Decision
"Spec it" writes and commits the draft locally on the spec branch and publishes nothing. "Accept the spec" pushes the branch and opens the spec issue labelled accepted. "Share the draft" opens the issue early, labelled draft, when the user wants comments before accepting; acceptance then relabels it. to-spec opens a candidate issue only when asked. The accepted label stays the delivery gate.
Alternatives
- Keep opening at "spec it" (0029). Rejected as the default: it publishes text nobody approved and adds sync churn for solo review.
- Open only at "break it down". Rejected: acceptance is the approval moment, and the gate label belongs to it.
Consequences
- Nothing about a spec is public until it is accepted, unless the user shares the draft.
- The
draftlabel is used only for shared drafts.