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는 자신과 일치합니다. 이는 운영자의 기억에 있으며 저장소에 없습니다.
새로운 규칙이 학습되면 여기가 아닌 해당 파일에 추가하십시오.