Ancienttwo/repo-harness
File-backed workflow harness for reliable Claude Code and Codex sessions.
解決する問題
repo-harness は、ソフトウェア開発でAIエージェント（ClaudeやCodexなど）を使用する際の「チャットメモリ喪失」とトークン非効率の問題を解決します。チャットスレッドの履歴に依存する代わりに、プロジェクトの状態（計画、契約、引き継ぎ、証跡）をリポジトリファイルに直接配置します。これにより、新しいセッションが開始されたとき、エージェントはコードベース全体を再スキャンしたり現在のステータスを再導出したりすることなく、前回の終了地点から正確に再開できます。
仕組み
このシステムは2つのレイヤーで動作します：
- セッション契約レイヤー：CLIとホストアダプター（ClaudeおよびCodex用）を使用して、型付きフックランタイムを通じてイベントをルーティングします。これらのフックは、コンテキスト、計画、レビュー証跡をリポジトリに書き込みます。厳格なライフサイクルを実装します：Plan $\rightarrow$ Contract $\rightarrow$ Review。承認された計画から特定の契約に作業が投射され、クローズアウト前に構造化された証跡で検証されます。
- ボットスケジュールプログラムレイヤー：長時間実行される作業のために、「承認済みプログラム」をサポートします。タスクは更新可能なリースとエンジニアバインディングを介して管理され、作業が複数のセッションと異なるエージェントにわたって持続できるようにします。
トークン使用量を低く抑えるために、プログレッシブコンテキストローディング（必要な機能ブロックのみをロード）を使用し、繰り返しのgrep-and-readループの代わりに構造化クエリ用のCodeGraphインデックスと統合します。
対象読者
複雑なマルチセッションのソフトウェアエンジニアリングタスク、スプリント、PRDを管理するためにAIエージェント（特にClaudeとCodex）を使用する開発者とチーム向けに設計されています。
ハイライト
- ファイルバックアップセッション：チャット履歴ではなく、リポジトリの成果物（引き継ぎ、ジャーナル）から作業を再開します。
- トークン効率的なアーキテクチャ：小さなルートコンテキスト（約12KB）と構造化CodeGraphクエリを使用してトークン消費を削減します。
- レビュー準備済みの証跡：人間による検証のための構造化チェック証跡とレビューカードを生成します。
- 型付きフックランタイム：編集境界で管理されたルートとフェイルクローズガードを提供し、エージェントをプロジェクト契約に整合させます。
- MCPプランナーサイドカー：ChatGPTがPRDとスプリントを書き、Codexがソースコードへの直接書き込みアクセスなしでそれらを実行できるようにします。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト