Use when recursive-mode work may benefit from delegated audit, review, or bounded implementation support. This skill prioritizes analyst, planner, code-reviewer, memory-auditor, tester, and implementer roles, with mandatory self-audit fallback when subagents are unavailable.
Installation
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Use when recursive-mode work may benefit from delegated audit, review, or bounded implementation support. This skill prioritizes analyst, planner, code-reviewer, memory-auditor, tester, and implementer roles, with mandatory self-audit fallback when subagents are unavailable.
recursive-subagent
Use this skill to decide whether subagents help a recursive-mode phase and to enforce the handoff contract when they do.
This skill does not relax the canonical workflow. The main agent remains responsible for:
one active recursive phase at a time
serving as the single orchestrator the user is currently interacting with
full audit rigor before lock
rejecting incomplete or context-free subagent output
falling back to self-audit when subagents are unavailable
If recursive-router is installed, consult it when the user has explicitly asked to use routing or when an active configured external route exists for the selected delegated role. Because router discovery and configuration may inspect local CLI and provider configuration on the device, ask the user first before new setup or policy changes. Do not ask again merely to honor an already configured external route for a role that must now be dispatched.
Once the user confirms routed setup, explicitly requests routed delegation, or the role has an active configured external route, consult:
before choosing a routed external CLI/model path for a role.
Re-read those files from disk immediately before every routed dispatch. Do not reuse an earlier in-memory resolution if policy, discovery state, or fallback behavior may have changed during the run. If recursive-router-resolve returns external-cli, use recursive-router-invoke for that delegated slot. Local/self-audit execution is only the valid path when the route resolves to fallback-local, local-only, blocked, or ask-user, and the recorded artifact must say so.
Priority Of Use
Use subagents in this order of value:
analyst
planner
code reviewer
memory auditor
tester
implementer for truly disjoint write scopes
Do not treat subagents as required infrastructure. They are optional infrastructure, but delegated audit/review is the preferred default when subagents are available and the context bundle is complete.
Capability Detection Is A Hard Control Point
At the start of a phase where delegation is being considered, determine whether the environment actually supports subagents/tasks.
If subagents are unavailable:
record Subagent Availability: unavailable
record Audit Execution Mode: self-audit
perform the same audit locally
If subagents are available:
record Subagent Availability: available
delegate by default for audit/review work when the context bundle is complete
consult router policy before dispatch when the current task explicitly requests routed delegation or external CLI routing is configured for the selected role
if the controller still chooses self-audit, record a concrete Delegation Override Reason
keep the same audit checklist and acceptance standard
Before delegating, read /.recursive/memory/skills/SKILLS.md plus the relevant skill-memory shards for delegated review, review-bundle fit, and stale-context risks.
Never skip or weaken an audit because delegation is unavailable.
Canonical Constraints
Recursive phases stay sequential. There is exactly one active phase per run.
Subagents may help inside the active phase; they do not authorize parallel phase work.
Parallel write-capable implementation is allowed only for explicitly independent sub-phases with disjoint write scopes and no blocking dependency chain.
Audit, review, and read-only verification are the safest default delegation modes.
Delegated Audit Contract
A delegated audit is valid only when the controller passes a complete context bundle. Prefer a canonical review bundle file under /.recursive/run/<run-id>/evidence/review-bundles/ so the handoff is durable and repeatable.
The controller must pass all of:
phase name and artifact path
current phase draft
exact upstream artifact paths that must be reread
relevant addendum paths
relevant prior recursive evidence and memory refs
diff basis from 00-worktree.md
changed file list
targeted code file paths or file groups to inspect
relevant control-plane docs when needed
exact audit questions/checklist for the phase
required output shape including findings and verdict
Vague delegation such as "review this phase" or "audit implementation" is invalid.
If any required item is missing, do not delegate. Perform the audit yourself.
If repairs materially change reviewed scope, changed files, or evidence, refresh the bundle before re-audit.
Controller Checklist
Before dispatch:
Confirm delegation is optional, not required
Confirm the phase is still the single active phase
Confirm the handoff bundle is complete
Confirm the canonical review bundle path exists when delegation is being recorded in a phase artifact
Confirm a durable subagent action record will be written under /.recursive/run/<run-id>/subagents/
Confirm initial prompt bundles are cited from a prompt-bundle path, and routed assistant output, stdout/stderr transcripts, and invoke metadata will be captured under /.recursive/run/<run-id>/evidence/router/, not directly under subagents/
Confirm the target subagent role matches the task
Confirm write scopes are disjoint before any write-capable delegation
Before accepting a result:
Verify the routed invocation has success: true and exit code 0 when external CLI routing was used
Verify the subagent read the named upstream artifacts
Verify the subagent read the review bundle or its full equivalent
Verify the subagent returned enough detail to populate the action record fields
Verify Current Artifact points at a stable reviewed artifact or refresh the record after any material draft edits
Verify the output cites the diff basis and changed files
Verify the bundle still matches the current artifact hash after any repairs
Verify the output contains concrete findings or an explicit no-findings conclusion
Verify the output includes requirement/plan alignment comments where relevant
Verify the output ends with a clear verdict
Verify any claimed file impact, artifact impact, or findings against the actual worktree diff, actual artifacts, and earlier locked recursive docs before acceptance
Verify the phase artifact records Reviewed Action Records, Main-Agent Verification Performed, Acceptance Decision, Refresh Handling, and Repair Performed After Verification
Reject action records that leave claimed file impact or claimed artifact impact as none for materially contributing work
Reject the output if it is context-free, hand-wavy, or missing required checks
If a routed subagent reports failures, findings, incomplete work, success: false, or a nonzero external CLI exit code, do not accept the result. The controller must run an audit-repair-retry loop: record the failed attempt and diagnostic evidence, tell the same bounded role exactly what to fix when it has ownership to fix it, rerun the route, and then repeat controller verification against the actual diff and artifacts. If the routed role cannot fix the issue or the route remains unavailable, record an explicit fallback before using local repair or self-audit evidence.
Recommended Roles
Analyst
Use for AS-IS analysis, root-cause analysis, and other audited phases that need an independent analytical pass over:
current draft
upstream locked artifacts
git diff vs recorded baseline
requirement coverage
gaps, drift, and repair needs
Planner
Use for Phase 2 planning and traceability-heavy checks where downstream artifacts must explicitly cover every in-scope R# and not hide behind vague summaries.
Code Reviewer
Use for Phase 3.5 or high-risk Phase 3/4 audits.
Expected checks:
requirements vs implementation
plan vs implementation
git diff vs claimed scope
code quality and maintainability
test adequacy and TDD compliance
Memory Auditor
Use in Phase 8 to verify that touched paths, memory status transitions, and router updates match the final validated repo state.
Tester
Use in Phase 4 to audit test adequacy, exact commands, evidence capture, and whether the implementation is truly complete before test results are trusted.
Implementer
Use only when Phase 2 defines truly independent sub-phases with concrete file ownership.
The controller must assign ownership explicitly and must not present this as broad "parallel mode" by default.
Handoff Template
Use this structure whenever you delegate an audit or review. Prefer generating the bundle with recursive-review-bundle and then passing the bundle path plus any phase-specific instructions:
Review Bundle Path: `/.recursive/run/<run-id>/evidence/review-bundles/<bundle>.md`
Phase: `03.5 Code Review`
Artifact path: `/.recursive/run/<run-id>/03.5-code-review.md`
Role: `analyst`
Audit execution expectation: return findings plus `Audit: PASS` or `Audit: FAIL`
Bundle freshness check:
- confirm changed files, evidence refs, and audit questions still match the latest repaired draft
- confirm relevant addenda are included; do not hand-wave plan or requirement amendments that live in addenda
Additional audit questions:
- Which `R#` are still incomplete?
- Which changed files drift from the plan?
- Is required evidence missing?
- Is repair required before lock?
Action-record expectation:
- return enough structured detail for `recursive-subagent-action`- prefer the stable reviewed artifact for `Current Artifact` when recording review/audit work
- cite upstream artifacts reread, relevant addenda, prior recursive evidence, changed files or code refs reviewed, claimed findings, and verification handoff items
Self-Audit Fallback Pattern
When subagents are unavailable, reuse the same checklist in the phase artifact and record:
