【個人開発】Claude Codeに83%のコードを書かせる「ドキュメント駆動開発」の全貌【Flutter向けCLAUDE.md公開】

良い例
「詳細は docs/30_technical/voice-session.md を参照」

悪い例
「音声セッションはGemini Live APIを使用し、WebSocketで接続して...（100行続く）」

docs/
├── 10_product/      # WHY: なぜ作るか（要件、ロードマップ）
├── 20_design/       # WHAT: 何を作るか（UI、体験設計）
├── 30_technical/    # HOW: どう作るか（アーキテクチャ、API）
├── 40_operations/   # RUN: どう運用するか（課金、リリース）
└── 50_android/      # PF: プラットフォーム固有

## レイヤー概要

| レイヤー | 責務 |
|---------|------|
| core | 共通部品、定数、テーマ |
| data | データモデル、ローカルDB |
| services | 外部API連携 |
| presentation | UI、状態管理 |

debug: add logging to trace chat session reset issue
  ↓
fix: prevent chat session reset when calendar changes
  ↓
chore: remove debug logs from chat session flow

❌ 粗すぎ
「音声機能を作る」
→ 何をどう作るか不明
→ Claude Codeが推測で動く

❌ 細かすぎ
「ボタンは16pxの角丸で、#3B82F6の青色で...」
→ 実装と乖離したとき、矛盾が発生
→ ドキュメントが負債化する
→ メンテナンスコストが爆発

✅ 適切
「Gemini Live API → Function Calling → Supabase保存」
→ 技術選定と大まかな流れが明確
→ 細部はClaude Codeが判断
→ 実装と乖離しにくい

# ============================================
# Day 2-3（開発開始直後）- 設計ドキュメント爆速整備
# ============================================
12/30 docs: Update roadmap to reflect Phase A (Firebase) completion
12/31 docs: Update Phase C/F plan - prioritize voice UI
12/31 docs: Update implementation-roadmap to v3.1.0
12/31 docs: Simplify AGENT.md and standardize document headers
12/31 docs: Add README.md for each lib layer          # ← lib/配下にREADME
12/31 docs: Restructure 20_design/ by aspect          # ← 番号付きフォルダ導入
12/31 docs: Add implementation status summary document
12/31 docs: Add recurring schedule feature documentation
12/31 docs: Add release guide and documentation index

# Day 4-5 - 課金設計 & オンボーディング
01/01 docs: Reorganize documentation structure into clean hierarchy
01/01 docs: Add ASO texts for App Store Connect submission
01/01 docs: Major update to onboarding and notification flow v1.1.0
01/01 docs: Add 迷子型 persona and test scenarios     # ← ペルソナ設計
01/01 docs: Add billing model design and multiple goal PoC
01/01 docs: Update billing model to v2.0 with pool system

# Day 6 - 課金モデル確定 & ドキュメント統合
01/02 docs: Update billing model - free notifications, trial 60min
01/02 docs: Add Apple fee (15%) to revenue simulation
01/02 docs: Finalize billing v2.0 decisions with rollover pool
01/02 docs: Update design specs to v2.0 with frosted glass
01/02 docs: Consolidate and update documentation for MVP completion
01/02 docs: Reorganize documentation structure and unify headers

# ============================================
# Day 14〜（実装が進んだ後）- 運用ドキュメント追加
# ============================================
01/10 docs: add auth architecture documentation
01/10 docs: add comprehensive system architecture diagram
01/10 docs: fix CI/CD architecture (Codemagic for TestFlight)
01/10 docs: improve architecture diagram with Supabase components

# Day 15 - Apple審査対応 & カレンダー設計
01/11 docs: add App Review Notes template for Apple review
01/11 docs: clarify consumable IAP details in support FAQ
01/11 docs: add future work for calendar sync features
01/11 docs: update architecture diagram with Cloud Build

# Day 16 - リリースノート
01/12 docs: add v1.0.3 release notes and Apple review response

# Day 18 - ドキュメント構造の大規模リファクタ
01/14 docs: reorganize documentation structure
01/14 docs: update requirements.md to v2.0 with pool system
01/14 docs: consolidate duplicate docs (notification-strategy)
01/14 docs: add API versioning design document
01/14 docs(billing): add manual operations guide

# Day 19 - v1.1要件定義
01/15 docs: add v1.1 release requirements
01/15 docs: archive completed phases

# Day 21 - 法務文書 & タイムゾーン
01/17 docs: add tokushoho (特定商取引法) legal disclosure
01/17 docs: add timezone handling guidelines

# Day 23 - MECE通知設計
01/19 docs: add MECE notification system design
01/19 docs: add server notifications guide (RTDN vs App Store)
01/19 docs: add detailed Extension UI design

# Day 24 - v1.2計画
01/20 docs: add v1.2.0 release review and growth feature designs
01/20 docs: mark In-App Review and SNS sharing as completed

# Day 25 - ドキュメント統合（42→16ファイル）
01/21 docs: consolidate documentation from 42 to 14 files
01/21 docs: add Google Sign-In SHA-1 design and operations guide
01/22 docs: sync documentation with codebase implementation