Chachamaru127/claude-code-harness

何を解決するか

Claude Code Harness は、AI コーディングエージェント（Claude Code、Cursor、Grok など）に対して、『エージェントのずれ』を防ぐための体系的なデリバリー・ループを提供します。これは、計画がチャット履歴に消え、プレッシャーの下でテストやレビューがスキップされる状況を防ぎます。オープンエンドのリクエストを、再現可能な構造化プロセスに置き換えます：仕様の作成、承認された作業スライスの実装、検証、独立したレビュー。

動作方法

このプロジェクトは、5つのコア「動詞」スキル（plan、work、review、sync、release）を通じて構造化されたワークフローを実装しています。

• 計画：意図を spec.md と Plans.md に変換し、ユーザーの承認を得ます。
• 実装：承認されたタスクを実行し、必要に応じて TDD（テスト駆動開発）を強制します。
• レビュー：実装フェーズとは独立して、結果を別途レビューします。
• 同期：実際の実装を元の計画と比較し、ずれを報告します。
• リリース：検証済みの証拠を変更履歴とリリースタグにパッケージ化します。

安全性を確保するため、Goネイティブのエンジンがすべてのツール呼び出しを実行前に判断します。これには、『ランタイムフロア』と呼ばれる仕組みがあり、シークレットの読み取りや本番環境へのデプロイなど高リスク操作を拒否します。また、mainへの直接プッシュなど、特定の操作に対してカスタマイズ可能な『ガードレール』も提供します。

対象ユーザー

AI コーディングエージェントを使用している開発者で、『エージェントにコードを書いてもらう』というスタイルから、厳格な境界と検証ゲートを持つプロフェッショナルなソフトウェアデリバリー・パイプラインへ移行したい人。

特徴

• 実行前セーフティ：実行後に検証するのではなく、リスクの高い操作が発生する前にブロックまたは警告するGoネイティブエンジン。
• 複数セッション間通信：1つのリポジトリ上で複数のエージェントセッションが通信し、レポートを共有できるロースターとメッセージングシステム。
• エンジニアでない視点：Plan Brief、進捗、承認のためのHTMLインターフェースを提供し、コードを読まなくても非技術的スポンサーが進捗を判断できるようにします。
• マルチツール対応：Claude Code、Codex CLI、Cursor、Grok との統合対応。