ディレクトリ構成 (実業務向け)

project/
├── AGENTS.md
├── CLAUDE.md
├── README.md
├── .gitignore
├── .editorconfig
├── .claude/
│   ├── skills/
│   │   └── phase4-domain-tdd/
│   │       └── SKILL.md
│   ├── agents/                     # 任意: 複雑調査を定型化する場合
│   └── settings.json               # 任意: Hooks を使う場合
├── .cursor/
│   └── rules/
│       ├── 00-project.mdc
│       ├── 10-domain-rules.mdc
│       ├── 20-coding-style.mdc
│       ├── 30-testing.mdc
│       ├── 40-logging.mdc
│       ├── 50-documentation.mdc
│       ├── 60-ai-workflow.mdc
│       ├── 61-tdd-loop.mdc
│       └── 70-local-env.mdc       # Docker前提の運用ルール
├── docs/                          # チーム公式ドキュメント (詳細: 11.6)
│   ├── README.md                  # ドキュメント索引
│   ├── architecture.md            # 全体アーキテクチャ (常時更新)
│   ├── glossary.md                # 用語集
│   ├── setup.md                   # セットアップ手順
│   ├── adr/                       # ADR (詳細: 11.7)
│   │   ├── README.md              # ADR索引
│   │   ├── template.md            # ADR雛形
│   │   ├── 0001-use-postgres.md
│   │   ├── 0002-adopt-fastapi.md
│   │   └── ...
│   ├── operations/                # 運用手順・ランブック
│   │   ├── deployment.md
│   │   └── incident-response.md
│   └── <feature-A>/               # 機能単位の公式ドキュメント
│       ├── README.md              # 機能ドキュメント索引
│       ├── 01_requirements.md
│       ├── 02_design.md
│       ├── 03_db_schema.md
│       ├── 04_tech_decisions.md
│       ├── 05_test_plan.md
│       ├── 06_logging.md
│       └── 07_deployment.md
├── tasks/                         # Plan・振り返り（詳細: 11.6 / flow-18）
│   ├── todo.md                    # チェック可能な Plan・進捗・結果
│   └── lessons.md                 # 指摘・修正パターンの蓄積
├── z_docs/                        # 任意: 個人メモを置く場合のみ (詳細: 11.6)
│   ├── <feature-A>/
│   │   ├── 00_plan.md             # 任意: 個人用のタスク分解メモ
│   │   └── history/
│   │       └── yymmdd-hhMM-summary.md  # 任意: 個人用の作業ログ
│   ├── scratch/                   # 試行錯誤・調査メモ
│   └── notes/                     # 個人メモ
├── src/
│   ├── domain/
│   ├── application/
│   ├── infrastructure/
│   └── interface/
├── tests/
│   ├── unit/
│   ├── integration/
│   └── e2e/
├── migrations/
├── docker/
│   ├── app/
│   │   ├── Dockerfile         # 本番用 (マルチステージ)
│   │   └── Dockerfile.dev     # 開発用 (hot-reload等)
│   └── db/
│       └── init.sql           # DB初期化スクリプト
├── docker-compose.yml           # 開発環境定義 (app + db + redis + minio)
├── docker-compose.override.yml.example  # 個人カスタマイズ雛形
├── Makefile                     # コマンド集約
├── .aws/
│   └── task-definition.json   # ECS Task Definition (デプロイで使用)
├── .github/
│   └── workflows/
│       ├── ci.yml             # PR/push時のテスト・lint
│       └── deploy.yml         # mainマージ時のECSデプロイ
├── .env.example
└── pyproject.toml (or go.mod / package.json)

主要ディレクトリの役割

• docs/ — 仕様・ADR の正本。チーム共有でコミットする
• tasks/ — Plan・todo・振り返りの置き場
• .cursor/rules/ — AI が毎回読む規約
• .github/workflows/ — CI / デプロイ定義