01
コンテキストアセンブリ
ハーネスエンジニアリングは、どのファイル、ルール、履歴、言語設定、外部ツール指示をモデルのコンテキストに入れるかを決定します。すべてをひとつのプロンプトに詰め込むのではなく、これがハーネスエンジニアリングの第一の境界です。
プロダクションAIフィールド提供
AI FDEフィールドエンジニアリング
信頼性の高いAI提供を支えるシステムと判断力を深く掘り下げます。FDE Engineerが顧客発見、エージェントハーネス設計、ツール、権限、記憶、評価、プロダクション展開、導入をどのように結びつけるかを学び、AI FDEフィールドメンターと共に実際の展開計画に挑戦します。
コンテキストアセンブリツール契約権限ポリシー
コアモデル
ハーネスエンジニアリングの5層構造
信頼できるエージェントはモデルだけでは実現できません。ハーネスエンジニアリングは、意図、コンテキスト、ツール、権限、記憶、実行、検証を観察可能なエンジニアリング層に分解し、モデルの推測を減らし、製品の説明力を高めます。
02
ツール契約
ハーネスエンジニアリングにおいて、ツールは管理された製品APIです。入力スキーマ、出力予算、同時実行マーカー、読み取り専用マーカー、失敗時の動作が定義されています。ツール契約なしに安定したハーネスエンジニアリングはありません。
03
権限ポリシー
ハーネスエンジニアリングは、許可、確認、拒否、リスク説明を構造化された判断に変換します。モデルが慎重に行動することを信頼するのではなく、権限層がハーネスエンジニアリングの信頼境界となります。
04
記憶とスキル
ハーネスエンジニアリングは、永続的なルール、プロジェクトの記憶、ドメインスキルを関連する場合にのみ読み込みます。プロンプトの肥大化を抑えつつ、ソースの追跡可能性を維持します。優れたハーネスエンジニアリングは記憶を伝聞にしません。
05
実行ループ
長時間のタスクには、計画、ツール呼び出し、ストリーミングフィードバック、圧縮、回復、検証エビデンスのループが必要です。ハーネスエンジニアリングはこの実行チェーンに焦点を当てており、単発のQ&Aとは異なります。
ソース付きノート
Claude Codeソースから学ぶハーネスエンジニアリング
Claude Codeの主要なソースパスを読み解き、再利用可能な6つのハーネスエンジニアリング設計ポイントを抽出しました。これらは抽象的なスローガンではなく、ソースコードに現れるエンジニアリングの境界です。
constants/prompts.ts
プロンプトはコンテキストパイプライン
ソースコードは、静的セクション、動的セクション、メモリ、環境情報、言語設定、MCP指示、キャッシュ境界を分離しています。ハーネスエンジニアリングは、プロンプトテキストをキャッシュ可能で無効化可能、説明可能なコンテキストパイプラインに変換します。これがハーネスエンジニアリングの核心的な入り口です。
Tool.ts + tools.ts
ツールは製品級API
ツールインターフェースは、call、description、schema、isReadOnly、isConcurrencySafe、isDestructive、checkPermissionsを保持します。ハーネスエンジニアリングは、モデルの能力が実際の世界に影響を与える前に、それをレビュー可能にします。
types/permissions.ts
権限を判断材料にする
権限タイプは、default、plan、acceptEdits、dontAsk、bypassPermissionsといったモードと、allow、ask、deny、passthroughの結果を分離します。Harness Engineeringは、権限の理由と次のアクションを提示します。
skills/loadSkillsDir.ts
Skillsで段階的に開示する
Skillsはまずfrontmatterで見積もりとルーティングを行い、タスクが一致した場合のみ完全な指示を読み込みます。Harness Engineeringにより、ドメイン知識を発見可能にしつつ、毎回のやり取りを肥大化させません。
services/mcp/config.ts
MCPとプラグインにはガバナンスが必要
MCP設定はサーバーシグネチャを計算し、プラグインサーバーを重複排除し、無効化またはポリシーフィルターされたサーバーを処理します。Harness Engineeringは、外部機能をエージェントに公開する前にガバナンスを適用します。
query.ts
長時間の作業にはコンテキストのライフサイクル管理が必要
モデル呼び出しの前に、query.tsがツール結果の予算、スニップ、マイクロコンパクト、コンテキストコラプス、オートコンパクトを適用します。Harness Engineeringは単なる大きなコンテキストウィンドウではなく、コンテキストのライフサイクル管理です。
学習ドキュメント
Harness Engineeringを学ぶ理由
プロンプトエンジニアリングは「モデルに何を伝えるか」を問います。Harness Engineeringは「モデルをどのようなシステムで動作させるか」を問います。エージェントが実際のコード、権限、デプロイ、チームワークフローを扱う場合、プロンプトのテキストだけでは信頼性を保証できません。
Claude Codeのソースコードは、Harness Engineeringが安定したルールを静的なプロンプトセクションに、変動する情報を動的なセクションに配置し、ファイル読み取り、編集、検索、MCP、Skills、サブタスクを管理されたツール契約に組み込む方法を示しています。
Harness Engineeringを学ぶ目的はClaude Codeを複製することではありません。AI製品をコンテキスト、ツール、権限、メモリ、ループ、検証、UXに分解することです。このパターンは、サポートエージェント、データエージェント、コンテンツエージェント、コーディングエージェントに応用できます。
Harness Engineering学習ロードマップ
1
ソースコードの境界を読む
prompts、Tool、permissions、skills、mcp、queryファイルから始め、Harness Engineeringが実行時の境界をどこに設定しているかを理解します。
2
実行モデルを図示する
エージェントの1回の会話を、intent、context、tool、permission、result、compact、verifyの流れとしてマッピングします。
3
最小限のハーネスを作る
3つの狭いツール、1つの権限判断オブジェクト、1つのメモリローダー、1つの検証ステップを実装し、Harness Engineeringがモデルの自由度をどのように減らすかを体験します。
4
証拠に基づいて評価する
応答の良し悪しだけで判断せず、ツールログ、復旧動作、権限の説明、テスト結果、ユーザーが何が起こったかを理解できるかを確認します。
AIチューター
本番AI導入計画に挑戦する
こんにちは。私はAI FDEフィールドメンターです。顧客の問題、スコープ、アーキテクチャ、プロトタイプ、評価、セキュリティレビュー、展開計画、導入リスクをお聞かせください。事実と仮定を整理し、トレードオフを明確にし、次の成果物を提案します。
FAQ
Harness Engineeringよくある質問
これらの質問は、Harness Engineeringとプロンプト、エージェントフレームワーク、Claude Codeソース学習の関係を明確にします。
Harness Engineeringとは？
Harness Engineeringは、モデルを中心とした実行環境を構築するエンジニアリングプラクティスです。コンテキストアセンブリ、ツール契約、権限ポリシー、メモリ、状態、オーケストレーションループ、検証、可観測性、プロダクトUXを含みます。
Harness Engineeringとプロンプトエンジニアリングの違いは？
プロンプトエンジニアリングはモデルが受け取るテキストを最適化します。Harness Engineeringはモデルが動作するシステムを設計します。前者は指示の表現方法を問い、後者はエージェントが現実世界で確実に動作する方法を問います。
なぜClaude CodeでHarness Engineeringを学ぶのですか？
Claude Codeは実際のコーディングエージェントであり、そのソースコードはプロンプトパイプライン、ツール、権限、MCP、Skills、メモリ、長期タスク圧縮を示しており、Harness Engineeringの優れたケーススタディです。
AIソースチューターは何を教えてくれますか？
チューターはHarness Engineeringの観点からソースファイルを説明したり、ツールと権限の設計を比較したり、Claude Codeのパターンを独自のエージェント製品計画に抽象化したりできます。
チームはいつHarness Engineeringを必要としますか？
エージェントが実際のシステムを読み書きしたり、外部ツールを呼び出したり、永続的なルールを記憶したり、承認を求めたり、単なる親切な回答ではなく検証可能な結果を提供する必要がある場合、チームはHarness Engineeringを必要とします。