From 3450a3e6ec8e9e0ab45e628c1d923a61c46648cf Mon Sep 17 00:00:00 2001 From: Brummel Date: Mon, 11 May 2026 14:02:49 +0200 Subject: [PATCH] =?UTF-8?q?iter=20cadence.4:=20skills/README=20=E2=80=94?= =?UTF-8?q?=20three-bucket=20cadence=20taxonomy?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- skills/README.md | 39 ++++++++++++++++++++++++++------------- 1 file changed, 26 insertions(+), 13 deletions(-) diff --git a/skills/README.md b/skills/README.md index 4d5abd7..747a4b8 100644 --- a/skills/README.md +++ b/skills/README.md @@ -10,24 +10,25 @@ The system was bootstrapped on 2026-05-09. See `docs/specs/2026-05-09-skill-system.md` for the design and `docs/journal-archive.md` ("Skill system live") for the rationale. -## The six skills +## The seven skills | Skill | Trigger | Output | Mandatory? | |-------|---------|--------|------------| | [`brainstorm`](brainstorm/SKILL.md) | New milestone starting | `docs/specs/.md` | Hard-gate before plan | | [`planner`](planner/SKILL.md) | New iteration within an open milestone | `docs/plans/.md` | Hard-gate before implement | | [`implement`](implement/SKILL.md) | Plan exists | Code + tests + per-task commits + per-iter journal entry | Standard iteration path | -| [`audit`](audit/SKILL.md) | Milestone closing OR baseline drift suspected | Drift report + bench-regression report + rustdoc audit | **Mandatory** at milestone close | -| [`fieldtest`](fieldtest/SKILL.md) | After audit closes a milestone that touched user-visible surface | 2-4 `.ailx` example fixtures + `docs/specs/-fieldtest-.md` | Standard milestone-close path; skipped only for purely internal milestones | +| [`audit`](audit/SKILL.md) | Milestone closing OR baseline drift suspected | Architect drift review + three regression scripts | **Mandatory** at milestone close | +| [`docwriter`](docwriter/SKILL.md) | API surface stabilized; rustdoc lag suspected | rustdoc updates in `///` and `//!` | No — Boss-dispatched only | +| [`fieldtest`](fieldtest/SKILL.md) | Boss-dispatched post-audit Praxistest on a milestone that touched user-visible surface | 2-4 `.ailx` example fixtures + `docs/specs/-fieldtest-.md` | Standard milestone-close path; skipped only for purely internal milestones | | [`debug`](debug/SKILL.md) | Bug encountered (failing test, segfault, wrong stdout) | RED-test commit + cause analysis | **Mandatory RED-first** for any bug | ## Pipeline ``` -[new milestone] [bug observed] - | | - v v - brainstorm -> plan -> implement debug -> implement (mini) +[new milestone] [bug observed] + | | + v v + brainstorm -> plan -> implement debug -> implement (mini) (per iteration loop) | [milestone close] @@ -35,11 +36,21 @@ The system was bootstrapped on 2026-05-09. See v audit --(drift)--> plan + implement (tidy iteration) --(ratify)-> JOURNAL + --update-baseline - --(clean)--v - fieldtest --(bug)------> debug -> implement (mini) - --(friction)-> brainstorm OR plan (tidy) - --(spec_gap)-> ratify OR tighten DESIGN.md - --(clean)----> next milestone + --(clean)-+ + | + [Boss: iter fertig? if surface-touch:] + v + fieldtest --(bug)------> debug -> implement (mini) + --(friction)-> brainstorm OR plan (tidy) + --(spec_gap)-> ratify OR tighten DESIGN.md + --(clean)----+ + | + [Boss: surface stable across N milestones?] + v + docwriter (rustdoc sweep) + | + v + next milestone ``` Skipping rules are codified in each `SKILL.md`. Ad-hoc skipping is @@ -60,7 +71,7 @@ are no orphan agents (an anti-pattern after the 2026-05-09 build-out). | `ailang-tester` | `implement/agents/` | phase reference for `ailang-implement-orchestrator` Phase 3 (E2E coverage); not dispatched as a separate subagent | | `ailang-architect` | `audit/agents/` | `audit` (Step 1; drift review against DESIGN.md + spec) | | `ailang-bencher` | `audit/agents/` | `audit` (regression diagnostics — hypothesis-driven) | -| `ailang-docwriter` | `audit/agents/` | `audit` (Step 3; rustdoc cleanup, optional) | +| `ailang-docwriter` | `docwriter/agents/` | `docwriter` (Boss-dispatched rustdoc sweep post-stability) | | `ailang-debugger` | `debug/agents/` | `debug` (RED-first; hands off GREEN to `implement` mini-mode) | | `ailang-fieldtester` | `fieldtest/agents/` | `fieldtest` (writes real-world examples in `.ailx` Surface form against DESIGN.md only — never the compiler source) | @@ -120,6 +131,7 @@ Two symlink sets, both tracked in git, no setup needed after clone: .claude/skills/planner -> skills/planner .claude/skills/implement -> skills/implement .claude/skills/audit -> skills/audit +.claude/skills/docwriter -> skills/docwriter .claude/skills/fieldtest -> skills/fieldtest .claude/skills/debug -> skills/debug ``` @@ -131,6 +143,7 @@ dispatch can find them by `subagent_type`: .claude/agents/planner -> skills/planner/agents .claude/agents/implement -> skills/implement/agents .claude/agents/audit -> skills/audit/agents +.claude/agents/docwriter -> skills/docwriter/agents .claude/agents/fieldtest -> skills/fieldtest/agents .claude/agents/debug -> skills/debug/agents ```