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

docs: tighten specification ownership and migration (#3004)

Browse Source
This commit is contained in:
Carlos Florêncio
2026-08-24 21:30:53 +00:00
committed by GitHub
parent 0057e4cb7d
commit 1e05cf9201
42 changed files with 873 additions and 752 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+5 -3
View File
@@ -146,9 +146,11 @@ history and remains immutable.
live under `docs/specs/**`. New work uses
`docs/specs/<system>/requirements/` and
`docs/specs/<system>/system-design/`. Read `docs/specs/README.md` and the
relevant file in `docs/specs/guide/`. Use `docs/specs/INDEX.md` only to find
unmigrated legacy specifications. Run `python3 scripts/lint-spec-files.py
--all` after specification changes.
relevant file in `docs/specs/guide/`. Choose the owner from the durable
contract, not the affected code layer. Keep one vertical requirement/design
pair and include its UI outcomes there. Use `docs/specs/INDEX.md` only to
find unmigrated legacy specifications. Run `python3
scripts/lint-spec-files.py --all` after specification changes.
- **Decisions:** Architecture decisions are recorded in `docs/decisions/`. Read `docs/decisions/INDEX.md` for an overview. When making significant architectural choices, create a new ADR via `/record decision`.
- **Plans:** Implementation plans are generated from requirements and system
designs through `/plan`. `docs/plans/<initiative>/plan.md` is a work-package