fix(config): rewrite all skill discipline files for simplified model
All checks were successful
cd / Build and deploy (push) Successful in 6s
CI / Lint / Test / Vet (push) Successful in 10s
CI / Mirror to GitHub (push) Successful in 3s

Remove JSON output contracts from all skill files (debug, review, spec,
tdd, retrospective, trainer-reader, trainer-writer). Local models now
return markdown prose — Claude Code reads and acts on the text.

Keep the substantive discipline (iron laws, approach rules, output
structure) but replace 'return JSON with status/phase/skill/...' with
clear markdown format instructions.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Mathias Bergqvist
2026-04-22 16:46:52 +02:00
parent caef05bea4
commit 0e08dfffb8
6 changed files with 97 additions and 118 deletions

View File

@@ -7,40 +7,31 @@ You write structured implementation specs. Nothing is left ambiguous.
2. Always include an explicit "Out of scope" section — if you don't draw the boundary, the developer will guess wrong
3. Every technical decision in the approach must have a rationale
## Output contract
Return JSON result with:
- `status`: "pass" (spec written) or "error" (requirements too ambiguous to spec without more input)
- `phase`: "spec"
- `skill`: "spec"
- `file_path`: the output_path where the spec was written (absolute path)
- `runner_output`: ""
- `verified`: true if the file was written successfully
- `message`: "spec written: <one-line summary of what was specced>"
## Output format
## Spec structure
Write the spec as markdown to the output_path:
Write the spec as markdown using this structure:
```markdown
```
# [Feature] Spec
## Problem statement
[What problem does this solve? For whom? Why now?]
What problem does this solve? For whom? Why now?
## Success criteria
- [ ] [Criterion 1 — measurable and verifiable]
- [ ] [Criterion 2 — measurable and verifiable]
- [ ] Criterion 1 — measurable and verifiable
- [ ] Criterion 2 — measurable and verifiable
## Constraints
[Non-negotiable requirements the solution must satisfy]
Non-negotiable requirements the solution must satisfy.
## Out of scope
[What we are explicitly NOT doing in this iteration]
What we are explicitly NOT doing in this iteration.
## Technical approach
[Architecture decisions, key components, rationale for each choice]
Architecture decisions, key components, rationale for each choice.
## Risks
[What could go wrong, and how we'd mitigate it]
What could go wrong, and how we'd mitigate it.
```
If the requirements are too vague to produce measurable success criteria, return status "error" with a message listing the specific questions that need answers.
If requirements are too vague to produce measurable success criteria, say so and list the specific questions that need answers before you can write the spec.