<Use_When>
- 사용자가 아이디어에서 작동 코드까지 엔드투엔드 자동 실행을 원할 때
- 사용자가 "autopilot", "auto pilot", "autonomous", "build me", "create me", "make me", "full auto", "handle it all" 또는 "I want a/an..."이라고 말할 때
- 작업에 계획, 코딩, 테스트, 검증의 여러 단계가 필요할 때
- 사용자가 수동 개입 없이 시스템이 완료될 때까지 실행되기를 원할 때 </Use_When>
<Do_Not_Use_When>
- 사용자가 옵션을 탐색하거나 브레인스토밍을 원할 때 -- 대신
plan스킬을 사용하세요 - 사용자가 "just explain", "draft only" 또는 "what would you suggest"라고 말할 때 -- 대화 형식으로 응답하세요
- 사용자가 단일 집중 코드 변경을 원할 때 --
ralph를 사용하거나 실행자 에이전트에 위임하세요 - 사용자가 기존 계획을 검토하거나 비평하기를 원할 때 --
plan --review를 사용하세요 - 작업이 빠른 수정이나 작은 버그일 때 -- 직접 실행자 위임을 사용하세요 </Do_Not_Use_When>
<Why_This_Exists> 대부분의 비사소한 소프트웨어 작업은 요구사항 이해, 솔루션 설계, 병렬 구현, 테스트, 품질 검증의 조정된 단계를 필요로 합니다. Autopilot은 이러한 모든 단계를 자동으로 조정하여 사용자가 원하는 것을 설명하기만 하면 각 단계를 관리할 필요 없이 작동 코드를 받을 수 있게 합니다. </Why_This_Exists>
<Execution_Policy>
- 각 단계는 다음 단계가 시작되기 전에 완료되어야 합니다
- 가능한 경우 단계 내에서 병렬 실행이 사용됩니다(Phase 2 및 Phase 4)
- QA 사이클은 최대 5회 반복됩니다. 동일한 오류가 3회 지속되면 중단하고 근본 문제를 보고합니다
- 검증은 모든 검토자의 승인이 필요합니다. 거부된 항목은 수정 후 재검증됩니다
- 언제든지
/oh-my-claudecode:cancel로 취소할 수 있습니다. 진행 상황은 재개를 위해 보존됩니다 </Execution_Policy>
<Workflow_Profiles>
명명된 단계 프로파일 (v1)
/autopilot --workflow <name> <task>로만 구성된 프로파일을 선택하세요. 프로파일은 autopilot이 소유한 단계 일정이며, 명령, 모드, 플러그인, 파일 이름 또는 별도의 상태 식별자가 아닙니다. --workflow 없이 autopilot은 기존 수명 주기와 동작을 유지합니다.
명명된 워크플로우 프로파일은 v1에서 Linux와 flock 유틸리티가 필요합니다. 그 이유는 트랜스크립트 증거 경계가 Linux no-follow 파일 디스크립터 탐색을 사용하고, 복구 가능한 변이 잠금이 커널 어드바이저리 잠금을 사용하기 때문입니다. 지원되지 않는 환경은 상태 변이 전에 명시적 --workflow 활성화를 거부합니다. 대신 레거시 autopilot을 사용하세요.
프로파일은 프로젝트 또는 사용자 JSONC에서 autopilot.workflows.<slug>로 구성됩니다. 모든 v1 프로파일은 정확히 version: 1과 stages를 가집니다. 다른 프로파일 키는 허용되지 않습니다. 허용되는 유일한 단계 시퀀스는 다음과 같습니다:
{
"autopilot": {
"workflows": {
"plan-build-qa": {
"version": 1,
"stages": ["ralplan", "execution", "qa"]
}
}
}
}
[ralplan, execution]
[ralplan, execution, ralph]
[ralplan, execution, qa]
[ralplan, execution, ralph, qa]
ralplan은 execution이 소비하는 계획을 생성합니다. execution은 ralph와 qa에 필요한 구현된 작업 공간을 생성합니다. 따라서 누락되거나 재정렬된 전제 조건, 중복 단계, 기본 제공되지 않은 단계는 유효하지 않습니다. 프로파일 이름은 ^[a-z][a-z0-9-]{0,62}$를 사용하며, 검증된 메타데이터일 뿐이며 기본 제공 단계, autopilot/모드 이름 또는 더 이상 사용되지 않는 별칭과 충돌할 수 없습니다.
사용자 및 프로젝트 구성 소스는 각각 합성 전에 검증됩니다. 다른 이름은 공존합니다. 동일한 이름의 프로젝트 프로파일은 사용자 프로파일을 딥 병합하지 않고 완전히 대체합니다. 환경 구성은 프로파일을 정의하거나 대체할 수 없습니다.
성공적으로 선택되면 autopilot은 기존 세션 범위 상태를 불변 정규화된 설명자와 선택된 파이프라인 추적만으로 원자적으로 생성합니다. 설명자에는 워크플로우 이름, 프로파일 버전, 표준 단계 및 결정적 SHA-256 프로파일 해시가 포함됩니다. 작업 텍스트와 변경 가능한 진행 상황은 제외됩니다. 재개 및 중지는 해당 해시를 확인하고 불일치 시 구성을 다시 로드하거나 단계 프롬프트를 내보내지 않고 거부합니다. 취소, 재개, 정리, 상태 검사, HUD 및 중지 연속은 autopilot이 계속 소유합니다.
설치된 플러그인 및 독립 설치 중지 후크는 활성 단계에 대한 승인된 어시스턴트 완료 레코드가 해당 단계의 유지된 활성화 트랜스크립트 경계 이후에 나타난 후에만 진행됩니다. 이들은 증거를 소유자 세션 및 경계가 있는 비심링크 트랜스크립트에 바인딩합니다. 사용자/도구/로컬 명령 출력 및 오래되었거나 잘못된 단계 증거를 거부합니다. 쓰기 전 비교 추적 업데이트를 사용하여 중복되거나 동시적인 중지 이벤트가 정확히 한 번만 진행되도록 합니다. 공개 상태, HUD 및 중지 출력은 안전한 워크플로우 메타데이터와 진행 상황만 표시하며, 작업, 설명자 내부, 트랜스크립트 참조, 오프셋 또는 레코드 해시는 표시하지 않습니다.
V1 연기 사항
V1은 stageModels, 모델 라우팅, 공급자 또는 역할 선택을 지원하지 않습니다. 인라인/비생성 실행, 동적 명령, 모드 또는 상태 파일, 임의 단계, 프롬프트, 플러그인, 분기, 루프, DAG 또는 콜백, 환경 정의 프로파일 정의도 지원하지 않습니다. 별도의 사용자 정의 스킬 인라인 배열 프론트매터 파서 불일치도 연기됩니다.
</Workflow_Profiles>
-
Phase 1 - 계획: 명세에서 구현 계획 생성
- ralplan 합의 계획이 존재하는 경우: 건너뜀 — 3단계 파이프라인에서 이미 완료됨
- 아키텍트(Opus): 계획 생성 (직접 모드, 인터뷰 없음)
- 비평가(Opus): 계획 검증
- 출력:
.omc/plans/autopilot-impl.md
-
Phase 2 - 실행: 필요한 경우 Ralph 지속성을 사용하여 실행자 에이전트로 계획 구현
- 실행자(Haiku): 간단한 작업
- 실행자(Sonnet): 표준 작업
- 실행자(Opus): 복잡한 작업
- 독립적인 작업을 병렬로 실행
-
Phase 3 - QA: 모든 테스트가 통과할 때까지 순환
- 빌드, 린트, 테스트, 실패 수정
- 최대 5회 순환 반복
- 동일한 오류가 3회 반복되면 조기 중단 (근본 문제를 나타냄)
-
Phase 4 - 검증: 병렬 다각적 검토
- 아키텍트: 기능적 완전성
- 보안 검토자: 취약점 검사
- 코드 검토자: 품질 검토
- 모두 승인해야 함. 거부 시 수정 및 재검증
-
Phase 5 - 정리: 성공적인 완료 시 모든 상태 파일 삭제
.omc/state/autopilot-state.json,ralph-state.json제거 (레거시 복사본이 있는 경우 오래된ultraqa-state.json/ultrawork-state.json도 제거)- 깔끔한 종료를 위해
/oh-my-claudecode:cancel실행
<Tool_Usage>
- Phase 4 아키텍처 검증에
Task(subagent_type="oh-my-claudecode:architect", ...)사용 - Phase 4 보안 검토에
Task(subagent_type="oh-my-claudecode:security-reviewer", ...)사용 - Phase 4 품질 검토에
Task(subagent_type="oh-my-claudecode:code-reviewer", ...)사용 - 에이전트는 자체 분석을 구성하여 반환합니다. LEAD는 이후 교차 검증 에이전트를 직접 생성합니다. Claude Code 깊이 설정을 확인하지 않고 하위 에이전트가 추가 하위 에이전트를 생성하는 데 의존하지 마십시오. Claude Code 2.1.217–2.1.218은
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH를 1로 기본 설정했으며, 2.1.219+는 기본값이 3입니다. 중첩 위임이 의도적이고 활성 런타임에서 지원되지 않는 한 교차 검증을 LEAD 수준에서 유지하십시오. - 외부 도구에서 차단하지 마십시오. 위임이 실패하면 사용 가능한 에이전트로 계속 진행하십시오. </Tool_Usage>
<Escalation_And_Stop_Conditions>
- 동일한 QA 오류가 3주기 동안 지속되면 중단하고 보고 (인간 입력이 필요한 근본 문제)
- 재검증 라운드 3회 후에도 검증이 계속 실패하면 중단하고 보고
- 사용자가 "stop", "cancel" 또는 "abort"라고 말하면 중단
- 요구사항이 너무 모호하여 확장 결과 불명확한 명세가 생성되면 소크라테스식 명확화를 위해
/deep-interview로 리디렉션을 제공하거나, 진행 전에 사용자에게 명확화를 요청하며 일시 중지 </Escalation_And_Stop_Conditions>
<Final_Checklist>
- 전체 5단계 완료 (확장, 계획, 실행, QA, 검증)
- Phase 4에서 모든 검증자 승인
- 테스트 통과 (새 테스트 실행 출력으로 확인)
- 빌드 성공 (새 빌드 출력으로 확인)
- 상태 파일 정리됨
- 사용자에게 구축된 내용 요약과 함께 완료 통보 </Final_Checklist>
병렬 세션 주의 사항
- 다중 리포지토리 작업 공간 앵커: 상위 디렉토리에
.omc-workspace마커를 배치하여 하위 리포지토리 간 여러 세션이 하나의.omc/를 공유하도록 합니다. 확인 순서:OMC_STATE_DIR > .omc-workspace > git > cwd.docs/REFERENCE.md를 참조하세요. - 세션 ID 소스: CLI 컨텍스트에서는 OMC_SESSION_ID 환경 변수가 우선합니다. 후크 컨텍스트에서는 후크 페이로드 data.session_id가 우선합니다.
- 계획 ID (해당되는 경우): Autopilot 상태는 세션 범위가 지정됩니다. 동일한 작업 공간에서 두 개의 autopilot은 고유한 세션 ID가 필요합니다.
- 병렬 판정: 지원됨 (세션 범위 상태)
.claude/omc.jsonc(프로젝트) 또는 ~/.config/claude-omc/config.jsonc(사용자)의 선택적 설정:
{
"autopilot": {
"maxIterations": 10,
"maxQaCycles": 5,
"maxValidationRounds": 3,
"pauseAfterExpansion": false,
"pauseAfterPlanning": false,
"skipQa": false,
"skipValidation": false,
"execution": "solo"
}
}
tmux CLI 팀 런타임을 통해 autopilot 구현을 실행하고 Cursor 실행자 워커를 선호하려면:
{
"autopilot": {
"execution": "team",
"team": { "agentTypes": ["cursor"] }
}
}
해당 구성으로 실행 단계는 실행자 스타일 작업을 다음을 통해 시작해야 합니다:
omc team 1:cursor "<implementation task>"
또는 Claude Code 슬래시 호환성 표면:
/omc-teams 1:cursor "<implementation task>"
제한 사항:
- Cursor 워커는 구현 및 검토자 스타일 팀 역할을 지원합니다.
critic,code-reviewer,security-reviewer및test-engineer워커는 팀 리더가 소비하는 구조화된 평결 파일을 내보내야 합니다. 최종 승인은 리드 세션 책임으로 남습니다. - Cursor는
cursor-agentCLI가 설치되고 인증되어야 합니다.cursor-agent를 사용할 수 없는 경우 자동으로 Claude 전용 실행으로 대체하지 않고 해당 설정 요구 사항을 보고하십시오.
재개
autopilot이 취소되었거나 실패한 경우 /oh-my-claudecode:autopilot을 다시 실행하여 중단된 지점부터 재개합니다.
입력 모범 사례
- 도메인을 구체적으로 지정하십시오 — "store"가 아닌 "bookstore"
- 주요 기능을 언급하십시오 — "with CRUD", "with authentication"
- 제약 조건을 지정하십시오 — "using TypeScript", "with PostgreSQL"
- 실행되도록 두십시오 — 정말 필요한 경우가 아니면 방해하지 마십시오
문제 해결
단계에서 멈췄습니까? TODO 목록에서 차단된 작업을 확인하고 .omc/autopilot-state.json을 검토하거나 취소하고 재개하십시오.
QA 사이클이 소진되었습니까? 동일한 오류가 3회 발생하면 근본 문제를 나타냅니다. 오류 패턴을 검토하십시오. 수동 개입이 필요할 수 있습니다.
검증이 계속 실패합니까? 특정 문제를 검토하십시오. 요구사항이 너무 모호했을 수 있습니다. 취소하고 더 자세한 내용을 제공하십시오.
심층 인터뷰 통합
autopilot이 모호한 입력으로 호출되면 Phase 0은 소크라테스식 명확화를 위해 /deep-interview로 리디렉션할 수 있습니다:
사용자: "autopilot 나를 위해 멋진 것을 만들어 줘"
Autopilot: "요청이 개방적입니다. 먼저 심층 인터뷰를 실행하시겠습니까?"
[예, 먼저 인터뷰 (권장)] [아니요, 직접 확장]
심층 인터뷰 명세가 이미 .omc/specs/deep-interview-*.md에 존재하는 경우 autopilot은 이를 Phase 0 출력으로 직접 사용합니다 (명세는 이미 명확성에 대해 수학적으로 검증되었습니다).
3단계 파이프라인: deep-interview → ralplan → autopilot
권장되는 전체 파이프라인은 세 가지 품질 게이트를 연결합니다:
/deep-interview "모호한 아이디어"
→ 소크라테스식 Q&A → 명세 (모호성 ≤ 20%)