Communitygithub.com

cookys/autopilot

depth-0이 백그라운드 Sonnet 감독관과 이종 핸즈를 통해 탐색부터 릴리스까지 자동 조종 계획 또는 백로그 번들을 배송할 수 있는 파이프라인입니다.

autopilot란 무엇인가요?

이 스킬은 다중 감독관(Multi-foreman) 파이프라인을 통해 계획 또는 백로그 번들을 자동으로 배송하는 방법을 정의합니다. depth-0이 유일한 의사 결정권자로서 각 감독관의 출력을 증거로만 활용하며, 최종 판결은 스스로 내립니다. 파이프라인은 탐색(Probe) → 계획 검토(Plan Review) → 구현 감독관(Implement Foreman) → 배포 감독관(Landing Foreman) → 마무리 감독관(Closeout Foreman) 순서로 진행되며, 각 단계 사이에 depth-0의 검증이 필요합니다. 모든 감독관은 백그라운드에서 실행되며, `dispatch-model-guard`를 통해 모델 제약을 준수하고, `templates/` 디렉토리의 템플릿을 사용하여 일관된 작업을 보장합니다. 특히 중요하게 다루는 부분은 구현 감독관의 그림자 커밋(shadow commit) 처리와 배포 감독관의 코드 훅 설정, 그리고 결합 검토(Combined Review)를 통해 단계별 검토에서 놓친 문제를 발견하는 프로세스입니다. 이 스킬은 주로 Claude Code 환경에서 사용되며, Traditional-Chinese 규칙(派工頭做完發版, 平行工頭, 落地發版)을 따릅니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cookys/autopilot/tree/HEAD/.claude/skills/foreman-landing-pipeline

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

foreman-landing-pipeline

계획 또는 BACKLOG 번들을 배송하기 위한 다중 감독관 파이프라인: 탐색 → 계획 검토 → 구현 감독관 → 배포 감독관 → 각 단계 사이 depth-0 검증 → 마무리 감독관. depth-0은 주장을 수락하는 유일한 권한이며, 모든 감독관의 출력은 증거일 뿐 판결이 아닙니다.

0. 사전 작업 (감독관 실행 전)

  • 계획이 의존하는 모든 플랫폼 사실을 이 세션에서 아직 확인하지 않았다면 URL을 통해 확인하거나 실제 도구를 실행하십시오(프로젝트 CLAUDE.md "Don't" § 참조). 확인되지 않은 사실은 Spike 후보이며 사실이 아닙니다 — 계획에 Spike로 포함하거나 먼저 확인하십시오.
  • 계획을 작성한 후, 이 스킬의 자체 판단이 아닌 계획 검토 루프(autopilot:hetero-review → dispatch-plan-review)를 통해 실행하십시오:
    • 생성별로 고정된 루브릭; 의자 교체는 감독관의 주도가 아닌 운영자의 승인이 필요합니다.
    • G1 처분은 구속력이 있습니다 — 모든 수락된 항목은 구현 브리프의 Global Constraints에 그대로 포함됩니다.
    • 최대 G2까지만. 루브릭 항목이 G1에서 기각된 경우, 이전 항목을 부활시키지 말고 새 논리적 ID와 티켓으로 교체하십시오.
    • 계획을 구현 가능한 것으로 간주하기 전에 고정 확인(freeze check) 을 실행하십시오.
    • 고정 후 제한된 수리(bounded repair)는 고정 확인 자체에서 표면화된 결함에 대해서만 허용됩니다 — 이미 판결된 루브릭 항목을 다시 열 수 없습니다.

1. 구현 감독관

