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

refactor: drop dev-cycle-profile.yml for conventions + CLAUDE.md facts

Browse Source 
The profile was never parsed — it was prose the skill bodies told the model to read, so most slots were dead, constant across every project, or fiction (the whole pipeline block, including the "tdd is opt-in" claim, was enforced by nothing).

Split it in two: constants become fixed conventions named directly by the skills (new docs/conventions.md), and the few genuinely per-project facts move to each project's CLAUDE.md under '## Skills plugin: project facts'. tdd/fieldtest/docwriter are now always available; the only behavioural toggle left is spec auto-sign.

Delete docs/profile-schema.md and templates/project-profile.yml; add docs/conventions.md and a project-facts section to templates/CLAUDE.md.fragment; rewrite all SKILL/agent prose and the pipeline/design/migration/README/INSTALL docs accordingly.
This commit is contained in:
Brummel
2026-06-13 16:30:02 +02:00
parent 268ee705f4
commit 26e9630496
40 changed files with 752 additions and 894 deletions
Download Patch File Download Diff File Expand all files Collapse all files
tdd/SKILL.md
+7 -6
View File
@@ -71,10 +71,10 @@ prevent, and it is no less a failure for being dressed as a test.
- a trivial mechanical edit — per the project's CLAUDE.md
"trivial mechanical edits" carve-out.
This skill is an opt-in entry path. A project enables it by
listing a `tdd` phase in its profile `pipeline:` block (see
`docs/profile-schema.md`); a profile that omits it keeps
`brainstorm → specify → planner` as the only design entry path.
This skill is a standard entry path, always available — one of the
three design entries alongside `brainstorm → specify → planner` and
`specify → planner`. Which one a given iteration uses is a fit
decision per item, not a project setting.
## The Iron Law
@@ -219,5 +219,6 @@ iteration and gets queued for a separate one.
- **Sibling RED-first skill:** `../debug/SKILL.md` — same two-stage
RED→GREEN shape, but triggered by an observed bug rather than a
new-behaviour description.
- **Profile slot:** the opt-in `tdd` phase under `pipeline:` in
`docs/profile-schema.md`.
- **Pipeline:** `../docs/pipeline.md` — `tdd` is a standard,
always-available entry path; the graph and skip rules are fixed
(not per-project).