🤖 Wire development cycle into Spire skills and agents
Igor now has a Development Cycle section with six stages, review decision tree, Athanor queuing rules, and separation principle. Athanor, implementation, research, and research-tree skills all reference their cycle stage. Fixed remaining Athanor metaphor inversions in the plugin design spec.
This commit is contained in:
@@ -88,6 +88,27 @@ The `athanor` is the forge — your heavy lifter. An Opus-tier agent that may us
|
||||
|
||||
**Model must be explicit.** Always pass `model` on `Agent` calls (`"opus"`, `"sonnet"`, `"haiku"`) — omitting it inherits the coordinator's model, which may be Fable. Subagents are Opus or lower; never dispatch a Fable-tier subagent unless the user explicitly asks.
|
||||
|
||||
## Development Cycle
|
||||
|
||||
Igor routes work through six stages. Not every task enters the cycle — one-off fixes, ad-hoc questions, and maintenance stay outside it. The line: if writing the plan would take longer than doing the work, it is not in the cycle.
|
||||
|
||||
**Stages:** (1) Brainstorm — Igor with user or Pinky; skip when direction is clear. (2) Research — researcher/adept answers open questions. (3) Design — independent Opus agent produces one buildable approach. (4) Plan — independent Opus agent (never the designer) produces steps with completion criteria. (5) Implement — the Athanor receives the plan; code comes out. (6) Review — fresh Opus reviewer measures output against plan and design.
|
||||
|
||||
**Separation rule:** Plans and designs are always written by independent agents. The author of a plan never implements it; the author of a design never plans from it. Separation keeps review honest.
|
||||
|
||||
**Review decision tree:** Igor routes the outcome:
|
||||
1. None or low findings only — done. Lows stay in the report; never loop for lows.
|
||||
2. Any medium or high — collect findings into a new plan (stage 4). The normal short loop.
|
||||
3. Approach is wrong, not the code — back to design (stage 3). Append a dated amendment.
|
||||
4. Unresearched unknown surfaced — back to research (stage 2). Only for a genuinely new problem space.
|
||||
5. Goal is wrong — stop. User's call.
|
||||
|
||||
Default to the shortest loop that fits; long loops need a stated reason.
|
||||
|
||||
**Athanor queuing:** Plans enter sequentially; Igor holds the queue. A new plan arriving mid-run waits — the door is closed. If a new plan invalidates the one cooking, Igor stops the run (`TaskStop`), shelves partial output, and dispatches the replacement. Parallel Athanors only for disjoint code in separate worktrees; default is one.
|
||||
|
||||
**Cycle and workpad:** Each stage writes to its folder; moving forward creates a new file, never mutates the previous one. The folder trail is the record.
|
||||
|
||||
## Adepts
|
||||
|
||||
Adepts are domain-scoped knowledge agents that persist within a session. They accumulate knowledge in the workpad's `adepts/<domain-slug>/` folders — an index (`CLAUDE.md`), a rolling handoff (`handoff.md`), knowledge docs, and a `journal/` subfolder.
|
||||
|
||||
Reference in New Issue
Block a user