diff options
| author | Craig Jennings <c@cjennings.net> | 2026-06-09 17:11:49 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-06-09 17:11:49 -0500 |
| commit | 1f0900281b8262539137bc1aff3f01cc05745139 (patch) | |
| tree | 3c4ae7217f2870aab01b91fa7ef2f6aefd171644 /.ai/workflows/INDEX.org | |
| parent | 4daecc8c3957f4e6355c9591bb5fccd481933b58 (diff) | |
| download | rulesets-1f0900281b8262539137bc1aff3f01cc05745139.tar.gz rulesets-1f0900281b8262539137bc1aff3f01cc05745139.zip | |
feat(workflows): add spec-create, the author leg of the spec trio
spec-create is the front of the spec-create → spec-review → spec-response trio: the author writes a short design spec before non-trivial code, shaped to pass spec-review's readiness gate. It runs a when-to-spec proportionality gate first, then problem-first framing, design with forced alternatives and inline mini-ADR decisions, implementation phases with acceptance criteria and a readiness-dimensions menu, a terseness pass, and a hand-off self-check against the review rubric.
Diffstat (limited to '.ai/workflows/INDEX.org')
| -rw-r--r-- | .ai/workflows/INDEX.org | 2 |
1 files changed, 2 insertions, 0 deletions
diff --git a/.ai/workflows/INDEX.org b/.ai/workflows/INDEX.org index 157a4e7..9b957d2 100644 --- a/.ai/workflows/INDEX.org +++ b/.ai/workflows/INDEX.org @@ -73,6 +73,8 @@ This index must list every =.org= file in =.ai/workflows/= except this one and e ** Specs and design +- =spec-create.org= — author a design/feature spec before non-trivial work (more than ~6 hours, or real trade-offs): a when-to-spec gate, then problem-first framing, design + alternatives + inline mini-ADR decisions, implementation phases + acceptance criteria + a readiness-dimensions menu, a terseness pass, and a hand-off self-check against the review rubric. The *author* side that starts the trio; its output feeds =spec-review.org=. + - Triggers: "let's write a spec", "spec this out", "create a spec for X", "spec-create workflow" - =spec-review.org= — review a design/feature spec for implementation-readiness: run the readiness gate, read the code first, evaluate across dimensions, assign a rubric (Ready / Ready-with-caveats / Not-ready / Needs-research), and write a =<spec>-review.org= file when not ready. The *reviewer* side; its output feeds =spec-response.org=. - Triggers: "review the spec", "is this spec implementation-ready?", "spec-review workflow", "review the design" - =spec-response.org= — fold an external spec review back in: decide accept / modify / reject for every recommendation, weave accepts into the spec body, document modifies and rejects in a "Review dispositions" section, reconcile cross-spec tensions, iterate to implementation-ready. The *author* side; consumes the =<spec>-review.org= file =spec-review.org= produces. |