spec-authoringlisted
Install: claude install-skill AlexCiortan/setlist
Condensed binding of Appendix C and Part 5 of the edition committed in this
repo. On any conflict, the edition text wins; load the template with
`bash "${CLAUDE_PLUGIN_ROOT}/scripts/part.sh" appendix-c`, or copy
specs/TEMPLATE.md, which is the same text, stamped at bootstrap.
## Authoring
- Every spec starts as a copy of specs/TEMPLATE.md, numbered sequentially
(spikes are 0000). Statuses: DRAFT, QUEUED, ACTIVE, REVISED, BUILT, PARKED,
CLOSED (Part 5 carries the canonical list; BUILT and PARKED are v1.7, and
both mean the work is NOT on the trunk).
- A spike's output is a decision, and it lands as a citable artifact, never as
prose: an ADR (the usual case), or a Decision section in the spike file's
Closing report. Dependent specs cite it by path, so the dependency is a file
reference, not a remembered sentence.
- The tier is one header line (edition v1.14). `Tier: full` is what the
template ships; `Tier: lite`, exactly so, at column 0 above the Closing
report heading, declares the trimmed shape of Part 5: one acceptance
criterion (plus the human-acceptance item where the work is
experience-critical), the v1.7 clauses deleted, the Gates block unchanged,
the Closing report kept whole where the gates read it (the one-line QA
verdict block, QA Pass 2, the mandatory diagram field). A lite spec owns at
most five files (checkpoint writes the `Owns:` lines and refuses a sixth;
the close refuses `SLH-LITE-OVERSIZED`). A change that will touch more is a