チャットは忘れる。リポジトリは覚えている。
同じ協調の課題を、2 つのやり方で。repo-harness は信頼の源泉をスレッドから取り出し、すべてのエージェントと人間が読めるファイルへ移します。
- セッションが終わる、または上限に達すると文脈が蒸発する
- 毎回 grep と読み込みで構造を組み立て直す
- 何を、なぜ決めたのかの永続的な記録が残らない
- Claude と Codex がスレッド間で次第にずれていく
- レビューは会話全体を読み直すこと
- .ai/harness/handoff/ から正確な次の一歩を再開
- 約 12KB の安定したルート文脈に CodeGraph インデックスを加える
- プラン・契約・チェック・レビューがリポジトリに存在する
- Claude と Codex が同じソース成果物をまず読む
- 1 枚の Human Review Card と機械的な証拠でレビュー
機能の表面積は意図的に小さい。
リポジトリを点検し、リポジトリローカルなワークフローファイルを導入し、ホストイベントをフックで振り分け、ワークフロー面を Claude・Codex・人間の間で一貫させます。
ファイルベースのセッション
ハンドオフ・プラン・再開パケットはリポジトリに存在します。セッションは作業途中で終えられ、次回は正確な次の一歩・ブロッカー・変更ファイルから再開します。
設計からトークン軽量
約 12KB の安定したルート文脈に、構造クエリ用の CodeGraph インデックス——毎回 grep と読み込みでリポジトリを再走査する代わりに。
守り、追跡するフック
8 つの管理ルートが警告・ブロック・追跡・ハンドオフを行います。編集ゲートはプラン承認まで保持され、完了主張ゲートはファイルベースの証拠を検証します。
1 枚の Human Review Card
タスクごとに 1 画面の意思決定面：判定、意図したファイルと実際のファイル、通過したコマンド、残存リスク、ロールバック。
隔離されたワークツリー
エージェントはリンクされたブランチまたはワークツリーで、契約が許可するパスに限定して作業します——無関係な変更状態は保護されます。
ローカルかつ監査可能
永続的な真実はリポジトリのファイルであり、チャット履歴やホスト型スレッドではありません。任意の MCP サイドカーはワークフロー成果物のみを公開——ソースへの書き込みも shell もありません。
ローカル、監査可能、エージェントネイティブ。
8 つの層、1 つの真実の源泉。CLI が編成し、契約とファイリングシステムが永続状態を保持し、検証層が成果を証明します——ChatGPT Pro がローカルで計画し、Claude または Codex が実行します。
一本の階層化されたチェーンが、最後まで貫く。
計画チェーンは意図的に階層化されています。各ステップは、次のエージェントが最初に読む「意思決定の完結した成果物」を書きます——チャットが真実の源泉になることはありません。
領域をマップ：変更が触れるファイル・面・既存実装。
影響をトレース：呼び出し元・呼び出し先、その背後の因果連鎖。
判断と根拠：選んだ方針とその理由——次のエージェントへ記録。
ガイド付きの方向付けを経て、plans/prds/ 配下に上位レイヤーの PRD を作成。
PRD は、機械で検証可能な受け入れ行を持つスプリントになります。
限定された /goal プロンプトが、どちらのエージェントでも各スプリント片をループで処理します。
レビューが合格を推奨し、カードの判定が合格で、外部受け入れも合格のときだけ受理します。その後、契約・最新トレース・変更ファイルを点検します。
ChatGPT Pro で計画し、Claude または Codex で実行する。
任意の repo-harness mcp サイドカーは、MCP クライアントへ ワークフロー成果物のみ を公開します。ChatGPT Pro は実際のリポジトリ状態に対して計画し、アイデアを PRD → Sprint → Goal ハンドオフへと進めます——その後、既存の Claude または Codex セッションがファイルベースのスプリントを実行します。
- 1 リポジトリ状態を読む
ChatGPT は MCP サイドカー経由でワークフローファイル——プラン・契約・チェック・ハンドオフ——を読みます。
- 2 PRD を書く
write_prd_from_idea が plans/prds/ 配下に意思決定の完結した PRD を起草します。
- 3 Sprint を書く
write_checklist_sprint が、機械で検証可能な受け入れを持つ順序付きバックログに変換します。
- 4 ハンドオフを準備
prepare_codex_goal_from_sprint が .ai/harness/handoff/codex-goal.md を書き出します。
- 5 Claude または Codex が実行
既存の Claude または Codex セッションがホストネイティブの /goal プロンプトを実行し、完了した各スプリント段階をステージします。
8 つの管理フックルート。
導入されたアダプターが 8 つのルートを所有します。タプル event + routeId + matcher が安定した契約——セッションをまたいで警告・ブロック・追跡・ハンドオフを行います。
守りのルートはフェイルクローズ——スクリプトが欠けると必須ゲートがブロックします。
1 画面で受理または却下。
すべてのタスクは Human Review Card——1 画面の意思決定面——を書き出します。何が変わったか、なぜ範囲内か、何が検証したか、どんなリスクが残るか、どう戻すかが分かります。
レビューが合格を推奨し、カードの判定が合格で、外部受け入れが合格・not_required・明示的な手動オーバーライドのときだけ受理します。
Bun 駆動。1 コマンドでブートストラップ。
既定のインストーラーは Bun 上で動きます——Node の設定は不要で、なければ Bun も入れてくれます。すでに Node ですか？それも動きます。ランタイムを一度ブートストラップし、何かを適用する前に dry run でリポジトリローカルな契約をプレビューします。
repo-harness adopt --dry-run を実行します。作成または更新される全ファイルを報告します——報告が正しいときだけ適用してください。他者の優れた仕事の上に。
これらのスキル・リポジトリ・ランタイムは、repo-harness の設計と公開の過程でワークフロー契約を形づくりました。通常の同梱依存ではなく、影響として感謝します。
計画・トレース・意思決定の根拠規律を形づくった P1/P2/P3 事前調査メソッドと Geju の実践。
日々の計画・バグハント・検証・Codex 優先のスキル同期のための think・hunt・check・health スキル。
プロダクト探索、計画・設計レビュー、公開後のドキュメント整備、知識同期、長期リポジトリ記憶。
人間が読めるアーキテクチャ・システムフロー図。
シンボル認識のナビゲーション、影響トレース、準備チェック。
リポジトリローカルな実装と検証の主要な実行エージェント。
Codex がコミットに実質的に貢献したとき、コミットには Co-authored-by: codex <[email protected]> が付きます — オプトインでコミットごとに可視。
次のエージェントセッションを再開可能に。
ランタイムをブートストラップし、dry run で契約をプレビューし、ワークフローを証明します。MIT のもとで無料・オープンソース。