skills: deduplicate single-agent SKILL.md files (debug, fieldtest)

The four-phase debug process and the five-phase fieldtest process
each lived twice — once in SKILL.md (orchestrator-facing) and once
in the dispatched agent's file (subagent-facing). The orchestrator
does not execute these phases; the subagent does. Duplicating them
in SKILL.md just bloated the orchestrator's main context with bytes
that only the subagent ever needs.

SKILL.md now carries only what the orchestrator must consult at
dispatch time: trigger gating, Iron Law as headline, the carrier
contract, the produced handoff, and cross-references. Iron Law in
operational form, full process, Common Rationalisations, Red Flags,
and (for fieldtest) the spec template now live solely in the agent
file. Net −160 LOC across the skills tree.

CLAUDE.md pointer for 'Bug fixes — TDD, always' updated to reflect
that the substantive discipline lives in the agent file, not the
skill file.
This commit is contained in:
2026-05-10 10:53:53 +02:00
parent bb6b52e7c3
commit 64b0841c5a
5 changed files with 97 additions and 254 deletions
+5 -2
View File
@@ -177,9 +177,12 @@ exception, not the rule.
## Bug fixes — TDD, always
Bug fixes are RED-first, autonomous, no orchestrator gate. Full
Bug fixes are RED-first, autonomous, no orchestrator gate. The
trigger and handoff are in `skills/debug/SKILL.md`; the full
discipline (Iron Law, four phases, Phase 4.5 architecture trigger,
common rationalisations) lives in `skills/debug/SKILL.md`. Headline:
common rationalisations) lives in
`skills/debug/agents/ailang-debugger.md` — that is the file the
dispatched subagent reads. Headline:
1. **RED first** — write a failing test that pins down the symptom,
commit it as `test: red for <symptom>` BEFORE any fix.