TRAID Agent Kit v4.0 — AI開発の手戻りを止める19体のエージェント定義キット

AIにコードを書かせたあと、同じAIにレビューを頼むと、こう返ってきます。

「実装を確認しました。全体として仕様を満たしており、大きな問題は見当たりません。」

読んだ瞬間に、何も検査されていないことが分かります。

これはモデルの能力の問題ではありません。実装した直後の会話の中には、実装者の意図も「ここは後で直す」という前提も全部残っています。その文脈にいるAIは、数分前に自分が決めた設計を否定できません。人間でも無理です。

TRAID（試錬統合駆動開発）は、この問題を工程の分離で解く開発方法論と、その実行キットです。

仕様を書く者、テストを書く者、実装する者、それを疑う者を、19体の別々の人格として分けてあります。Claude Code / Claude アプリ / Cursor の3環境に、導入スクリプト1コマンドで配置できます。

半年ほど実務で運用して固まった形をそのまま配布しています。全155ファイル、導入ハンドブックPDF（A4・69頁）同梱。

考え方の中核は、購入前に無料で読めます。

「AIレビューが毎回『概ね問題ありません』になる理由」

https://zenn.dev/tryangrow/articles/ee4f2a02d96a4d

記事に書いた4つの対処は、このキットが無くても再現できます。読んでから判断してください。

中核はひとつ — 疑う者に、実装者の会話履歴を渡さない

TRAID の設計は、この一点から導かれています。

敵対的レビュー担当（Adversary）に渡すのは、ディスク上の成果物と仕様書だけです。実装時の会話、「ここは意図的にこうしています」という説明、「時間がなかったので」という事情は一切渡しません。Claude Code ではサブエージェントが独立したコンテキストで走るため、この壁が構造的に保たれます。

評価の形式も固定しました。6つの次元それぞれについて PASS か FAIL だけを書かせます。仕様適合 / テストの健全性 / 実装の堅牢性 / セキュリティ / 保守性 / AI出力品質。1次元でもFAILなら総合FAIL。部分点も、条件付き合格もありません。「概ね」と書ける欄がないので、AIは実際にコードを読み始めます。

逆方向の失敗も止めてあります。指摘にはファイルパスと行範囲の提示を義務づけ、証拠のない指摘は登録させません。そしてPASSを出す場合も「どこをどう探したか」の探索ログを残す義務があります。探さずに通したのか、探した上で見つからなかったのかを、後から区別できるようにするためです。

工程の進行判定からも、AIの宣言を追い出しました。「完了しました」は証跡として採用せず、ディスク上にファイルが実在するかどうかだけで次へ進めます。テストが失敗したログが無ければ、実装フェーズは開始できません。AI開発で最も多い逸脱は、失敗するテストの確認を飛ばして実装が始まることです。そして飛ばされたことに人間はなかなか気づけません。

同梱内容と、3つの導入先

【導入先】

・Claude Code

　.claude/agents/ にサブエージェント19体。推奨環境です。独立コンテキストで走るため、レビューの壁が自動的に保たれます。

・Claude アプリ / Cowork

　カスタムスキル20個。アップロード用ZIPを同梱しているので、設定画面から追加するだけです。

・Cursor

