docs(fragment): stop re-seeding the spec/plan lifecycle restatement

The 'Spec/plan artefacts are ephemeral' section duplicated conventions.md (sections File layout + Lifecycle) and re-seeded that restatement into every new consumer CLAUDE.md - the drift vector that let projects diverge on git-tracked vs git-ignored. The rule now lives once, in conventions.md; the fragment's documented building-block list never included this section anyway.
This commit is contained in:
2026-07-07 11:47:03 +02:00
parent a75a821a29
commit dacadba07f
-15
View File
@@ -65,21 +65,6 @@ Two rules govern who touches git history and how:
when I have run into a dead end. A pushed commit has left the when I have run into a dead end. A pushed commit has left the
sandbox and is forward-only (`git revert`). sandbox and is forward-only (`git revert`).
## Spec/plan artefacts are ephemeral
`docs/specs/` and `docs/plans/` hold only the active cycle's spec and
plan, and they are **git-ignored** — never committed. This repo carries
a committed `docs/.gitignore` with the two entries `specs/` and `plans/`
(relative to `docs/`); that ignore file is the only committed part — the
spec and plan files it covers never are. If `docs/.gitignore` is missing
when the first working file is written, the writing skill creates it.
Each spec / plan is a working file: present on disk for its own cycle,
read across sessions from the working tree, and shell-`rm`'d at cycle
close by `audit` — never `git rm`'d, since it was never tracked, so no
git-history copy survives. The durable record of a past cycle is the
design ledger only, and no durable artefact cites a spec/plan by number
or path (see `~/dev/skills/docs/conventions.md` § Lifecycle).
## Design rationale ≠ implementation effort ## Design rationale ≠ implementation effort
When picking between design options, the rationale must come When picking between design options, the rationale must come