メニュー
Repository workflow orchestration skill for staged implementation, locked artifacts, late-phase receipts, and durable memory maintenance. Use when executing recursive-mode runs, resuming a run, locking a phase, or verifying locks.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Use when recursive-mode needs to route delegated audit, review, or bounded implementation work through external transports, CLIs, and models while preserving controller verification and fallback behavior.
Use after completed recursive-mode runs accumulate to extract durable experiential memory into `/.recursive/memory/`, then load it for later runs through the canonical loader.
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.
Use when starting any recursive-mode requirement to set up an isolated git worktree. Required before implementation phases: create an isolated workspace, verify a clean baseline, and keep main/master clean.
Use when a recursive-mode requirement involves debugging a bug, test failure, or unexpected behavior. Insert Phase 1.5 between Phase 1 and Phase 2 to perform systematic root cause analysis before attempting any fixes. Trigger phrases: "debug", "investigate", "failing tests", "crash", "root cause".
Use when recursive-mode work needs a canonical delegated-review or audit handoff. Generates reproducible review bundles for Phase 3.5 code review, test review, or other delegated checks using the repo review-bundle scripts.
| name | recursive-mode |
| description | Repository workflow orchestration skill for staged implementation, locked artifacts, late-phase receipts, and durable memory maintenance. Use when executing recursive-mode runs, resuming a run, locking a phase, or verifying locks. |
Use this skill to run the repository workflow defined in /.recursive/RECURSIVE.md.
This file is the installable entrypoint for the skill. It is not the canonical workflow spec.
For phase order, audit-loop rules, lock rules, addenda, late-phase receipts, state/decisions updates, and memory maintenance, follow /.recursive/RECURSIVE.md.
Before doing recursive-mode work, ensure the repo scaffold exists:
/.recursive/RECURSIVE.md/.recursive/STATE.md/.recursive/DECISIONS.md/.recursive/memory/MEMORY.md/.recursive/memory/skills/SKILLS.md/.recursive/memory/{domains,patterns,incidents,episodes,archive}//.recursive/memory/skills/{availability,usage,issues,patterns}//.recursive/run//.codex/AGENTS.md primary Codex bridge doc/.agent/PLANS.md bridge docAGENTS.md docs if the repo already uses themIf any of those are missing or stale, the agent should bootstrap the repo automatically before continuing. Do not ask the user to run the bootstrap manually unless no supported Python or shell runtime is available in the environment. PowerShell is optional, not required.
Preferred bootstrap commands:
python ./scripts/install-recursive-mode.py --repo-root .
python3 ./scripts/install-recursive-mode.py --repo-root .
bash ./scripts/install-recursive-mode.sh --repo-root .
powershell -ExecutionPolicy Bypass -File ./scripts/install-recursive-mode.ps1 -RepoRoot .
pwsh -NoProfile -File ./scripts/install-recursive-mode.ps1 -RepoRoot .
Important boundary:
npx skills add ... installs the skill package into agent directories./.recursive/RECURSIVE.md./.codex/AGENTS.md as the primary Codex bridge if present.AGENTS.md copies only as mirrored bridge guidance if the repo uses them./.agent/PLANS.md as the primary Codex plans bridge if present./.recursive/STATE.md./.recursive/DECISIONS.md./.recursive/memory/MEMORY.md./.recursive/memory/.If any bridge doc conflicts with /.recursive/RECURSIVE.md, follow /.recursive/RECURSIVE.md.
/.recursive/run/<run-id>//.recursive/RECURSIVE.md/.recursive/STATE.md/.recursive/DECISIONS.md/.recursive/memory/MEMORY.mdImplement requirement '<run-id>'Run Recursive Phase 2 for .recursive/run/<run-id>/Resume requirement '<run-id>' after manual QAVerify locks for .recursive/run/<run-id>/scripts/install-recursive-mode.pyscripts/install-recursive-mode.ps1scripts/install-recursive-mode.shscripts/recursive-init.pyscripts/recursive-init.ps1scripts/recursive-status.pyscripts/recursive-status.ps1scripts/lint-recursive-run.pyscripts/lint-recursive-run.ps1scripts/recursive-review-bundle.pyscripts/recursive-review-bundle.ps1scripts/recursive-closeout.pyscripts/recursive-closeout.ps1scripts/recursive-router-init.pyscripts/recursive-router-init.ps1scripts/recursive-router-probe.pyscripts/recursive-router-probe.ps1scripts/recursive-router-configure.pyscripts/recursive-router-configure.ps1scripts/recursive-router-invoke.pyscripts/recursive-router-invoke.ps1scripts/recursive-router-resolve.pyscripts/recursive-router-resolve.ps1scripts/recursive-router-validate.pyscripts/recursive-router-validate.ps1scripts/recursive-subagent-action.pyscripts/recursive-subagent-action.ps1scripts/recursive-lock.pyscripts/recursive-lock.ps1scripts/verify-locks.pyscripts/verify-locks.ps1scripts/check-reusable-repo-hygiene.pyscripts/check-reusable-repo-hygiene.ps1.recursive/scripts/recursive-training-grpo.py.recursive/scripts/recursive-training-grpo.ps1.recursive/scripts/recursive-training-phase8-trigger.py.recursive/scripts/recursive-training-phase8-trigger.ps1.recursive/scripts/recursive-training-extract.py.recursive/scripts/recursive-training-extract.ps1.recursive/scripts/recursive-training-sync.py.recursive/scripts/recursive-training-sync.ps1.recursive/scripts/recursive-training-loader.py.recursive/scripts/recursive-training-loader.ps1.recursive/scripts/recursive-training-mcp.py.recursive/scripts/recursive-training-mcp.ps1skills/recursive-spec/SKILL.mdskills/recursive-worktree/SKILL.mdskills/recursive-debugging/SKILL.mdskills/recursive-tdd/SKILL.mdskills/recursive-review-bundle/SKILL.mdskills/recursive-router/SKILL.mdskills/recursive-subagent/SKILL.mdskills/recursive-training/SKILL.md — extract durable experiential knowledge from completed runsUse those subskills for their specialized discipline, but keep /.recursive/RECURSIVE.md as the single source of truth for the overall workflow contract.
Canonical routed CLI config lives under:
/.recursive/config/recursive-router.json/.recursive/config/recursive-router-discovered.jsonWhen this skill or any recursive subskill is about to call another model or external CLI for delegated audit, review, bounded implementation, or other routed subagent work, re-read these routing files from disk immediately before choosing the CLI/model.
Do not hardcode provider or model strings for routed delegation when repo policy already defines the route or fallback behavior.
If routed delegation is in scope, prefer skills/recursive-router/SKILL.md plus the canonical recursive-router-resolve and recursive-router-invoke scripts over bespoke model selection logic.
If routed delegation has been explicitly requested, or if recursive-router-resolve for the selected role returns external-cli, do not satisfy that delegated slot with local/self-audit work unless the effective route is fallback-local, local-only, blocked, or ask-user and that outcome is recorded. The controller may reject routed output after checking it against the actual files, diffs, and recursive artifacts, but unverified local work is not a substitute for a configured routed implementer, tester, reviewer, auditor, or planner role.
If a routed invocation returns success: false, exits nonzero, or reports issues that the bounded role is responsible for fixing, run an audit-repair-retry loop: preserve the failed attempt as evidence, tell the routed subagent exactly what to fix, rerun the same route after repair, then verify the new output locally before acceptance. Do not mark the delegated role or phase gate complete from a nonzero-exit routed attempt.
Before dispatching from an isolated worktree, make sure the routing policy and discovery inventory are present and current in that same worktree. Discovery inventory is often untracked, so a newly created worktree can have /.recursive/config/recursive-router.json without /.recursive/config/recursive-router-discovered.json; refresh discovery from the worktree or copy the current inventory from the controller/source repo before resolving or invoking a route, then record the paths and outcome in the phase artifact or action record.
recursive-benchmark stays outside the default recursive-mode package surface.find-skills or by adding its dedicated benchmark add-on package or repo source.For audited phases, the installed workflow requires draft -> audit -> repair -> re-audit -> pass -> lock, with Audit: PASS required before Coverage/Approval may pass.
Treat ## Worktree Diff Audit as phase-scoped: Phase 2 owns planning completeness plus expected product/worktree paths, Phase 3-4 own actual product/worktree drift, Phase 6 owns /.recursive/DECISIONS.md, Phase 7 owns /.recursive/STATE.md, and Phase 8 owns /.recursive/memory/**.
New runs should use Workflow version: recursive-mode-audit-v2, where Phase 1 must include ## Source Requirement Inventory and Phase 2 must include ## Requirement Mapping, ## Plan Drift Check, and plan-stage ## Requirement Completion Status.
For Phase 3, declare TDD Mode: strict|pragmatic. Strict mode requires concrete RED and GREEN evidence paths. Pragmatic mode requires an explicit exception rationale plus compensating evidence.
For Phase 5, declare QA Execution Mode: human|agent-operated|hybrid. Do not fake human sign-off for agent-operated QA, and do not omit sign-off for human or hybrid QA.
For delegated review, prefer scripts/recursive-review-bundle.py or scripts/recursive-review-bundle.ps1 so Phase 3.5 records a canonical Review Bundle Path.
If meaningful subagent work contributes to a phase, record it under /.recursive/run/<run-id>/subagents/ and verify the action record against actual files, actual diffs, and actual recursive artifacts before accepting it. For review/audit delegation, prefer a stable reviewed artifact for Current Artifact rather than a mutable draft receipt.
Audited phases must record Subagent Capability Probe, Delegation Decision Basis, ## Subagent Contribution Verification, and ## Requirement Completion Status.
When subagents are available and the context bundle is complete, delegated audit/review is the default path. If the controller still uses Audit Execution Mode: self-audit, record a concrete Delegation Override Reason.
Use the stronger requirement disposition fields in ## Requirement Completion Status: Changed Files, Implementation Evidence, Verification Evidence, Deferred By, Scope Decision, Blocking Evidence, and Addendum as appropriate to the chosen status.
Do not mark implemented or verified without concrete Changed Files. Do not mark verified without distinct verification evidence.
Treat addenda as authoritative effective inputs. When relevant addenda exist, list them under Inputs, re-read them in ## Effective Inputs Re-read, and reconcile them in ## Earlier Phase Reconciliation.
Review bundles should include relevant addenda automatically, and the written Phase 3.5 review should cite bundle-grounded upstream artifacts, addenda, and changed files or code refs in the review narrative.
00-worktree.md is the source of truth for diff basis. Record baseline type/reference, comparison reference, normalized baseline/comparison, and normalized diff command; do not silently improvise a different basis later.
Use Phase 8 to update skill memory under /.recursive/memory/skills/ when the run teaches the repo something durable about skill availability, fit, delegated-review quality, or skill-discovery outcomes.
Phase 8 should also capture run-local skill usage before promoting any lesson into durable memory.
If the run plans delegated review, review bundles, or smoke-harness portability work, read /.recursive/memory/skills/SKILLS.md and the relevant skill-memory shards before planning or auditing.
If the run needs a specialized capability that is not already available, prefer the find-skills skill when it exists. Otherwise use the Skills CLI directly (npx skills find, npx skills add, npx skills check, npx skills update) and record the result when skill usage is relevant.
Diff audit ignores incidental runtime byproducts such as __pycache__/, *.pyc, .pytest_cache/, .mypy_cache/, and .ruff_cache/ unless the repo intentionally tracks them.
Treat Phase 6, Phase 7, and Phase 8 receipts as concise delta receipts that point to the final control-plane docs instead of restating large sections.
Use scripts/recursive-lock.py or scripts/recursive-lock.ps1 as the normal locking path instead of manually editing Status, LockedAt, and LockHash.
recursive-lock enforces monotonic phase gating: it will reject a lock attempt if any earlier phase that exists in the run directory is not already LOCKED. To reopen a locked artifact and reset it to DRAFT (which also invalidates downstream receipts), use the --reopen flag.
On Windows, run Node/Vite/Vitest commands from the real worktree path rather than subst or mapped-drive aliases.
When evaluating or building browser-local apps, consult references/local-first-web-app-checklist.md for common import/persistence/QA edge cases.
If the repository being improved is itself a reusable skill/workflow repo, do not commit current-session run folders, evidence logs, review bundles, subagent action records, or temp-path references unless they are intentional fixtures; use scripts/check-reusable-repo-hygiene.py or scripts/check-reusable-repo-hygiene.ps1 before calling the repo clean.