AutomatonDevDrive Framework

ADDF — Agentic Driven Development Framework

English README

AI コーディングエージェントのためのリポジトリ構成フレームワークです。 プロジェクトに ADDF を導入すると、計画駆動の開発プロセス・ノウハウ蓄積・品質ゲートが自動的に機能し、AI エージェントが自律的にタスクを選び、実装し、品質検証まで完遂します。

ADDF はリポジトリ構成フレームワークであり、アプリケーションフレームワークを含みません。 React、Rails、Flutter、Unity など、どんな技術スタックのプロジェクトにも導入できます。

対応エージェント

エージェント	サポート	備考
Claude Code (Anthropic)	ファーストパーティ	全機能対応。Hooks・Skills・Agents・並列実行を活用
Codex (OpenAI)	部分対応	計画駆動・ノウハウ蓄積は利用可。Hooks・自動品質ゲートは制限あり → 詳細
その他 (Open Code 等)	基本対応	CLAUDE.md / AGENTS.md を読めるエージェントなら計画駆動ワークフローは動作

特徴

• 計画駆動 — コードではなく計画をレビュー。AI が実装品質を担保する
• ノウハウ蓄積 — 実装で得た知見を docs/knowhow/ に記録し、以降のタスクで自動参照
• 自己推進 — /addf-dev で1タスク完遂、/loop 1h /addf-dev で自律繰り返し
• 品質ゲート — コードレビュー・セキュリティレビュー・コントリビューション検出を自動実行
• スキルと経験の分離 — スキル定義（.md）と経験蓄積（.exp.md）を分離し、経験はローカルに蓄積

クイックスタート

1. ADDF を導入する

新規プロジェクト — 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/AutomatonDevDriveFramework/main/.claude/commands/addf-init.md
を取得し、このプロジェクトに ADDF フレームワークを導入してください。
ADDF リポジトリ: https://github.com/fruitriin/AutomatonDevDriveFramework

既存の CLAUDE.md・AGENTS.md・設定ファイルは自動で退避・マージされます。

2. 計画を作成して開発を開始

- ログイン機能を追加
- テストカバレッジを上げる

これを Claude に渡すだけで、AI が計画ファイル群に分解して docs/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-knowhow-filter	Plan に関連するノウハウをフィルタリング
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-contribution-agent	フレームワークへのコントリビューション候補検出	—
addf-ui-test-agent	スクリーンショットベースの UI 検証（オプション）	プロジェクトの UI/UX 専門家として定義を書き換える

テスターエージェントはプロジェクトの専門家であるべきです。 addf-ui-test-agent や addf-security-review-agent の定義（.claude/agents/）を、プロジェクトのドメイン知識・テスト基準・品質要件に合わせてカスタマイズしてください。 例: EC サイトなら決済フローの検証手順、iOS Native なら iOS シミュレータでの自動テスト手順を追加する、など。

ドキュメント

ガイド	内容
詳細セットアップ	手動セットアップ、設定ファイルの役割、ディレクトリ構成
組み込みエージェント	品質ゲートで自動起動されるサブエージェントの詳細とカスタマイズ
開発プロセス	ブートシーケンス、品質ゲート、タスクのライフサイクル
バージョンアップ	/addf-migrate による ADDF のアップグレード手順
Codex で使う	OpenAI Codex CLI での ADDF 利用ガイド
GUI テスト	macOS 向け GUI テストのセットアップ

名前について

このフレームワークの正式名称は AutomatonDevDrive Framework。

……なのですが、頭文字を拾うと ADDF。 そして ADDF を展開すると — Agentic Driven Development Framework。

偶然ではありません。

Automaton（自動人形）は、AIエージェントが自律的にタスクを選び、実装し、品質を検証する様子をそのまま指しています。人間が逐一指示しなくても、自動人形は動き続ける。DevDrive はその動力源——開発を駆動するエンジンのような存在です。

表の名前は Automaton、裏の名前は Agentic。どちらも同じものを指している。 気づいた人はニヤリとしてください。