QuietHarness – AIコーディングエージェント向けの軽量セーフティレイヤー

概要 – QuietHarnessは、Claude Code、Codex、CursorなどのAI駆動のコーディングアシスタントに「セーフティハーネス」を追加する、小さくてポータブルな設定ファイルとヘルパースクリプトのセットです。このハーネスは、モデルを変更したり、外部サービスを呼び出したり、APIキーを必要としたりしません。代わりに、共有のCore（約1.6 KB）をインストールして、いくつかの信頼性ルールを強制します。

無関係なファイルを上書きしない – エージェントはまずリポジトリの現在の状態を確認する必要があります。
成功を宣言する前にテストを実行する。
リスクの高いアクション（例：認証情報の変更、本番環境へのデプロイ）は確認ステップとして扱う。
変更内容の具体的な証拠を記録し、後で検証できるようにする。

同じコアは、サポートされている3つのエージェントのいずれでも使用できます。インストーラーは、選択したツールに応じた適切なテンプレートファイル（例：Claude Code/Codex用のAGENTS.md、Cursor用のquiet-harness.mdc）を書き込みます。

誰が恩恵を受けるか？

すでにAIコーディングアシスタントに依存しており、ファイルの誤上書き、テストの未実行、レビューされていない破壊的な操作などの問題に遭遇した開発者。
Claude Code、Codex、Cursorを切り替えて使用し、毎回設定を作り直すことなく一貫したセキュリティチェックを求めるチーム。
ドライラン優先のワークフローを探している人。ロールバック可能です（バックアップはタイムスタンプ付きで自動的に作成されます）。

クイックスタート（分離デモ）

# リポジトリをクローンして入る
git clone https://github.com/runesleo/claude-code-workflow.git
cd claude-code-workflow

# インベントリチェックを実行（健全性チェックスクリプト）
./scripts/inventory.sh

# デモ用の一時サンドボックスを作成
DEMO=$(mktemp -d /tmp/quiet-harness-demo.XXXXXX)
./examples/first-success/setup.sh "$DEMO"

3つのエージェントのうち1つを選択し、ドライランモードでインストーラーを実行してから適用します：

# Claude Codeの例
./scripts/install.sh --dry-run --claude-project "$DEMO"
./scripts/install.sh --apply   --claude-project "$DEMO"

インストーラーは、ハーネスファイルをサンドボックスに書き込み（AGENTS.md、CLAUDE.md、またはCursorルールファイル）、何をバックアップするかを報告します。

内部での仕組み

レイヤー	内容	サイズ
共有コア	`templates/shared/AGENTS.md` – 普遍的な安全ルール	1,604 B
Claude Codeアダプター	`templates/claude/CLAUDE.md` – コアを指す薄いラッパー	168 B
Cursorルール	`templates/cursor/quiet-harness.mdc` – Markdown互換のルールファイル	546 B

選択したエージェントによって、これらのファイルのうち1つだけが読み込まれ、他は使用されません。コアは4つの動作カテゴリを定義します：

直接リクエスト実行 – エージェントは、ハーネスがリクエストを確認した後にのみ進行します。
可視性チェック – エージェントは、ファイル、Webページ、または履歴を調べたと主張する前に、明示的に読み取る必要があります。
リスクベースの検証 – ファイル変更後、ハーネスはモデルにリスクプロファイルに対して変更を検証するよう求めます。
不可逆的なアクションの確認 – 認証情報、本番環境、財務に影響を与える可能性のある操作には、明示的なユーザー確認ステップが必要です。

オプションの実験的ラボ

リポジトリには、ハーネスの拡張方法を示すいくつかのラボも含まれています：

Attention Inbox – 些細なwaiting_for_userメッセージをフィルタリングし、実際の意思決定ポイントのみを表示します。
Chat Export – Claude Code、Codex、Cursor、Grok Botのローカルチャットログを単一のMarkdown形式に正規化します。
Session Hooks – スレッドの名前変更、終了チェックリスト行の追加、保留中の決定の重複排除を促す小さなフック。
OPC Company Layer – マルチオーナー/ワーカーのハンドオフのための実験的なガバナンスレイヤー（基本ハーネスには不要）。

これらのラボはオプションで、labs/の下にあります。

インストールとロールバック

インストーラーは、既存ファイルを上書きする前にタイムスタンプ付きバックアップ（.bak-ai-workflow-*）を作成します。
--dry-runは、書き込まれる内容を正確に表示します。--applyは変更を実行します。
--undoスタイルのロールバックは、バックアップを復元し、新しく作成されたファイルを削除することで可能です（MIGRATION-v3.md#回滚を参照）。
ユーザーレベルのインストールは~/AGENTS.md（Claude）または$CODEX_HOME/AGENTS.md（Codex）に影響します。プロジェクトレベルのインストールは、--*プロジェクトで渡したターゲットディレクトリに書き込みます。

検証とテスト

./scripts/verify.shを実行すると、以下がチェックされます：

シェル構文とインストールプロセスの分離。
ドライラン、複数ターゲットの事前飛行、バックアップ、ロールバックの正しい処理。
プライベートパスやライブタスクデータの誤った漏洩がないこと。
テンプレートのサイズ制限（合計2,318 B）。
システムマップとサンプルタスクファイルの基本的なSVG/JSONの整合性。

使用する場合（および使用しない場合）

QuietHarnessを使用する場合：すでにAIコーディングアシスタントがあり、プロジェクトと一緒にバージョン管理できる軽量で再現可能なセーフティネットが必要な場合。

完全なタスクオーケストレーションプラットフォームとして使用しないでください – タスクデータベース、スケジューラー、チーム全体の調整機能は意図的に提供していません。これらは別のシステムに属します（READMEは著者の他のリポジトリを参照しています）。

ライセンス

MIT – LICENSEファイルを参照してください。

TL;DR

QuietHarnessは、Claude Code、Codex、またはCursorワークスペースにドロップインできる2 KBの設定バンドルで、アシスタントの動作をより予測可能にします：ファイルをバックアップし、テストの実行を強制し、リスクの高いアクションには明示的な確認を要求し、変更内容の具体的な証拠を記録します。単一のスクリプトでインストールし、分離されたサンドボックスで試し、必要に応じて簡単にロールバックできます。

runesleo/claude-code-workflow