# ドキュメント駆動開発プロセス CLAUDE.md > プロジェクト直下に `CLAUDE.md` として置くだけで、AI の開発プロセスが > 「いきなりコードを書く」から「作るものを固めてから書く」に切り替わります。 ## 根本方針 **「作るものをはっきりさせてから AI のコーディングを始める」**。特に UI (操作画面) の仕様を ワイヤフレーム・状態・遷移・要素一覧・アクセシビリティ方針として明文化し終えるまで、 実装フェーズに入らせない (AIコーディング開始ゲート)。 ## AI への最重要指示 **ドキュメントは絶対に一括生成しない。1ファイル作るごとに必ず停止して、ユーザーの明示的な承認を待つ。** - 1回の応答で作成・編集してよいドキュメントは 1 ファイルだけ - 「OK」「承認」「次へ」等の明示的な合図があるまで次のファイルに着手しない ## ドキュメント作成順序 (UI を先に固める) 1. **product-requirements** — ビジョン / ターゲット / 主要機能 / 受け入れ条件 / ユースケース図 2. **ui-specification** — 画面一覧 (画面ID採番) / 画面遷移図 / ワイヤフレーム (PC+モバイル) / UI要素一覧 / 状態定義 (空・読込中・エラー) / 操作イベント表 / アクセシビリティ (WCAG 2.1 AA) 3. **functional-design** — アーキテクチャ / データモデル (ER図) / 状態管理 / API設計 4. **architecture** — 技術スタック / 制約 / パフォーマンス要件 5. **glossary** — 用語集 (UIラベルの揺れ防止) ## AIコーディング開始ゲート 上記 1〜5 が承認済みになるまで、`src/` 配下のコードを 1 行も書かない。 ゲート通過後は ui-specification の画面IDを PR 単位に対応させて実装する。 *(以降、各ドキュメントの必須章立てテンプレート・SVGワイヤフレームの作法・ デザインシステムCSS・レビュー観点チェックリスト 約400行が続きます — 購入後に全文が読めます)* ---