harness-engineering

ハーネスエンジニアリング

ハーネスとは、プロジェクトで動作する AI エージェントのオペレーティングシステムです。モデルは CPU、コンテキストウィンドウは RAM、ハーネスは OS です。

核となる原則

まずはシンプルに始め、必要な場合にのみ複雑さを加えます。 ハーネスの各コンポーネントには、モデル単独ではできないことについての前提が組み込まれています。こうした前提を厳しく検証してください。モデルの進化とともに、前提は通用しなくなります。削除できるように作りましょう。

このスキルが有効になる条件

シグナル	アクション
空のプロジェクト／新規プロジェクト	→ プロジェクト全体をセットアップします（セクション 1）
ユーザーがエージェントに不満を感じている	→ ハーネスの不足を診断して修正します（セクション 7）
既存プロジェクトの改善が必要	→ 評価し、段階的に改善します
ハーネスに関する明示的な質問	→ 関連するセクションを参照します

ワークフロー

新規プロジェクトの場合

1. 評価 — プロジェクトの内容、技術スタック、チームの規模、エージェントの利用方法を確認します。
2. セットアップ — 基盤となるハーネスファイルを作成します → references/01-project-setup.md を読みます
3. コンテキスト — 情報アーキテクチャを設計します → references/02-context-engineering.md を読みます
4. 制約 — ガードレールとリンターを追加します → references/03-constraints.md を読みます
5. 評価 — フィードバックループを設定します → references/05-eval-feedback.md を読みます
6. プロジェクトにマルチエージェントまたは長時間タスクが含まれる場合は、references/04-multi-agent.md と references/06-long-running.md を読みます
7. エージェントを無人で実行する場合（スケジュールされたタスク、CI ループ）は references/08-loops.md を読みます。セッションをまたいでエージェントに学習させる場合は references/09-memory.md を読みます

診断の場合（エージェントのパフォーマンスが低い）

1. すぐに references/07-diagnosis.md を読みます
2. どのハーネスレイヤーに問題があるかを特定します
3. 該当するリファレンスから、対象を絞った修正を適用します

段階的な改善の場合

現在のハーネスの成熟度を評価し、最も弱いレイヤーを特定して、一度に 1 つのレイヤーを改善します。

ハーネスレイヤー（クイックリファレンス）

レイヤー	内容	リファレンス
プロジェクトのセットアップ	AGENTS.md、docs/、ディレクトリの規約	01-project-setup.md
コンテキストエンジニアリング	エージェントに表示する情報、段階的な開示、作業状態	02-context-engineering.md
制約とガードレール	リンター、型システム、アーキテクチャの適用、安全な自律性	03-constraints.md
マルチエージェントアーキテクチャ	エージェントの分離、調整プロトコル、委任パターン	04-multi-agent.md
評価とフィードバック	テスト、評価、GC エージェント、可観測性	05-eval-feedback.md
長時間タスク	進捗の追跡、コンテキストのリセット、引き継ぎ用成果物	06-long-running.md
ループ	検証器、停止条件、ガードレール、自律動作	08-loops.md
メモリ	セッションをまたぐメモリ、索引してから取得する方式、統合、忘却	09-memory.md
診断	エージェントが失敗した場合 — モデルではなくハーネスに原因がないか特定します	07-diagnosis.md

自己更新プロトコル

プロジェクト中に新たな再利用可能なハーネスパターンを見つけた場合：

1. どのリファレンスファイルに属するか（または新しいファイルが必要か）を特定します
2. 次の内容を含めてパターンを追加します。何を解決するか、いつ使うか、どのように実装するか
3. 簡潔に保ちます。無駄を省き、パターンだけを記述します