Chachamaru127/claude-code-harness

Claude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle

Claude Code Harness – 決断的なAI駆動開発ループ

何であるか – Claude Code（および同様のエージェント、例：Codex、Cursor、Grok）が、計画、実装、レビュー、同期、リリースの全ソフトウェア開発サイクルを担当できるGoネイティブプラグインです。高レベルの意図（例：「READMEのオンボーディングフローを改善する」）を提示するだけで、ハーネスは具体的な仕様（spec.md、Plans.md）に変換し、選択されたAIモデルでコードを生成、出力を検証し、最終的にクリーンなリリースをパッケージ化します。各ステップは明示的な人間の承認によって制御されるため、完全自律的なコーダーではなく、安全を最優先としたオーケストレーション層です。

コアコンセプトとワークフロー

ステップ	コマンド	機能	人間の承認
計画	`/harness‑plan <意図>`	仕様（`spec.md`）とタスクリスト（`Plans.md`）を生成。範囲、受容基準、依存関係、未知要因、停止条件を記述。	コード生成前に、生成された契約を承認または編集する必要があります。
作業	`/harness‑work [タスク	all]`	承認されたタスクを適切なモデル（通常作業にはClaude Sonnet 5、高スループットの「Breezing」にはGPT‑5.6 Lunaなど）で実行。単独またはチームでの実行を処理し、必要なテストを実行し、設定可能な修正回数まで反復します。
レビュー	`/harness‑review`	別のレビューモデル（Claude Sonnet 5、xhigh効率）を実行し、変更内容を検査、追加検証を実施、主要な発見を報告します。	完了をブロックする発見は、次のステップに進む前に解決する必要があります。
同期	`/harness‑sync`	現在のリポジトリ状態と元の計画を比較し、ズレをマーク、計画ステータスを更新します。	必要な再計画を確認する必要があります。
リリース	`/harness‑release`	検証済みの変更を変更履歴にパッケージ化、gitタグを作成、リリースを公開します。	プレフライトチェックリストが通過しなければ、リリースは中止されます。

ループは /harness‑loop で自動的に繰り返され、work-review-sync を繰り返し、停止条件（例：最大サイクル数、実行可能なタスクなし）に達するまで続きます。

セーフティとガードレール

二層の保護 – 軽量なGoエンジンが実行時フロア（5カテゴリ：課金、ネットワーク出力、シークレット読み取り、本番デプロイ、破壊的操作）を強制し、より豊富なガードレール（R01–R16）が危険な操作に対して拒否、警告、または確認を要求します。
明示的な承認 – mainへのプッシュや保護されたパスへの書き込みなど、事前承認が必要な操作は、計画時時点で有効期限、範囲、使用制限とともに記録されます。
未知の扱い – モデルが見たことのないデータは unknown としてマークされ、無意識の幻覚を防ぎます。
セッションロスター – 複数のエージェントが同じリポジトリで作業する場合、ローカルのロスターがアクティブなセッションを表示し、検証済みのメッセージ交換を可能にし、オプションでコンテンツ検証を提供します。
非エンジニア向けビュー – 3つの単一ページHTMLダッシュボード（計画概要、進捗、受容）により、コードを読まなくてもステークホルダーが作業をレビューできます。

インストール（30秒）

# Claude Code（または任意の対応ホスト内から）
claude /plugin marketplace add Chachamaru127/claude-code-harness
/plugin install claude-code-harness@claude-code-harness-marketplace
/harness-setup

他のホスト（Codex CLI、Cursor、Grok）については、READMEの「ツール別インストール」表を参照してください。各ツールは、プラグインを追加し、/harness‑setup を実行する小さなシェルスクリプトを提供しています。

一般的な使用例

意図の定義 – /harness‑plan "重複注文を修正；同じ注文は一度だけ保存されるべきです。"
仕様の承認 – spec.md/Plans.md をレビューし、受容基準を確認。
実装の実行 – /harness‑work all（または /harness‑work 3 で単一タスクを指定）。
自動テストと修正 – モデルがテストを実行し、失敗を報告し、設定された修正回数まで反復します。
独立したレビュー – /harness‑review が別途監査を生成；主要な発見はリリースをブロックします。
同期とリリース – /harness‑sync で計画と現実が一致しているか確認後、/harness‑release でタグ付きリリースと生成された変更履歴を作成します。

モデルルーティングと効率レベル

役割	デフォルトモデル	効率
困難な意思決定／助言	Claude Fable 5.1	high
通常の実装	Claude Sonnet 5	medium
専用レビュアー	Claude Sonnet 5	xhigh
Codex作業およびレビュー	GPT‑6 astra / GPT‑5.6 luna	xhigh / max

任意の役割や効率を手動で上書き可能。ツールは明示的な選択を尊重します。

プロジェクト状態とコミュニティ

ライセンス – MIT
対応ホスト – Claude Code（v2.1+）、Codex CLI、Cursor、Grok（すべて対応済み）。他のツールは候補または将来としてリストされています。
ドキュメント – オンボーディング、インストール経路、セーフティの同等性、モデルポリシー、高度な機能（Breezing、harness‑loop、harness‑memなど）をカバーする包括的なドキュメント。
貢献 – 問題とPRを歓迎；CONTRIBUTING.md を参照してください。

TL;DR

Claude Code Harnessは、人間のレビューで各主要ステップを制御する安全最優先のオーケストレーションプラグインです。Claudeベースのエージェント（または互換性のあるLLM）を使って、リポジトリ内の変更を計画、コード化、検証、リリースするプロセスを可能にします。明確で繰り返し可能なループ、強力なガードレール、マルチツール対応により、AI補助開発を強力かつ制御可能なものにします。