foreman-landing-pipeline
計画またはBACKLOGバンドルを出荷するためのマルチフォアマンパイプライン:プローブ → 計画レビュー → 実装フォアマン → ランディングフォアマン → depth-0による段階間検証 → クローズアウトフォアマン。depth-0はクレームを受け入れる唯一の権限であり、すべてのフォアマンの出力は証拠であり、判定ではありません。
0. 事前作業(フォアマンが存在する前)
- プローブ:計画が依存するプラットフォームの事実で、このセッションでURLまたは実際のツールの実行(プロジェクトのCLAUDE.md「Don't」§を参照)によって確認していないものはすべてプローブします。確認されていない事実はSpike候補であり、事実ではありません — 計画にSpikeとして入れるか、事前にプローブします。
- 計画を書いたら、このスキル自身の判断ではなく、計画レビューループ(
autopilot:hetero-review→dispatch-plan-review)にかけます:- 生成ごとに凍結されたルーブリック。議長交代にはオペレーターの承認が必要であり、フォアマンのイニシアチブでは行われません。
- G1の処分は拘束力があります — 受理された各項目は、実装ブリーフのグローバル制約にそのまま含まれます。
- 最大G2まで。 ルーブリックの項目がG1で敗北した場合、古いものを復活させるのではなく、新しい論理IDとチケットで置き換えます。
- 計画を実装可能として扱う前に、フリーズチェックを実行します。
- フリーズ後の限定された修復は、フリーズチェック自体が明らかにした欠陥に対してのみ許可されます — すでに裁定されたルーブリック項目の再開はできません。
1. 実装フォアマン
templates/implement-brief.mdからバックグラウンドsonnetフォアマン(Engine: sonnetヘッダ — dispatch-model-guardはこれがないディスパッチを拒否します)をディスパッチします。ブリーフの判断:
- クローンであり、メインチェックアウトではない。 クローンはシャドウコミット(「PARALLEL-RUN LOCAL ONLY — mission_convergence enforcement_mode shadow, never land」)を保持するため、
dispatch-hetero.shがMission enforce下で拒否しません。シャドウコミットをフォアマンへのフォローアップメッセージとして送信するのではなく、ブリーフ自体にセットアップ時にdepth-0が著者として入れてください。 フォローアップメッセージは承認ではありません。拒否または誤適用されたシャドウコミットは、wave-1bのコストがかかりました。 - スタックされた行:各行のハンドベース = 前の行の受理されたヘッド(修復された場合はその修復ヘッド)。行ごとに1つのハンドコミット、RED-firstテスト、Verifyはその行自身のスイートと、タッチされたコントラクトのすべてのCONSUMERスイートを実行します — バンドルスイートだけではありません。
- 行ごとのレビューはここで行われますが、必要十分とは見なさないでください — §2の結合レビューを参照してください。
- レール障害(クォータ、402、準備完了、「Cannot use this model」)は
RAIL-FAILであり、フォアマンが自分でコードを作成する理由にはなりません。
1b. ディスパッチ前の形状のサイズ調整(2026-10-02/03)
- 独立した行は並列実行、スタックではなく:1つのクローンの独自のワークツリーに、
templates/hand-brief-common.mdから1行につき1つのsonnetハンド。真の依存関係のみをスタックします。7つの並列S行が約1時間でランディングしました。同じサイズのスタックされた安価ハンドバンドルは約3時間かかりました。 - ハンドの選択:行が大きい、またはシグナル/トラップ/サンドボックスに触れる場合、sonnetハンド(
Agent、モデルsonnet)を使用します。安価なレールハンドは使用しません — 安価ハンド行の6/7が修復ラウンドを必要としました。 - 時間を節約するために行ごとのレビューを決してスキップしない:v2.36.108ではスキップした結果、3つの問題が結合レビューでのみ表面化し、それぞれランディングラウンドがコストがかかりました。
- L1を含むコンシューマースイープはすべてのハンドの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>トレーラーが出荷されました)。 - ハンドコミットのみをチェリーピック。 シャドウコミットは絶対にしません。すべてのピック後も
grep enforcement_modeはenforceのままです。 - 全体のスイート、スコープを絞ったスライスではありません — 広く消費されるコントラクトに触れる変更には、完全な
hooks/tests/run.shが必要です。すべての赤い単体テストを再実行します。それでも赤いものは、使い捨てワークツリーのorigin/developと比較して、既存の赤とブランチが導入した赤を区別します。 - 1つの結合レビューを
origin/develop..HEADに対して行います。行ごとのレビューの再実行は決してしません。結合レビューは、この正確なパイプラインで行ごとのレビューが見逃したものを捕捉しました(マルチプレクサのバイパス許可と1ラウンドで5つの所見 — 「学んだルール」を参照)。その判定で🔴/🟠があればSTOP。自己判断でそれらを却下しないでください。 - リリースは、ゲートが緑で判定がSHIP-AS-ISの場合のみ:バージョンバンプ、BACKLOG/CHANGELOG/INDEX、
preflight-release.sh。 - トレーラーは、レビューマニフェストの実際のレビューID(結合レビューが実際に生成したJSON)から埋められ、リテラルなプレースホルダー文字列のままにはしません。プッシュ後、
git ls-remote origin developで確認します。
3. 段階間のdepth-0の責務
- 反論されたすべての所見を自分で再導出します。 ADR-0001(検証と証明の順位):フォアマンの「この所見は誤検知です」という主張は、同じdiffから再導出するまで事実ではなく主張です。
- 各プッシュを独立して検証:
git ls-remoteが報告されたSHAと一致すること、トレーラーが実際のレビューID(<id>ではない)を保持すること、ガバナンスがまだ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更新(zh-TWの慣例に従う — プロジェクトのCLAUDE.mdを参照)。
- 1つのコミット。qcで保護されたパスに触れる場合、ランディングコミットと同じ方法でゲートされます。
修復(ランディングゲートがリリースブランチでのみ赤くなる場合)
ランディングフォアマンのゲート実行で、スイートがリリースブランチでは赤いがorigin/developでは緑であることが判明した場合、templates/repair-brief.mdを使用します。まずクラスターごとにバイセクトします — 疑わしい推測よりもバイセクトを信頼します。クラスターごとに1つの修復ハンドを、再構築されたシャドウブランチ(リリースブランチ自体ではなく)に、実装フォアマンのハンドと同じ方法でレビューします。クラスターごとに最大1修復ラウンド。その後も赤いものは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-boudaryはヒアドキュメントテキスト内部でも破壊的な形の言葉をブロックするため、スクリプトを最初にファイルに書き込みます。
pgrep -f/pkill -fは自分自身にマッチします。これらはリポジトリではなく、オペレーターの記憶にあります。
新しいルールが学ばれたら、ここではなくそれらのファイルに追加します。