　.cursor/rules/*.mdc 20件。変換済みで同梱しています。

【同梱内容 — 全155ファイル】

・エージェント定義 19体 × 3形式

・導入ハンドブック PDF（A4・69頁／5部構成）

・ドキュメント7点

　01 TRAID仕様書（状態機械・インターフェース・品質ゲート）

　02〜04 導入手順（Claude Code / Claude アプリ / Cursor）

　05 操作手順書（1スプリントの流れ・FAIL時の対処）

　06 エージェント名鑑（19体の役割と禁止事項）

　07 FAQ・トラブルシュート

・方法論リファレンス（フェーズ詳細・Bead設計・全品質閾値）

・エージェント相関図・差し戻しマップ

・プロジェクトテンプレート（CLAUDE.md / spec一式 / 判定書・指摘書の雛形）

・導入スクリプト4本（Claude Code / Cursor / スキルZIP生成 / Cursor変換）

導入は1コマンドです。

　bash scripts/install-claude-code.sh /path/to/your-project

既存ファイルは上書きしません。

19体の布陣と、全部使わない選択

【19体の布陣】

常駐　　　Orchestrator　　　　　　工程の進行管理・差し戻しルーティング

Phase 0　 Trend Researcher　　　　一次情報での市場・技術調査

Phase 1　 Planner　　　　　　　　 EARS形式の検証可能な仕様

　　　　　Spec-Validator　　　　　仕様の100点満点採点（85点以上で承認）

　　　　　Architect　　　　　　　 ADR形式の技術選定

　　　　　Database Engineer　　　 スキーマ・RLS・型生成

　　　　　DevOps Agent　　　　　　CI/CD構築

Phase 2　 TDD-Writer　　　　　　　失敗するテストの設計

　　　　　Generator　　　　　　　 最小実装

　　　　　AI/LLM Engineer　　　　 プロンプト版管理・ゴールデンセット評価

　　　　　Refactor Agent　　　　　Fresh Eyes リファクタ

　　　　　Frontend Developer　　　UI・アクセシビリティ

Phase 3　 Security Engineer　　　 OWASP監査・CVSS付与

　　　　　Adversary　　　　　　　 ★敵対的レビュー（6次元バイナリ）

　　　　　Performance Engineer　　Lighthouse・Core Web Vitals

Phase 5　 Evaluator　　　　　　　 5ゲート統合判定・出荷判定

　　　　　Secretary　　　　　　　 スプリント記録

Phase 7　 Observability Engineer　本番監視・インシデント起票

FAIL時　　Sprint Retrospective　　5-Why分析・ルール更新

【全部使う必要はありません】

部分導入を想定して設計しています。

Lv.1　Planner だけ

　　　曖昧な要望が検証可能な仕様になる

Lv.2　＋ Spec-Validator ＋ Adversary

　　　仕様が採点され、成果物が敵対的に検査される

Lv.3　＋ TDD-Writer ＋ Generator ＋ Refactor

　　　TDDが回る

Lv.5　19体すべて

　　　パイプラインが自走する

費用対効果の頂点は Lv.2 です。ここまででAI開発の事故の大半は防げます。19体を全部動かすのは、そこまで来てからで構いません。

【こんな方に】

・Claude Code や Cursor を日常的に使っていて、AIレビューが機能していないと感じている

・AIが書いたテストが実装のスナップショットになっていて、バグを検出できていない

・「どこまで作ったか」を正確に説明できなくなってきた

・一人開発で、レビューしてくれる相手がいない

向いていないもの

【向いていないもの】

正直に書きます。

・1ファイルのtypo修正のような小さい作業には過剰です

・仕様が固まっていない探索段階では機能しません。手で試してから載せてください

・人間のレビューは無くなりません。見るべき箇所が絞られるだけです

・複数のエージェントが同じコードを読み直すため、トークン消費は実装だけさせるより増えます

コストに見合うかは、扱っているものによります。個人の実験なら過剰です。課金や個人情報を扱っていて、壊れたときに自分で謝りに行く立場なら、たぶん見合います。

動作環境

・Claude Code　v2.1以降を推奨

・Claude アプリ　カスタムスキルのアップロードに対応するプラン

・Cursor　Project Rules（.cursor/rules/*.mdc）対応版

・導入スクリプト用に bash / zip / python3（手動配置も可能です）

各AIツールの利用契約・利用料金はご自身でご負担ください。本キットにAIツールの利用権は含まれません。

既定のスタックは Supabase / GitHub Actions / Vercel を想定していますが、CLAUDE.md の技術スタック節に自分の構成を書けば、エージェントはそちらを優先します。

ライセンス

・1購入 = 1事業者。組織内の利用人数・導入プロジェクト数は無制限

・改変自由

・本キットを用いて開発した成果物の権利はすべて購入者に帰属。商用利用・販売の制限なし、クレジット表記の義務なし

・本キットを道具として受託開発やコンサルティングを行うことは自由です

・本キット自体（改変版を含む）の再配布・再販売・公開リポジトリへの掲載は禁止

詳細は同梱の LICENSE_利用条件.md をご確認ください。

【サポート・アップデート】

・購入から90日間、メールで導入手順のご質問とファイル不備のご報告を承ります

・プロジェクト固有の設計相談、生成AIの出力に関する相談は対象外です

・v4.x の修正版・機能追加版は期間の定めなく無償提供します

【ご注意】

デジタルコンテンツの性質上、購入後の返品・返金はお受けできません。ファイルの破損等により使用できない場合は、購入日から14日以内にご連絡ください。再提供または返金の対応をいたします。

TRAID は品質を高めるための方法論であり、品質を保証するものではありません。仕様の最終承認、リリースの可否、成果物に対する責任は、常に利用者にあります。

https://zenn.dev/tryangrow/articles/ee4f2a02d96a4d