templates/implement-brief.md에서 배경 Sonnet 감독관(Engine: sonnet 헤더 — dispatch-model-guard는 이를 누락한 디스패치를 거부)을 발송하십시오. 브리프에 대한 판단:

  • 메인 체크아웃이 아닌 클론(clone)을 사용하십시오. 클론은 그림자 커밋("PARALLEL-RUN LOCAL ONLY — mission_convergence enforcement_mode shadow, never land")을 포함하므로 dispatch-hetero.sh가 Mission 시행 하에서 거부하지 않습니다. 그림자 커밋을 브리프 자체에, 설정 단계에서, depth-0이 작성자로 넣으십시오 — 절대 감독관에게 후속 메시지로 보내지 마십시오. 후속 메시지는 권한 부여가 아닙니다; 거부되거나 잘못 적용된 그림자 커밋이 wave-1b의 비용이 발생한 원인입니다.
  • 스택된 행: 각 행의 핸드 베이스 = 이전 행의 수락된 HEAD(수리된 경우 수리 HEAD). 행당 하나의 핸드 커밋, RED 우선 테스트, Verify는 해당 행의 자체 스위트와 영향을 받는 계약의 모든 CONSUMER 스위트를 실행합니다(번들 스위트만이 아닙니다).
  • 행별 검토는 여기서 이루어지지만, 필요 조건이지 충분 조건이 아닌 것으로 간주하십시오 — §2의 결합 검토를 참조하십시오.
  • 레일 실패(할당량, 402, 준비 상태, "Cannot use this model")는 RAIL-FAIL이며, 감독관이 직접 코드를 작성하는 이유가 아닙니다.

1b. 발송 전 형태 크기 조정 (2026-10-02/03)

  • 독립적인 행은 병렬로 실행되며 스택되지 않습니다: 하나의 클론 내 각 행에 대해 자체 작업 트리에서 templates/hand-brief-common.md를 사용하는 하나의 Sonnet 핸드입니다. 진정한 종속성에 대해서만 스택하십시오. 7개의 병렬 S 행이 약 1시간 만에 배송되었습니다; 동일한 크기의 스택형 저렴한 핸드 번들은 약 3시간이 걸렸습니다.
  • 핸드 선택: 크거나 신호/트랩/샌드박싱을 다루는 행은 저렴한 레일 핸드가 아닌 Sonnet 핸드(Agent, 모델 sonnet)를 받습니다 — 7개의 저렴한 핸드 행 중 6개가 수리 라운드가 필요했습니다.
  • 시간 절약을 위해 행별 검토를 절대 건너뛰지 마십시오: v2.36.108에서는 이를 건너뛰었고 세 가지 문제가 결합 검토에서만 드러나 각각 배포 라운드 비용이 발생했습니다.
  • L1을 포함한 소비자 스위프(Consumer sweep) 는 모든 핸드의 Verify의 일부입니다(템플릿에 방법이 명시됨); 자체 bash 스위트만 실행하는 핸드는 실패를 배포 게이트로 밀어냅니다.
  • 발송 시 운영자에게 예상 벽시계 시간을 알려주십시오.

2. 배포 감독관

templates/land-brief.md의 새 브리프, depth-0이 git 증거(diff, 자체 보고 아님)를 통해 모든 구현 감독관 행을 수락한 후에만 발송됩니다. 브리프에 대한 판단:

  • 구현 클론이 아닌 origin/develop의 새 클론을 사용하십시오. 첫 번째 설정 줄에서 git config core.hooksPath .githooks를 설정하십시오 — 이 설정 없이 배포 클론은 pre-push qc-gate를 실행하지 않고 배송됩니다(v2.36.99는 이 방식으로 리터럴 <id> 트레일러를 배송했습니다).
  • 핸드 커밋만 체리픽하십시오. 그림자 커밋은 절대 안 됩니다; 모든 피킹 후 enforcement_mode를 grep하면 여전히 enforce라고 표시되어야 합니다.
  • 범위를 제한하지 않은 전체 스위트 — 널리 소비되는 계약을 변경하는 경우 전체 hooks/tests/run.sh가 필요합니다. 모든 빨간 solo를 다시 실행하십시오; 여전히 빨간 것은 버려진 작업 트리에서 origin/develop과 비교하여 기존 빨간 것과 브랜치가 도입한 빨간 것을 구분하십시오.
  • 단일 결합 검토(ONE combined review) 는 origin/develop..HEAD에 대해 수행되며, 행별 검토를 다시 실행하지 않습니다. 결합 검토는 이 정확한 파이프라인에서 행별 검토가 놓친 것을 포착했습니다(멀티플렉서 allow-bypass 및 한 라운드에서 다섯 건의 발견 — Rules learned 참조). 해당 판결에서 🔴/🟠가 있으면 STOP하십시오; 스스로 이를 무시하지 마십시오.
  • 게이트가 녹색이고 판결이 SHIP-AS-IS인 경우에만 릴리스하십시오: 버전 범프, BACKLOG/CHANGELOG/INDEX, preflight-release.sh.
  • 트레일러는 리터럴 플레이스홀더 문자열이 아닌, 결합 검토가 실제로 생성한 JSON의 실제 검토 ID로 채워집니다. 푸시한 후 git ls-remote origin develop으로 확인하십시오.

