2026.11.07 SAT16:11 JSTOSS
OSS5事例のAIハーネス設計比較
今日試せる設計思想・サンプル公開中
AIに任せる範囲や失敗を防ぐ仕組みを、有名開発プロジェクトがどう分けているかを整理した実例です。
- ZedやBunなど5つのOSSから、AIエージェントの制御設計思想が比較整理された。
- AIへの信頼度に応じ、罠の列挙・索引化・実行前フック・CI強制など設計が分岐する。
- 5つの設計の長所を組み合わせたサンプルハーネスもGitHubで公開されている。
目線
自前エージェントの指示ファイルが肥大化している場合、Zed型の罠列挙やSentry型の索引分離へ再設計する判断材料になる。
対象
Claude CodeやAGENTS.mdを使って開発を自動化しているエンジニア
使える場面
- 肥大化した指示ファイルを索引と個別の作業手順に分割する
- 繰り返すコマンドミスを指示文ではなく実行前フックで機械的に防ぐ
試すなら
公開されたサンプルハーネスを参考に自リポジトリのルールを見直す
確認点
AIへの信頼度やプロジェクト規模・文化によって最適な制御レベルは異なる
背景
コーディングエージェント向け指示ファイル（AGENTS.md等）の肥大化や制御方針について、有名OSSの実装を比較分析したレポートが公開された。
何が変わったか
- Zedは構造説明を省き、AIがよく踏む罠の列挙に絞ってAIの判断力を信頼する方針を採用
- SentryはルートのAGENTS.mdを60行未満の索引にとどめ、詳細は領域ごとのファイルとスキルに分散
- Bunは設定ファイルとフックで誤コマンドを止め、PostHogはリンターやCIを最優先にして文章指示を最後の手段とする
使える場面・影響
指示文の追加だけでAIを制御しようとせず、索引化や機械的ガードを組み合わせる設計選択肢が具体化された。
試す前に確認
- 公開サンプルの利用条件はGitHub上で確認可能
一次ソース
- Gibberish Lab Bloggibberishlab.com
- @xjuntaro (X)x.com