Brummel/Skills
1
0
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
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:
Brummel
2026-06-18 11:59:45 +02:00
parent c5da79f8fc
commit 012e70b058
10 changed files with 68 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
glossary/SKILL.md
+3 -1
View File
@@ -104,7 +104,9 @@ If the mode is ambiguous, ask once; do not guess.
project's CLAUDE.md.
2. **Partition the prose surface into slices** — the readable prose of
the project: `docs/`, `README.md`, the project's design ledger, if it
has one (its CLAUDE.md project facts), the spec directory `docs/specs`.
has one (its CLAUDE.md project facts). Exclude `docs/specs` and
`docs/plans` — those are ephemeral active-cycle artefacts, not durable
prose (see `../docs/conventions.md` § Lifecycle).
One slice per coherent group, sized so a single agent can sweep it.
3. **Fan out one `glossary-extractor` per slice.** Dispatch the read-only
agent (`agents/glossary-extractor.md`) with the carrier: the slice and