Phase 1 - Planning: Create an implementation plan from the spec
- If ralplan consensus plan exists: Skip — already done in the 3-stage pipeline
- Architect (Opus): Create plan (direct mode, no interview)
- Critic (Opus): Validate plan
- Output:
.omc/plans/autopilot-impl.md
Phase 2 - Execution: Implement the plan using Ralph + Ultrawork
- Executor (Haiku): Simple tasks
- Executor (Sonnet): Standard tasks
- Executor (Opus): Complex tasks
- Run independent tasks in parallel
Phase 3 - QA: Cycle until all tests pass (UltraQA mode)
- Build, lint, test, fix failures
- Repeat up to 5 cycles
- Stop early if the same error repeats 3 times (indicates a fundamental issue)
Phase 4 - Validation: Multi-perspective review in parallel
- Architect: Functional completeness
- Security-reviewer: Vulnerability check
- Code-reviewer: Quality review
- All must approve; fix and re-validate on rejection
Phase 5 - Cleanup: Delete all state files on successful completion
- Remove
.omc/state/autopilot-state.json, ralph-state.json, ultrawork-state.json, ultraqa-state.json
- Run
/oh-my-claudecode:cancel for clean exit
Optional settings in .claude/settings.json:
{
"omc": {
"autopilot": {
"maxIterations": 10,
"maxQaCycles": 5,
"maxValidationRounds": 3,
"pauseAfterExpansion": false,
"pauseAfterPlanning": false,
"skipQa": false,
"skipValidation": false
}
}
}
Resume
If autopilot was cancelled or failed, run /oh-my-claudecode:autopilot again to resume from where it stopped.
Best Practices for Input
- Be specific about the domain -- "bookstore" not "store"
- Mention key features -- "with CRUD", "with authentication"
- Specify constraints -- "using TypeScript", "with PostgreSQL"
- Let it run -- avoid interrupting unless truly needed
Troubleshooting
Stuck in a phase? Check TODO list for blocked tasks, review .omc/autopilot-state.json, or cancel and resume.
QA cycles exhausted? The same error 3 times indicates a fundamental issue. Review the error pattern; manual intervention may be needed.
Validation keeps failing? Review the specific issues. Requirements may have been too vague -- cancel and provide more detail.
Deep Interview Integration
When autopilot is invoked with a vague input, Phase 0 can redirect to /deep-interview for Socratic clarification:
User: "autopilot build me something cool"
Autopilot: "Your request is open-ended. Would you like to run a deep interview first?"
[Yes, interview first (Recommended)] [No, expand directly]
If a deep-interview spec already exists at .omc/specs/deep-interview-*.md, autopilot uses it directly as Phase 0 output (the spec has already been mathematically validated for clarity).
3-Stage Pipeline: deep-interview → ralplan → autopilot
The recommended full pipeline chains three quality gates:
/deep-interview "vague idea"
→ Socratic Q&A → spec (ambiguity ≤ 20%)
→ /ralplan --direct → consensus plan (Planner/Architect/Critic approved)
→ /autopilot → skips Phase 0+1, starts at Phase 2 (Execution)
When autopilot detects a ralplan consensus plan (.omc/plans/ralplan-*.md or .omc/plans/consensus-*.md), it skips both Phase 0 (Expansion) and Phase 1 (Planning) because the plan has already been:
- Requirements-validated (deep-interview ambiguity gate)
- Architecture-reviewed (ralplan Architect agent)
- Quality-checked (ralplan Critic agent)
Autopilot starts directly at Phase 2 (Execution via Ralph + Ultrawork).
1---2name: autopilot3description: Full autonomous execution from idea to working code4level: 45---67<Purpose>8Autopilot takes a brief product idea and autonomously handles the full lifecycle: requirements analysis, technical design, planning, parallel implementation, QA cycling, and multi-perspective validation. It produces working, verified code from a 2-3 line description.9</Purpose>1011<Use_When>12- User wants end-to-end autonomous execution from an idea to working code13- User says "autopilot", "auto pilot", "autonomous", "build me", "create me", "make me", "full auto", "handle it all", or "I want a/an..."14- Task requires multiple phases: planning, coding, testing, and validation15- User wants hands-off execution and is willing to let the system run to completion16</Use_When>1718<Do_Not_Use_When>19- User wants to explore options or brainstorm -- use `plan` skill instead20- User says "just explain", "draft only", or "what would you suggest" -- respond conversationally21- User wants a single focused code change -- use `ralph` or delegate to an executor agent22- User wants to review or critique an existing plan -- use `plan --review`23- Task is a quick fix or small bug -- use direct executor delegation24</Do_Not_Use_When>2526<Why_This_Exists>27Most non-trivial software tasks require coordinated phases: understanding requirements, designing a solution, implementing in parallel, testing, and validating quality. Autopilot orchestrates all of these phases automatically so the user can describe what they want and receive working code without managing each step.28</Why_This_Exists>2930<Execution_Policy>31- Each phase must complete before the next begins32- Parallel execution is used within phases where possible (Phase 2 and Phase 4)33- QA cycles repeat up to 5 times; if the same error persists 3 times, stop and report the fundamental issue34- Validation requires approval from all reviewers; rejected items get fixed and re-validated35- Cancel with `/oh-my-claudecode:cancel` at any time; progress is preserved for resume36</Execution_Policy>3738<Steps>391. **Phase 0 - Expansion**: Turn the user's idea into a detailed spec40 - **If ralplan consensus plan exists** (`.omc/plans/ralplan-*.md` or `.omc/plans/consensus-*.md` from the 3-stage pipeline): Skip BOTH Phase 0 and Phase 1 — jump directly to Phase 2 (Execution). The plan has already been Planner/Architect/Critic validated.41 - **If deep-interview spec exists** (`.omc/specs/deep-interview-*.md`): Skip analyst+architect expansion, use the pre-validated spec directly as Phase 0 output. Continue to Phase 1 (Planning).42 - **If input is vague** (no file paths, function names, or concrete anchors): Offer redirect to `/deep-interview` for Socratic clarification before expanding43 - **Otherwise**: Analyst (Opus) extracts requirements, Architect (Opus) creates technical specification44 - Output: `.omc/autopilot/spec.md`45462. **Phase 1 - Planning**: Create an implementation plan from the spec47 - **If ralplan consensus plan exists**: Skip — already done in the 3-stage pipeline48 - Architect (Opus): Create plan (direct mode, no interview)49 - Critic (Opus): Validate plan50 - Output: `.omc/plans/autopilot-impl.md`51523. **Phase 2 - Execution**: Implement the plan using Ralph + Ultrawork53 - Executor (Haiku): Simple tasks54 - Executor (Sonnet): Standard tasks55 - Executor (Opus): Complex tasks56 - Run independent tasks in parallel57584. **Phase 3 - QA**: Cycle until all tests pass (UltraQA mode)59 - Build, lint, test, fix failures60 - Repeat up to 5 cycles61 - Stop early if the same error repeats 3 times (indicates a fundamental issue)62635. **Phase 4 - Validation**: Multi-perspective review in parallel64 - Architect: Functional completeness65 - Security-reviewer: Vulnerability check66 - Code-reviewer: Quality review67 - All must approve; fix and re-validate on rejection68696. **Phase 5 - Cleanup**: Delete all state files on successful completion70 - Remove `.omc/state/autopilot-state.json`, `ralph-state.json`, `ultrawork-state.json`, `ultraqa-state.json`71 - Run `/oh-my-claudecode:cancel` for clean exit72</Steps>7374<Tool_Usage>75- Use `Task(subagent_type="oh-my-claudecode:architect", ...)` for Phase 4 architecture validation76- Use `Task(subagent_type="oh-my-claudecode:security-reviewer", ...)` for Phase 4 security review77- Use `Task(subagent_type="oh-my-claudecode:code-reviewer", ...)` for Phase 4 quality review78- Agents form their own analysis first, then spawn Claude Task agents for cross-validation79- Never block on external tools; proceed with available agents if delegation fails80</Tool_Usage>8182<Examples>83<Good>84User: "autopilot A REST API for a bookstore inventory with CRUD operations using TypeScript"85Why good: Specific domain (bookstore), clear features (CRUD), technology constraint (TypeScript). Autopilot has enough context to expand into a full spec.86</Good>8788<Good>89User: "build me a CLI tool that tracks daily habits with streak counting"90Why good: Clear product concept with a specific feature. The "build me" trigger activates autopilot.91</Good>9293<Bad>94User: "fix the bug in the login page"95Why bad: This is a single focused fix, not a multi-phase project. Use direct executor delegation or ralph instead.96</Bad>9798<Bad>99User: "what are some good approaches for adding caching?"100Why bad: This is an exploration/brainstorming request. Respond conversationally or use the plan skill.101</Bad>102</Examples>103104<Escalation_And_Stop_Conditions>105- Stop and report when the same QA error persists across 3 cycles (fundamental issue requiring human input)106- Stop and report when validation keeps failing after 3 re-validation rounds107- Stop when the user says "stop", "cancel", or "abort"108- If requirements were too vague and expansion produces an unclear spec, offer redirect to `/deep-interview` for Socratic clarification, or pause and ask the user for clarification before proceeding109</Escalation_And_Stop_Conditions>110111<Final_Checklist>112- [ ] All 5 phases completed (Expansion, Planning, Execution, QA, Validation)113- [ ] All validators approved in Phase 4114- [ ] Tests pass (verified with fresh test run output)115- [ ] Build succeeds (verified with fresh build output)116- [ ] State files cleaned up117- [ ] User informed of completion with summary of what was built118</Final_Checklist>119120<Advanced>121## Configuration122123Optional settings in `.claude/settings.json`:124125```json126{127 "omc": {128 "autopilot": {129 "maxIterations": 10,130 "maxQaCycles": 5,131 "maxValidationRounds": 3,132 "pauseAfterExpansion": false,133 "pauseAfterPlanning": false,134 "skipQa": false,135 "skipValidation": false136 }137 }138}139```140141## Resume142143If autopilot was cancelled or failed, run `/oh-my-claudecode:autopilot` again to resume from where it stopped.144145## Best Practices for Input1461471. Be specific about the domain -- "bookstore" not "store"1482. Mention key features -- "with CRUD", "with authentication"1493. Specify constraints -- "using TypeScript", "with PostgreSQL"1504. Let it run -- avoid interrupting unless truly needed151152## Troubleshooting153154**Stuck in a phase?** Check TODO list for blocked tasks, review `.omc/autopilot-state.json`, or cancel and resume.155156**QA cycles exhausted?** The same error 3 times indicates a fundamental issue. Review the error pattern; manual intervention may be needed.157158**Validation keeps failing?** Review the specific issues. Requirements may have been too vague -- cancel and provide more detail.159160## Deep Interview Integration161162When autopilot is invoked with a vague input, Phase 0 can redirect to `/deep-interview` for Socratic clarification:163164```165User: "autopilot build me something cool"166Autopilot: "Your request is open-ended. Would you like to run a deep interview first?"167 [Yes, interview first (Recommended)] [No, expand directly]168```169170If a deep-interview spec already exists at `.omc/specs/deep-interview-*.md`, autopilot uses it directly as Phase 0 output (the spec has already been mathematically validated for clarity).171172### 3-Stage Pipeline: deep-interview → ralplan → autopilot173174The recommended full pipeline chains three quality gates:175176```177/deep-interview "vague idea"178 → Socratic Q&A → spec (ambiguity ≤ 20%)179 → /ralplan --direct → consensus plan (Planner/Architect/Critic approved)180 → /autopilot → skips Phase 0+1, starts at Phase 2 (Execution)181```182183When autopilot detects a ralplan consensus plan (`.omc/plans/ralplan-*.md` or `.omc/plans/consensus-*.md`), it skips both Phase 0 (Expansion) and Phase 1 (Planning) because the plan has already been:184- Requirements-validated (deep-interview ambiguity gate)185- Architecture-reviewed (ralplan Architect agent)186- Quality-checked (ralplan Critic agent)187188Autopilot starts directly at Phase 2 (Execution via Ralph + Ultrawork).189</Advanced>