todo-ai-dlc

TODO 管理アプリケーション（React + Hono + DynamoDB）

前提条件

ツール	必須	備考
Rancher Desktop	必須	Container Engine は dockerd (moby) を選択してください。Docker Desktop でも代替可能ですが、本プロジェクトでは Rancher Desktop を標準としています
Node.js 20+	ホスト直接開発時	Docker のみで開発する場合は不要
pnpm 9.15+	ホスト直接開発時	corepack enable で有効化
Git	必須

ローカル開発環境（Rancher Desktop / Docker）

セットアップ

git clone <repository-url>
cd todo-ai-dlc
cp .env.example .env  # 必要に応じて編集
docker compose up --build

アクセス URL

サービス	URL
Frontend	http://localhost:3000
Backend API	http://localhost:3001
DynamoDB Local	http://localhost:8000

停止

docker compose down          # コンテナ停止
docker compose down -v       # コンテナ停止 + データリセット（volumes 削除）

Windows（WSL2）での開発

WSL2 上で利用する場合、以下の点に注意してください：

1. プロジェクトは WSL2 ネイティブ FS に clone する（/home/user/... 配下）。/mnt/c/... に置くと bind mount のパフォーマンスが大幅に低下します
2. hot-reload が動かない場合は、polling モードを有効にしてください：

   VITE_USE_POLLING=true docker compose up --build

ホスト直接での開発

Docker を使わずにホストで直接開発する場合：

pnpm install
pnpm run dev          # Frontend 起動
# 別ターミナルで
pnpm --filter @todo-ai-dlc/backend dev   # Backend 起動

Backend から DynamoDB Local に接続する場合は、別途 DynamoDB Local を起動し DYNAMODB_ENDPOINT=http://localhost:8000 を設定してください。

テスト

pnpm -r test

プロジェクト構成

packages/
  ├── backend/        # Hono API サーバー (DynamoDB)
  ├── frontend/       # React + Vite + Tailwind CSS
  └── infrastructure/ # AWS CDK

AIDLC ワークフロー（必須）

本プロジェクトでは AI-DLC（AI Development Lifecycle） ワークフローを採用しています。要件定義・設計・実装のすべてのフェーズで AIDLC を使用するため、開発開始前に必ずセットアップしてください。

セットアップ

git clone https://github.com/awslabs/aidlc-workflows.git .aidlc-workflows

利用方法

Claude Code では以下のコマンドが利用可能になります：

• /aws-aidlc-inception — 要件定義・設計フェーズ（Inception）
• /aws-aidlc-construction — 実装・テストフェーズ（Construction）

Codex で同等の Skill を使う場合は、repo 内の定義を ~/.codex/skills に連携します：

bash scripts/install-codex-skills.sh

必要に応じて CODEX_SKILLS_HOME=/path/to/skills で導入先を切り替えられます。導入後は Codex を再起動すると aws-aidlc-inception と aws-aidlc-construction が利用可能になります。

AIDLC 成果物

AIDLC ワークフローの成果物は aidlc-docs/ に格納されます：

aidlc-docs/
  ├── inception/         # 要件定義・アプリケーション設計
  │   ├── requirements/  # 要件定義
  │   ├── application-design/  # コンポーネント設計・サービス定義
  │   └── plans/         # 実行計画
  └── construction/      # 実装成果物
      ├── plans/         # コード生成計画
      ├── backend/       # Backend 実装サマリー
      ├── frontend/      # Frontend 実装サマリー
      ├── infrastructure/ # インフラ設計・実装サマリー
      └── build-and-test/ # ビルド・テスト手順