dreampiler/kandev
1
0
Fork 0
Code Issues 43 Pull Requests Actions 6 Packages Projects Releases Wiki Activity

docs: update spec-driven planning workflow (#1390)

Browse Source
This commit is contained in:
Carlos Florêncio
2026-06-16 13:57:03 +01:00
committed by GitHub
parent aa5b8be353
commit e4b39238fa
8 changed files with 127 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/specs/INDEX.md
+1 -1
View File
@@ -115,7 +115,7 @@ System pages (Radarr/Sonarr-style) for status, disk usage, database maintenance,
## Conventions
- **Spec layout.** Umbrella specs live as flat `.md` files under the umbrella directory (`docs/specs/office/agents.md`). Standalone specs use a folder (`docs/specs/improve-kandev/spec.md`).
- **Plans are not specs.** Implementation plans (`plan.md`) are working files, gitignored. Specs are the durable requirements.
- **Plans are not specs.** Implementation plans are committed under `docs/plans/<feature>/` with individual sibling task files named `task-<NN>-<short-slug>.md`. Specs are the durable requirements; plans and task files are implementation records for the current buildout.
- **Bug fixes are not specs.** Bugs produce a regression test plus an ADR if they encoded a new convention. See `/fix` skill.
- **Architecture decisions are not specs.** ADRs live under `docs/decisions/`. See `/record decision`.