docs: make specs/plans git-tracked and transient — retired via git rm at cycle close

docs/specs and docs/plans hold only the active cycle's artefacts: a spec/plan is committed while its cycle is live and git-rm'd in the cycle-close commit (after audit drift-clean), so HEAD shows only in-flight work while git history keeps the full text. No issue-posting, no gitignore branch — git history + the design ledger are the durable record.

Rewrites conventions.md § Lifecycle as the single source of truth; pipeline.md, design.md, README.md, specify, planner, glossary, brainstorm, issue, and the CLAUDE.md fragment follow it. Naming stays NNNN-slug.md (a within-cycle handle; recycling on an emptied directory is fine).
This commit is contained in:
2026-06-18 11:59:45 +02:00
parent c5da79f8fc
commit 012e70b058
10 changed files with 68 additions and 13 deletions
+1 -2
View File
@@ -76,8 +76,7 @@ These apply to every issue, on create and on edit.
link them.
- Avoid: "Fixes the regression from the ledger refactor; see the
spec."
- Use: "Fixes the regression behind `#38`; spec at
`docs/specs/0004-escaping.md`."
- Use: "Fixes the regression behind `#38`, introduced in `a1b2c3d`."
**Language:** title and body are English — an issue is a repo
artefact mirrored to Gitea ("would it be committed → English", per