Claude Code - Codex ユーザーのための誰でもわかるHarness Engineeringベストプラクティス

## 概要本記事は、AIコーディングエージェントが自律的かつ信頼性高く動作できる環境（ツール、テスト、ルール）の設計を「[[Harness engineering Leveraging Codex in an agent-first world|Harness Engineering]]」と定義している。「コードを書くこと」から「確定的なフィードバックループを通じてエージェントが正しいコードを生成できるハーネスを設計すること」へパラダイムが移行していることを解説する。 ## 目次 1. [Harness Engineeringとは何か](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#harness-engineering%E3%81%A8%E3%81%AF%E4%BD%95%E3%81%8B) - [定義を辿る](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E5%AE%9A%E7%BE%A9%E3%82%92%E8%BE%BF%E3%82%8B) - [この分野の寿命について](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%81%93%E3%81%AE%E5%88%86%E9%87%8E%E3%81%AE%E5%AF%BF%E5%91%BD%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6) - [ハーネスへの投資は複利で効く](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%8F%E3%83%BC%E3%83%8D%E3%82%B9%E3%81%B8%E3%81%AE%E6%8A%95%E8%B3%87%E3%81%AF%E8%A4%87%E5%88%A9%E3%81%A7%E5%8A%B9%E3%81%8F) 2. [1: リポジトリ衛生: 腐敗を前提に設計する](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#1%3A-%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E8%A1%9B%E7%94%9F%3A-%E8%85%90%E6%95%97%E3%82%92%E5%89%8D%E6%8F%90%E3%81%AB%E8%A8%AD%E8%A8%88%E3%81%99%E3%82%8B) - [置くべきもの](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E7%BD%AE%E3%81%8F%E3%81%B9%E3%81%8D%E3%82%82%E3%81%AE) - [置くべきでないもの](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E7%BD%AE%E3%81%8F%E3%81%B9%E3%81%8D%E3%81%A7%E3%81%AA%E3%81%84%E3%82%82%E3%81%AE) - [リポジトリの衛生管理](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E3%81%AE%E8%A1%9B%E7%94%9F%E7%AE%A1%E7%90%86) - [テストはドキュメントより腐敗に強い](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%86%E3%82%B9%E3%83%88%E3%81%AF%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%82%88%E3%82%8A%E8%85%90%E6%95%97%E3%81%AB%E5%BC%B7%E3%81%84) - [ADRで決定の履歴を保全する](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#adr%E3%81%A7%E6%B1%BA%E5%AE%9A%E3%81%AE%E5%B1%A5%E6%AD%B4%E3%82%92%E4%BF%9D%E5%85%A8%E3%81%99%E3%82%8B) - [現実的な解を追い求める](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E7%8F%BE%E5%AE%9F%E7%9A%84%E3%81%AA%E8%A7%A3%E3%82%92%E8%BF%BD%E3%81%84%E6%B1%82%E3%82%81%E3%82%8B) 3. [2: 決定論的ツールとアーキテクチャガードレールで品質を強制する](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#2%3A-%E6%B1%BA%E5%AE%9A%E8%AB%96%E7%9A%84%E3%83%84%E3%83%BC%E3%83%AB%E3%81%A8%E3%82%A2%E3%83%BC%E3%82%AD%E3%83%86%E3%82%AF%E3%83%81%E3%83%A3%E3%82%AC%E3%83%BC%E3%83%89%E3%83%AC%E3%83%BC%E3%83%AB%E3%81%A7%E5%93%81%E8%B3%AA%E3%82%92%E5%BC%B7%E5%88%B6%E3%81%99%E3%82%8B) - [リンターの仕事をLLMにさせない](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%AA%E3%83%B3%E3%82%BF%E3%83%BC%E3%81%AE%E4%BB%95%E4%BA%8B%E3%82%92llm%E3%81%AB%E3%81%95%E3%81%9B%E3%81%AA%E3%81%84) - [フィードバックループの設計: Hooksの活用](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%89%E3%83%90%E3%83%83%E3%82%AF%E3%83%AB%E3%83%BC%E3%83%97%E3%81%AE%E8%A8%AD%E8%A8%88%3A-hooks%E3%81%AE%E6%B4%BB%E7%94%A8) - [4つのHookパターン](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#4%E3%81%A4%E3%81%AEhook%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3) - [実装例: PostToolUseによる自動リント(2026年推奨構成)](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E5%AE%9F%E8%A3%85%E4%BE%8B%3A-posttooluse%E3%81%AB%E3%82%88%E3%82%8B%E8%87%AA%E5%8B%95%E3%83%AA%E3%83%B3%E3%83%88\(2026%E5%B9%B4%E6%8E%A8%E5%A5%A8%E6%A7%8B%E6%88%90\)) - [Planktonパターン(高度)](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#plankton%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3\(%E9%AB%98%E5%BA%A6\)) - [言語別リンター選定ガイド(2026年3月)](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E8%A8%80%E8%AA%9E%E5%88%A5%E3%83%AA%E3%83%B3%E3%82%BF%E3%83%BC%E9%81%B8%E5%AE%9A%E3%82%AC%E3%82%A4%E3%83%89\(2026%E5%B9%B43%E6%9C%88\)) - [カスタムリンター戦略: エージェント向けルールの設計](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%A0%E3%83%AA%E3%83%B3%E3%82%BF%E3%83%BC%E6%88%A6%E7%95%A5%3A-%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E5%90%91%E3%81%91%E3%83%AB%E3%83%BC%E3%83%AB%E3%81%AE%E8%A8%AD%E8%A8%88) - [エラーメッセージを修正指示にする](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%82%A8%E3%83%A9%E3%83%BC%E3%83%A1%E3%83%83%E3%82%BB%E3%83%BC%E3%82%B8%E3%82%92%E4%BF%AE%E6%AD%A3%E6%8C%87%E7%A4%BA%E3%81%AB%E3%81%99%E3%82%8B) - [プリコミットフックで即時フィードバックを提供する](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%97%E3%83%AA%E3%82%B3%E3%83%9F%E3%83%83%E3%83%88%E3%83%95%E3%83%83%E3%82%AF%E3%81%A7%E5%8D%B3%E6%99%82%E3%83%95%E3%82%A3%E3%83%BC%E3%83%89%E3%83%90%E3%83%83%E3%82%AF%E3%82%92%E6%8F%90%E4%BE%9B%E3%81%99%E3%82%8B) - [ADRと実行可能ルールを結合する](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#adr%E3%81%A8%E5%AE%9F%E8%A1%8C%E5%8F%AF%E8%83%BD%E3%83%AB%E3%83%BC%E3%83%AB%E3%82%92%E7%B5%90%E5%90%88%E3%81%99%E3%82%8B) - [リンター設定保護: エージェントの「ルール改竄」を防ぐ](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%AA%E3%83%B3%E3%82%BF%E3%83%BC%E8%A8%AD%E5%AE%9A%E4%BF%9D%E8%AD%B7%3A-%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%81%AE%E3%80%8C%E3%83%AB%E3%83%BC%E3%83%AB%E6%94%B9%E7%AB%84%E3%80%8D%E3%82%92%E9%98%B2%E3%81%90) - [AI生成コード固有のリントアンチパターン](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#ai%E7%94%9F%E6%88%90%E3%82%B3%E3%83%BC%E3%83%89%E5%9B%BA%E6%9C%89%E3%81%AE%E3%83%AA%E3%83%B3%E3%83%88%E3%82%A2%E3%83%B3%E3%83%81%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3) - [言語別推奨リンタースタック](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E8%A8%80%E8%AA%9E%E5%88%A5%E6%8E%A8%E5%A5%A8%E3%83%AA%E3%83%B3%E3%82%BF%E3%83%BC%E3%82%B9%E3%82%BF%E3%83%83%E3%82%AF) - [フィードバックの速度が品質を決定する](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%89%E3%83%90%E3%83%83%E3%82%AF%E3%81%AE%E9%80%9F%E5%BA%A6%E3%81%8C%E5%93%81%E8%B3%AA%E3%82%92%E6%B1%BA%E5%AE%9A%E3%81%99%E3%82%8B) - [アーキテクチャをガードレールにする](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%82%A2%E3%83%BC%E3%82%AD%E3%83%86%E3%82%AF%E3%83%81%E3%83%A3%E3%82%92%E3%82%AC%E3%83%BC%E3%83%89%E3%83%AC%E3%83%BC%E3%83%AB%E3%81%AB%E3%81%99%E3%82%8B) 4. [3: AGENTS.md / CLAUDE.mdをポインタとして設計する](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#3%3A-agents.md-%2F-claude.md%E3%82%92%E3%83%9D%E3%82%A4%E3%83%B3%E3%82%BF%E3%81%A8%E3%81%97%E3%81%A6%E8%A8%AD%E8%A8%88%E3%81%99%E3%82%8B) - [書くべきもの](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E6%9B%B8%E3%81%8F%E3%81%B9%E3%81%8D%E3%82%82%E3%81%AE) - [書くべきでないもの](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E6%9B%B8%E3%81%8F%E3%81%B9%E3%81%8D%E3%81%A7%E3%81%AA%E3%81%84%E3%82%82%E3%81%AE) - [サイズの目安](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%82%B5%E3%82%A4%E3%82%BA%E3%81%AE%E7%9B%AE%E5%AE%89) - [ポインタが腐敗した場合](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%9D%E3%82%A4%E3%83%B3%E3%82%BF%E3%81%8C%E8%85%90%E6%95%97%E3%81%97%E3%81%9F%E5%A0%B4%E5%90%88) 5. [4: 計画と実行を分離する](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#4%3A-%E8%A8%88%E7%94%BB%E3%81%A8%E5%AE%9F%E8%A1%8C%E3%82%92%E5%88%86%E9%9B%A2%E3%81%99%E3%82%8B) - [計画フェーズ](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E8%A8%88%E7%94%BB%E3%83%95%E3%82%A7%E3%83%BC%E3%82%BA) - [タスクの粒度](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%82%BF%E3%82%B9%E3%82%AF%E3%81%AE%E7%B2%92%E5%BA%A6) - [テストによる完了の検証](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%86%E3%82%B9%E3%83%88%E3%81%AB%E3%82%88%E3%82%8B%E5%AE%8C%E4%BA%86%E3%81%AE%E6%A4%9C%E8%A8%BC) 6. [5: E2Eテスト戦略: エージェントにあらゆるアプリの「目」を与える](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#5%3A-e2e%E3%83%86%E3%82%B9%E3%83%88%E6%88%A6%E7%95%A5%3A-%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%81%AB%E3%81%82%E3%82%89%E3%82%86%E3%82%8B%E3%82%A2%E3%83%97%E3%83%AA%E3%81%AE%E3%80%8C%E7%9B%AE%E3%80%8D%E3%82%92%E4%B8%8E%E3%81%88%E3%82%8B) - [Webアプリ: ツール比較(3つのアプローチ)](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#web%E3%82%A2%E3%83%97%E3%83%AA%3A-%E3%83%84%E3%83%BC%E3%83%AB%E6%AF%94%E8%BC%83\(3%E3%81%A4%E3%81%AE%E3%82%A2%E3%83%97%E3%83%AD%E3%83%BC%E3%83%81\)) - [普遍的原則: アクセシビリティツリーはユニバーサルインターフェース](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E6%99%AE%E9%81%8D%E7%9A%84%E5%8E%9F%E5%89%87%3A-%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B7%E3%83%93%E3%83%AA%E3%83%86%E3%82%A3%E3%83%84%E3%83%AA%E3%83%BC%E3%81%AF%E3%83%A6%E3%83%8B%E3%83%90%E3%83%BC%E3%82%B5%E3%83%AB%E3%82%A4%E3%83%B3%E3%82%BF%E3%83%BC%E3%83%95%E3%82%A7%E3%83%BC%E3%82%B9) - [アクセシビリティツリー vs スクリーンショット: 使い分け](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B7%E3%83%93%E3%83%AA%E3%83%86%E3%82%A3%E3%83%84%E3%83%AA%E3%83%BC-vs-%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88%3A-%E4%BD%BF%E3%81%84%E5%88%86%E3%81%91) - [モバイルアプリE2Eテスト](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%A2%E3%83%90%E3%82%A4%E3%83%AB%E3%82%A2%E3%83%97%E3%83%AAe2e%E3%83%86%E3%82%B9%E3%83%88) - [CLI/TUIアプリケーションE2Eテスト](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#cli%2Ftui%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3e2e%E3%83%86%E3%82%B9%E3%83%88) - [API/バックエンドE2Eテスト](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#api%2F%E3%83%90%E3%83%83%E3%82%AF%E3%82%A8%E3%83%B3%E3%83%89e2e%E3%83%86%E3%82%B9%E3%83%88) - [デスクトップアプリE2Eテスト](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%87%E3%82%B9%E3%82%AF%E3%83%88%E3%83%83%E3%83%97%E3%82%A2%E3%83%97%E3%83%AAe2e%E3%83%86%E3%82%B9%E3%83%88) - [インフラストラクチャ/DevOps E2Eテスト](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%82%A4%E3%83%B3%E3%83%95%E3%83%A9%E3%82%B9%E3%83%88%E3%83%A9%E3%82%AF%E3%83%81%E3%83%A3%2Fdevops-e2e%E3%83%86%E3%82%B9%E3%83%88) - [AI/MLパイプラインE2Eテスト](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#ai%2Fml%E3%83%91%E3%82%A4%E3%83%97%E3%83%A9%E3%82%A4%E3%83%B3e2e%E3%83%86%E3%82%B9%E3%83%88) - [ユニバーサルE2E原則のまとめ](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%A6%E3%83%8B%E3%83%90%E3%83%BC%E3%82%B5%E3%83%ABe2e%E5%8E%9F%E5%89%87%E3%81%AE%E3%81%BE%E3%81%A8%E3%82%81) - [アニメーション・トランジションの検証戦略](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%82%A2%E3%83%8B%E3%83%A1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%83%BB%E3%83%88%E3%83%A9%E3%83%B3%E3%82%B8%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AE%E6%A4%9C%E8%A8%BC%E6%88%A6%E7%95%A5) 7. [6: セッション間の状態管理を設計する](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#6%3A-%E3%82%BB%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E9%96%93%E3%81%AE%E7%8A%B6%E6%85%8B%E7%AE%A1%E7%90%86%E3%82%92%E8%A8%AD%E8%A8%88%E3%81%99%E3%82%8B) - [問題の構造](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E5%95%8F%E9%A1%8C%E3%81%AE%E6%A7%8B%E9%80%A0) - [起動ルーチンを標準化する](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E8%B5%B7%E5%8B%95%E3%83%AB%E3%83%BC%E3%83%81%E3%83%B3%E3%82%92%E6%A8%99%E6%BA%96%E5%8C%96%E3%81%99%E3%82%8B) - [Gitをセッション間のブリッジとして使う](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#git%E3%82%92%E3%82%BB%E3%83%83%E3%82%B7%E3%83%A7%E3%83%B3%E9%96%93%E3%81%AE%E3%83%96%E3%83%AA%E3%83%83%E3%82%B8%E3%81%A8%E3%81%97%E3%81%A6%E4%BD%BF%E3%81%86) - [進捗記録にJSONを使う](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E9%80%B2%E6%8D%97%E8%A8%98%E9%8C%B2%E3%81%ABjson%E3%82%92%E4%BD%BF%E3%81%86) 8. [7: プラットフォーム固有のハーネス戦略を理解する: Codex vs Claude Code](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#7%3A-%E3%83%97%E3%83%A9%E3%83%83%E3%83%88%E3%83%95%E3%82%A9%E3%83%BC%E3%83%A0%E5%9B%BA%E6%9C%89%E3%81%AE%E3%83%8F%E3%83%BC%E3%83%8D%E3%82%B9%E6%88%A6%E7%95%A5%E3%82%92%E7%90%86%E8%A7%A3%E3%81%99%E3%82%8B%3A-codex-vs-claude-code) - [ハーネスがモデルより重要](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%8F%E3%83%BC%E3%83%8D%E3%82%B9%E3%81%8C%E3%83%A2%E3%83%87%E3%83%AB%E3%82%88%E3%82%8A%E9%87%8D%E8%A6%81) - [アーキテクチャの根本的違い](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%82%A2%E3%83%BC%E3%82%AD%E3%83%86%E3%82%AF%E3%83%81%E3%83%A3%E3%81%AE%E6%A0%B9%E6%9C%AC%E7%9A%84%E9%81%95%E3%81%84) - [Codex固有のハーネス機能](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#codex%E5%9B%BA%E6%9C%89%E3%81%AE%E3%83%8F%E3%83%BC%E3%83%8D%E3%82%B9%E6%A9%9F%E8%83%BD) - [Claude Code固有のハーネス機能](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#claude-code%E5%9B%BA%E6%9C%89%E3%81%AE%E3%83%8F%E3%83%BC%E3%83%8D%E3%82%B9%E6%A9%9F%E8%83%BD) - [両方で可能だがアプローチが異なるもの](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E4%B8%A1%E6%96%B9%E3%81%A7%E5%8F%AF%E8%83%BD%E3%81%A0%E3%81%8C%E3%82%A2%E3%83%97%E3%83%AD%E3%83%BC%E3%83%81%E3%81%8C%E7%95%B0%E3%81%AA%E3%82%8B%E3%82%82%E3%81%AE) - [ハイブリッド戦略: 計画はClaude Code、実行はCodex](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%8F%E3%82%A4%E3%83%96%E3%83%AA%E3%83%83%E3%83%89%E6%88%A6%E7%95%A5%3A-%E8%A8%88%E7%94%BB%E3%81%AFclaude-code%E3%80%81%E5%AE%9F%E8%A1%8C%E3%81%AFcodex) - [意思決定フレームワーク](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E6%84%8F%E6%80%9D%E6%B1%BA%E5%AE%9A%E3%83%95%E3%83%AC%E3%83%BC%E3%83%A0%E3%83%AF%E3%83%BC%E3%82%AF) 9. [アンチパターン](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%82%A2%E3%83%B3%E3%83%81%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3) 10. [最小実行可能ハーネス(MVH: Minimum Viable Harness)](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E6%9C%80%E5%B0%8F%E5%AE%9F%E8%A1%8C%E5%8F%AF%E8%83%BD%E3%83%8F%E3%83%BC%E3%83%8D%E3%82%B9\(mvh%3A-minimum-viable-harness\)) - [Week 1](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#week-1) - [Week 2-4](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#week-2-4) - [Month 2-3](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#month-2-3) - [Month 3+](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#month-3%2B) 11. [まとめ](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%81%BE%E3%81%A8%E3%82%81-1) 12. [References](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#references) - [一次ソース](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E4%B8%80%E6%AC%A1%E3%82%BD%E3%83%BC%E3%82%B9) - [Claude Code / Codex](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#claude-code-%2F-codex) - [リンターツール](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%83%AA%E3%83%B3%E3%82%BF%E3%83%BC%E3%83%84%E3%83%BC%E3%83%AB) - [E2Eテスト](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#e2e%E3%83%86%E3%82%B9%E3%83%88) - [インフラ / DevOps](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%82%A4%E3%83%B3%E3%83%95%E3%83%A9-%2F-devops) - [AI/ML](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#ai%2Fml) - [その他](https://nyosegawa.github.io/posts/harness-engineering-best-practices-2026/#%E3%81%9D%E3%81%AE%E4%BB%96) ## ベストプラクティス - **リポジトリの衛生管理 (Repository Hygiene)** - エージェントが古いドキュメントに従うのを防ぐため、実行可能な成果物（コード、テスト、ADR）のみを「真実」として扱う。 - **確定的な品質 (Deterministic Quality)** - Oxlint、Biome、Ruffなどの超高速な[[Rust]]ベースのリンターをHooksとして使用する。 - エージェントの自己修正のために即座かつ機械可読なフィードバックを提供する。 - **ポインタベースの設計 (Pointer-based Design)** - `CLAUDE.md`や`AGENTS.md`は50行以内に収める。 - 冗長な指示よりも特定のルールやツールへのポインタとして活用する。 - **E2E検証 (E2E Verification)** - Playwright CLIやagent-browserなどのツールを使用してエージェントに「目」を持たせる。 - アクセシビリティツリーやスクリーンショットを通じてUIの変更を検証させる。 - **セッション管理 (Session Management)** - 起動ルーチンを標準化する。 - Gitをブリッジとして使用し、複数のエージェントセッション間で状態とコンテキストを維持する。