ADDF — Agentic Driven Development Framework
AI コーディングエージェントのためのリポジトリ構成フレームワークです。 プロジェクトに ADDF を導入すると、計画駆動の開発プロセス・ノウハウ蓄積・品質ゲートが自動的に機能し、AI エージェントが自律的にタスクを選び、実装し、品質検証まで完遂します。
ADDF はリポジトリ構成フレームワークであり、アプリケーションフレームワークを含みません。 React、Rails、Flutter、Unity など、どんな技術スタックのプロジェクトにも導入できます。
| エージェント | サポート | 備考 |
|---|---|---|
| Claude Code (Anthropic) | ファーストパーティ | 全機能対応。Hooks・Skills・Agents・並列実行を活用 |
| Codex (OpenAI) | 部分対応 | 計画駆動・ノウハウ蓄積は利用可。Hooks・自動品質ゲートは制限あり → 詳細 |
| その他 (Open Code 等) | 基本対応 | CLAUDE.md / AGENTS.md を読めるエージェントなら計画駆動ワークフローは動作 |
- 計画駆動 — コードではなく計画をレビュー。AI が実装品質を担保する
- ノウハウ蓄積 — 実装で得た知見を
.claude/addf/knowhow/に記録し、以降のタスクで自動参照 - 自己推進 —
/addf-devで1タスク完遂、/loop 1h /addf-devで自律繰り返し - 品質ゲート — コードレビュー・セキュリティレビュー・コントリビューション検出を自動実行
- スキルと経験の分離 — スキル定義（
.md）と経験蓄積（.exp.md）を分離し、経験はローカルに蓄積 - ccchain コマンドゲート（オプトイン） —
Behavior.tomlの[ccchain]を有効にすると、Bash コマンドを許可リストベースで評価する PreToolUse フック（ccchain）が配線され、破壊的操作を ask 化できる - ローカルダッシュボード — オーナー判断待ちキュー・計画バックログ・進行中タスクを俯瞰する HTML ダッシュボードを生成（
python3 .claude/addf/addfTools/generate-dashboard.py→npm run dashboard:devで閲覧）。ページ上の任意箇所にアンカーコメントを置いて送信すると、次セッションのエージェントがブートシーケンスで読んで対応する — 非同期レビューループ
新規プロジェクト — GitHub Template から:
# Use this template → リポジトリ作成 → クローン
git clone https://github.com/your-org/my-project.git
cd my-project/addf-init
既存プロジェクト — Claude Code で以下を実行:
https://raw.githubusercontent.com/fruitriin/ADDF/main/.claude/commands/addf-init.md
を取得し、このプロジェクトに ADDF フレームワークを導入してください。
ADDF リポジトリ: https://github.com/fruitriin/ADDF
既存の CLAUDE.md・AGENTS.md・設定ファイルは自動で退避・マージされます。
- ログイン機能を追加
- テストカバレッジを上げるこれを Claude に渡すだけで、AI が計画ファイル群に分解して .claude/addf/plans/ と TODO.md に投入します。
/addf-dev
1タスクを選択・実装・品質検証・コミットまで完遂します。繰り返し自律実行するには:
/loop 1h /addf-dev
ADDF が提供するスキル（/コマンド名 で呼び出し）:
| スキル | 呼び出し | 説明 |
|---|---|---|
| addf-dev | /addf-dev |
TODO からタスクを1つ選び、実装・品質検証・コミットまで完遂 |
| addf-init | /addf-init [check] |
プロジェクト初期化 / 構造検証 |
| addf-release | /addf-release [minor] |
リリース（チェンジログ・バージョン採番・publish） |
| addf-migrate | /addf-migrate |
ADDF フレームワークを最新版にアップグレード |
| addf-knowhow | /addf-knowhow <トピック> |
実装知見を記録（重複チェック・統合付き） |
| addf-knowhow-index | /addf-knowhow-index [reindex] |
ノウハウインデックスの参照・再構築 |
| addf-lint | /addf-lint |
フレームワーク整合性チェック |
| addf-permission-audit | /addf-permission-audit |
権限要求の分析・分類・settings への追加提案 |
| addf-mode | /addf-mode [unattended] |
「迷ったときの作法」3軸モードの表示・切り替え |
| addf-speculate | /addf-speculate [clean] |
アイドル時の worktree 投機開発（オプトイン。本流には自動マージしない） |
その他のスキル
| スキル | 説明 |
|---|---|
| addf-knowhow-filter | Plan に関連するノウハウをフィルタリング |
| addf-knowhow-revise | 鮮度低下したノウハウの再検証・訂正 |
| addf-knowhow-network | ノウハウ同士を相互リンクして wiki として育てる |
| addf-plan-audit | 完了扱いだが未完了タスクが残っている計画（埋没）を棚卸し |
| addf-overview | エコシステム概要ドキュメントを .claude/addf/project-overview/ に生成 |
| addf-experience | 経験ファイル（.exp.md）参照の自己整合性・書式健全性を検証 |
| addf-gui-test | GUI テスト実行（macOS オプション） |
| addf-annotate-grid | PNG 画像にグリッド線を描画 |
| addf-clip-image | PNG 画像の領域切り出し |
品質ゲートで自動起動されるサブエージェント。プロジェクトに合わせて定義を変更・追加できます。
| エージェント | 用途 | カスタマイズ指針 |
|---|---|---|
| addf-knowhow-agent | Plan に関連するノウハウをフィルタリング | — |
| addf-code-review-agent | コード品質・可読性のレビュー | プロジェクトのコーディング規約を追記 |
| addf-security-review-agent | セキュリティ脆弱性の検査（オプション） | 業界固有のセキュリティ基準を追記 |
| addf-doc-review-agent | ドキュメントと実装の乖離（ドリフト）検出 | — |
| addf-contribution-agent | フレームワークへのコントリビューション候補検出 | — |
| addf-implementer | Plan・スコープ・完了条件が明示された委譲プロンプトを受けて実装を行う専任エージェント | 実装を他のレビュー・調査系エージェントから分離したい場合に使う |
| addf-ui-test-agent | スクリーンショットベースの UI 検証（オプション） | プロジェクトの UI/UX 専門家として定義を書き換える |
テスターエージェントはプロジェクトの専門家であるべきです。
addf-ui-test-agentやaddf-security-review-agentの定義（.claude/agents/）を、プロジェクトのドメイン知識・テスト基準・品質要件に合わせてカスタマイズしてください。 例: EC サイトなら決済フローの検証手順、iOS Native なら iOS シミュレータでの自動テスト手順を追加する、など。
| ガイド | 内容 |
|---|---|
| 詳細セットアップ | 手動セットアップ、設定ファイルの役割、ディレクトリ構成 |
| 組み込みエージェント | 品質ゲートで自動起動されるサブエージェントの詳細とカスタマイズ |
| フレームワークスキル | ADDF が提供する全スキル（/コマンド名）の一覧 |
| 開発プロセス | ブートシーケンス、品質ゲート、タスクのライフサイクル |
| バージョンアップ | /addf-migrate による ADDF のアップグレード手順 |
| モデル配分ガイド | 役割ごとに異なる Claude モデルを使い分ける運用の考え方 |
| 投機開発 | アイドル時の worktree 投機開発の全体像（2層モデル・昇格・掃除） |
| PR 作成の作法 | PR 本文の標準フォーマット（対象 Plan リンク・進捗位置欄） |
| Codex で使う | OpenAI Codex CLI での ADDF 利用ガイド |
| GUI テスト | macOS 向け GUI テストのセットアップ |
このフレームワークの正式名称は AutomatonDevDrive Framework。
……なのですが、頭文字を拾うと ADDF。 そして ADDF を展開すると — Agentic Driven Development Framework。
偶然ではありません。
Automaton（自動人形）は、AIエージェントが自律的にタスクを選び、実装し、品質を検証する様子をそのまま指しています。人間が逐一指示しなくても、自動人形は動き続ける。DevDrive はその動力源——開発を駆動するエンジンのような存在です。
表の名前は Automaton、裏の名前は Agentic。どちらも同じものを指している。 気づいた人はニヤリとしてください。