AI & agents · Automation
subagent-driven-development
/subagent-driven-development
Use when executing an implementation plan or a very-small-lane note.
For whom
- Author
- PrimeSeeker ↗
- Repository
- crucible ↗
- Licence
- MIT
- Last repository change
- 07.11.2026
Assessment and security
96/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability21 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
- Files in this package
- 24
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
Deprecation
No signals detected. Repository changed on 07.11.2026, without references to retired models or APIs.
Licence
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use when executing an implementation plan or a very-small-lane note.
Original author description
Use when executing an implementation plan or a very-small-lane note.
How it works
- Setup
- Instruments and report files
- Models
- The Task Loop
- Rules every route shares
- Inline mode
- Plan changes mid-execution
- Whole-Branch Review
- The very-small lane
- Finish
Original SKILL.md headings · 91 lines, 1,528 words
SKILL.md preview
--- name: subagent-driven-development description: Use when executing an implementation plan or a very-small-lane note. --- # Subagent-Driven Development Execute a plan by dispatching a fresh implementer subagent per task and one fresh-context reviewer after each, unless the plan routes that task's review to the branch review. The one route with no plan is the operator-confirmed very-small lane: § The very-small lane executes its lane note, and the rest of this skill applies to it only where that section says so. Between tool calls, narrate at most one short line; the ledger and tool results carry the record. Never ask "should I continue?" or pause between tasks to check in with the operator; stop only for a BLOCKED status you cannot resolve, a stop-and-ask trigger, a decision ask that genuinely needs the operator, or all tasks complete. **Dispatch references:** when this skill starts and after compaction, read `skills/subagent-driven-development/references/dispatch-composition.md` and your adapter's `skills/using-crucible/references/<runtime>-dispatch.md`; both bind as if written here. **Stubs.** A reference a section names to read in full binds as if written here. Read it when its step comes, unless read since your last compaction; after compaction, re-read the step in progress's reference first. ## Setup When this skill starts, read `skills/subagent-driven-development/references/setup.md` in full before any task. Implementation on a main/master checkout needs the operator's explicit consent first. ### Workspace, ledger and dispatch rules The workspace's `sdd/` subtree holds this plan's execution state: `ledger.md`, `reports/`, `branch-review/`. Never read or write another feature's workspace, except to follow a declared predecessor link. **The ledger** (`sdd/ledger.md`) is what survives compaction and what the close readout is assembled from: track progress there, not only in todos. Line 1 is the identity line, `# SDD ledger — plan: <plan file path>`; then `## Progress` for the running lines, `## Adjudication rulings`, `## Deferred minors` and `## Questions`. Setup seeds it with what earlier phases left. After compaction, trust the ledger and `git log` over your recollection. **Resume rule**, if line 1 names your plan: never re-dispatch a task whose latest `Task <N>` line under `## Progress` is a completion line (it is done; a later `reverted` line reopens it) or `Task <N>: BLOCKED — …`, until an answer under `## Adjudication rulings` releases it, which a ruling to block does not. Resume at the first task not done; one whose latest line is a `fix wave <W>/3` line is mid-loop: resume at the next wave or, after `3/3`, at its open operator ask (§ The Task Loop), never a fourth wave; one whose latest line is a released `BLOCKED — wave <W>` or a `fix wave <W>: implementer` line resumes inside that wave, which counts once. On the very-small lane, re-read its reference first. **Predecessor links:** when a plan is superseded mid-flight, the successor ledger's line 1 names the successor plan and line 2 links the predecessor ledger, moved aside (e.g. `sdd/ledger-superseded.md`). On resume, follow them before declaring any task not done. A ledger whose line 1 names a plan neither yours nor a declared predecessor is another run's: leave it untouched and escalate. Recover a lost workspace (gitignored, so `git clean -fdx` destroys it), or lost predecessor records, as `skills/redteaming/references/formats.md` § Feature workspace root and layout states. No dispatch copies the spec: each seat opens it from the plan's spec pointer. Hand artifacts over as files: what you paste into a dispatch and what a seat prints back stay resident in your context. Never run two implementers at once: they share the tree. ## Instruments and report files **Instruments**, each with a slot card beside its template: `implementer` ([implementer-prompt.slots.md](implementer-prompt.slots.md)) for every implementer seat, a fresh fix-wave one included; `task-reviewer` ([task-reviewer-prompt.slots.md](task-reviewer-prompt.slots.md)); `re-reviewer` ([re-review-prompt.slots.md](re-review-prompt.slots.md)). Fill the card, not the template ([implementer-prompt.md](implementer-prompt.md), [task-reviewer-prompt.md](task-reviewer-prompt.md), [re-review-prompt.md](re-review-prompt.md)). Each review seat and the adjudicator replies with a short verdict and its report's path; confirm every seat's report file, an implementer's included, as the dispatch composition's item 5 states. ## Models Instrument cards name their seats' roles. The seats you compose: - **Adjudicator:** the default role, since its dismissals close findings without further review. - **Snapshot-blessing agent:** the bounded role or better, a blind check of one stated claim. ## The Task Loop Run each task through this loop, in plan order: when Setup is done, read `skills/subagent-driven-development/references/task-loop.md` in full. Three fix waves at most per task. Findings the third wave leaves open stop the task and are a decision ask, recorded open under `## Adjudication rulings` with the answer beside it; further waves are not an answer. The options: - park a finding, with its reason: a `Task <N>: parked — <finding> — ruling: <the answer>` line per finding, then the completion line with its parked count; - block: `Task <N>: BLOCKED — <the ruling>`, and execution stops at that task until the operator rules again; - another approach: a plan change (§ Plan changes mid-execution) or a revert (§ Drift found after the fact), whose re-run starts at wave 1. A plan change short of a supersede, once it lands, appends `Task <N>: plan changed — <the ruling> (BASE <base7>)`, which closes the open findings: run the task again from step 1 on the changed plan, that BASE kept and the findings and its earlier report in the implementer's context, its report going to step 3 even where the task is marked, so its review, given every run's report, re-grades them. ## Rules every route shares These hold in the task loop, in the branch review `crucible:requesting-code-review` runs, and on the very-small lane. The dispatch composition's § Shared-tree rules bind every seat you start; the status check's windows are the review seats (task reviewer, re-reviewer, adjudicator, snapshot-blessing agent, branch reviewer, a fresh look), and a replacement seat reads the first seat's file. A review missing a verdict goes back to its seat: resume it for that verdict; where the host cannot resume or the verdict is still missing, start a replacement seat; one that leaves it out too is a decision ask. You never rule on it yourself. ### Disputes and adjudication A finding is fixed or disputed, never dropped; every ruling is a ledger entry. Whenever a finding is disputed, collides with plan text or carries the `literal-reading` label, read `skills/subagent-driven-development/references/disputes-and-adjudication.md` in full before acting on it. Record an operator's answer to any decision ask under `## Adjudication rulings` beside the ruling it settles, and enter it in `brainstorm-decisions.md` (status: `crucible:brainstorming` § Workspace provisioning). ### What a report voices Before routing what a report carries beside its work, read `skills/subagent-driven-development/references/what-a-report-voices.md` in full. ### Drift found after the fact When work is found off-plan without a logged decision, read `skills/subagent-driven-development/references/drift.md` in full. ## Inline mode Before implementing a task yourself instead of dispatching it, read `skills/subagent-driven-development/references/inline-mode.md` in full. ## Plan changes mid-execution Defective or superseded plan text found mid-execution takes a flip path, since executing it produces reviewable-but-wrong work. Triggers: a BLOCKED escalation of a defective plan; an operator's answer, an adjudication or a ruling of yours that changes plan text; an operator's ruling on a premise finding during the task loop; binding content a finding shows wrong (what the Deviations paragraph of § The Task Loop names, or binding-by-construction contract content); a supersede called for, an unfold included. **Before acting on any of them, read `skills/redteaming/references/flip-paths.md` in full**, and re-read it after compaction; a scoped amendment is yours to confirm where that file's § The containment test finds the change contained, and a flip in flight shows in the ledger as its recorded decision ask or ruling. `skills/brainstorming/references/umbrella-children.md` § Under an umbrella governs a feature found to need splitting and, where the spec preamble has an `Umbrella:` line, a binding change its umbrella needs or one landed on the base the feature has not taken in; check for these at each task boundary and before each branch-review pass and wave. **Before raising either, and before the first such check, read that section**, and re-read it after compaction. ## Whole-Branch Review After the last task completes, run `crucible:requesting-code-review` for its capped whole-branch review: it owns the branch-review loop and its inputs, the ledger's deferred minors, leads and adjudication rulings among them. When it ends, after its cleanup wave where you open one, go to § Finish. ## The very-small lane The third route, beside the standard and folded presets: the very-small preset (`crucible:brainstorming` § Proposing the arrangement), executed from a lane note and entered only as its reference states. **On entering the lane, read `skills/subagent-driven-development/references/very-small-lane.md` in full**; where it says so, it supersedes this skill's rules for the lane. ## Finish When the branch review ends, read `skills/subagent-driven-development/references/finish.md` in full; its step order is binding. After any loop activity, restart at step 1, so new records, rulings included, are checked and reach the close readout. ## Common Rationalizations | Excuse | Reality | |---|---| | "I'll fix it myself, dispatching is overhead" | Your fix skips review: resume the implementer, or use inline mode, where any loop-entering finding converts back to dispatch. | | "The implementer deviated but the result looks fine" | Undisclosed drift from binding content is the operator's call, never yours; disclosed but unjustified, it goes to the fix loop. | | "The fix was small, skip the re-review" | Every wave that changes code ends with a scoped re-review. |
Files in this package (24)
- SKILL.md 10 KB
- implementer-prompt.md 15 KB
- implementer-prompt.slots.md 2 KB
- implementer-prompt.source.md 10 KB
- re-review-prompt.md 10 KB
- re-review-prompt.slots.md 2 KB
- re-review-prompt.source.md 5 KB
- task-reviewer-prompt.md 15 KB
- task-reviewer-prompt.slots.md 1 KB
- task-reviewer-prompt.source.md 8 KB
- writing-good-tests.md 5 KB
- agents/openai.yaml 1 KB
- references/dispatch-composition.md 6 KB
- references/disputes-and-adjudication.md 3 KB
- references/drift.md 1 KB
- references/finish.md 5 KB
- references/fresh-look.md 2 KB
- references/inline-mode.md 1 KB
- references/review-terms.md 4 KB
- references/seat-rules.md 9 KB
- references/setup.md 3 KB
- references/task-loop.md 8 KB
- references/very-small-lane.md 6 KB
- references/what-a-report-voices.md 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · PrimeSeeker/crucible | 96 | MIT |
| jjuraszek/pi-gauntlet | 100 | MIT |
| seaworld008/commonly-used-high-value-skills | 100 | MIT |
| guanyang/antigravity-skills | 100 | MIT |
| nikospavlopoulos/devops-mutant-powers | 100 | MIT |
| osmontero/opencode-skills | 100 | MIT |
| farm-fe/farm | 100 | MIT |
| coco-research/coco | 100 | MIT |
| ovargas/virtual-team | 100 | MIT |
Database snapshot: 13.11.2026 · package version 64ce92cdf3d0 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 95sr-subagent-driven-development
Use when executing implementation plans with independent tasks in the current session - 100common-subagent-driven-development
Execute an approved implementation plan at the context boundary that preserves required independence and review. Use when implementing plans, executing multi-task PRs, choosing between main-loop and dispatched execution, or transitioning from planning to implementation.