3. 단계 간 depth-0의 의무

  • 반박된 모든 발견 사항을 직접 재유도하십시오. ADR-0001 (증명보다 검증): 감독관의 "이 발견은 오탐(false positive)입니다"라는 주장은 동일한 diff에서 직접 재유도할 때까지 사실이 아닌 주장입니다.
  • 각 푸시를 독립적으로 검증하십시오: git ls-remote가 보고된 SHA와 일치하는지, 트레일러에 실제 검토 ID(리터럴 <id> 아님)가 있는지, governance가 여전히 enforce로 읽히는지, 그림자 커밋이 배송되지 않았는지 확인하십시오.
  • 대기 중인 감독관은 스스로 깨어나지 않습니다. 발송과 함께 백그라운드 데드맨 타이머(sleep <n>; echo WAKE-<tag>)를 사용하고, 깨어날 때 git-state를 확인하며, 보고해야 하는데 보고하지 않은 감독관에게 SendMessage로 알림을 보내십시오.

4. 마무리 감독관

templates/closeout-brief.md에서, 실제 저장소(클론 아님 — "여기서 다른 것은 실행되지 않음")에서 수행됩니다. 이 단계는 번들이 작아도 절대 건너뛰지 않습니다:

  • 배송된 정확한 diff 범위에 대한 범위가 제한된 문서 동기화 — 실제 표류만 수정합니다.
  • 파이프라인 도중 발견되었지만 지금 수정 범위에 없었던 항목(예: 의심되지만 확인되지 않은 오염 사건)에 대한 BACKLOG 행.
  • docs/plans/evidence/<date>-<slug>/ 디렉토리 아래에 모든 브리프, 모든 REPORT, 모든 검토 JSON, 탐색 및 결합 검토 발견 사항을 명명한 짧은 README가 포함된 증거 디렉토리.
  • 기존 스타일의 HANDOFF 업데이트 (중국어 번체 규칙 적용 — 프로젝트 CLAUDE.md 참조).
  • qc-보호 경로를 건드리면 배포 커밋과 동일한 방식으로 게이트된 하나의 커밋.

수리 (배포 게이트가 릴리스 브랜치에서만 빨간색으로 표시될 때)

배포 감독관의 게이트 실행에서 릴리스 브랜치에서 스위트가 빨간색이지만 origin/develop에서는 녹색인 경우 templates/repair-brief.md를 사용하십시오. 먼저 클러스터별로 이분 탐색(bisect)하십시오 — 의심 추측보다 이분 탐색을 신뢰하십시오. 클러스터당 하나의 수리 핸드, 재구축된 섀도우 브랜치(릴리스 브랜치 자체가 아님)에서, 구현 감독관 핸드와 동일한 방식으로 검토됩니다. 클러스터당 최대 한 번의 수리 라운드; 이후에도 빨간색으로 남아 있으면 FAIL로 보고되며, 감독관 자체가 수리하지 않습니다.

규칙 — 다른 곳에 정식으로 있음 (여기에 중복 금지)

이 스킬은 체크리스트와 템플릿(templates/*.md)입니다. 규칙과 해당 소스 이벤트는 다음 위치에 있습니다:

  • skills/l5/references/hetero-impl-loop.md § "Sonnet foremen as Agent subagents": 그림자 커밋은 브리프에 포함되고, 배포 클론은 core.hooksPath를 설정하며, 트레일러 ID는 매니페스트에서 가져오고, 배포 감독관은 🔴/🟠에서 멈춥니다.
  • references/evidence-discipline.md §42–§44: 자문 채널이 존재한다고 해서 도착이 보장되지는 않으며, 행별 검토는 결합 검토를 대체할 수 없으며, 실제 저장소 diff는 테스트 오염의 증거가 아닙니다.
  • 도구 가드 함정: exec-경계는 heredoc 텍스트 내에서도 파괴적인 형태의 단어를 차단하므로, 먼저 파일에 스크립트를 작성하십시오; pgrep -f/pkill -f는 자신과 일치합니다. 이는 운영자의 기억에 있으며 저장소에 없습니다.

새로운 규칙이 학습되면 여기가 아닌 해당 파일에 추가하십시오.

관련 스킬