https://github.com/fusic/todo-ai-dlc
https://github.com/fusic/todo-ai-dlc
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/fusic/todo-ai-dlc
- Owner: fusic
- License: mit
- Created: 2026-03-11T22:12:47.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-04-16T02:06:25.000Z (4 months ago)
- Last Synced: 2026-04-23T00:35:26.258Z (3 months ago)
- Language: TypeScript
- Size: 249 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# todo-ai-dlc
TODO 管理アプリケーション（React + Hono + DynamoDB）
## 前提条件
| ツール | 必須 | 備考 |
|--------|------|------|
| [Rancher Desktop](https://rancherdesktop.io/) | **必須** | Container Engine は **dockerd (moby)** を選択してください。Docker Desktop でも代替可能ですが、本プロジェクトでは Rancher Desktop を標準としています |
| [Node.js](https://nodejs.org/) 20+ | ホスト直接開発時 | Docker のみで開発する場合は不要 |
| [pnpm](https://pnpm.io/) 9.15+ | ホスト直接開発時 | `corepack enable` で有効化 |
| Git | **必須** | |
## ローカル開発環境（Rancher Desktop / Docker）
### セットアップ
```bash
git clone
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 |
### 停止
```bash
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 モードを有効にしてください：
```bash
VITE_USE_POLLING=true docker compose up --build
```
### ホスト直接での開発
Docker を使わずにホストで直接開発する場合：
```bash
pnpm install
pnpm run dev # Frontend 起動
# 別ターミナルで
pnpm --filter @todo-ai-dlc/backend dev # Backend 起動
```
Backend から DynamoDB Local に接続する場合は、別途 DynamoDB Local を起動し `DYNAMODB_ENDPOINT=http://localhost:8000` を設定してください。
## テスト
```bash
pnpm -r test
```
## プロジェクト構成
```
packages/
├── backend/ # Hono API サーバー (DynamoDB)
├── frontend/ # React + Vite + Tailwind CSS
└── infrastructure/ # AWS CDK
```
## AIDLC ワークフロー（必須）
本プロジェクトでは [AI-DLC（AI Development Lifecycle）](https://github.com/awslabs/aidlc-workflows) ワークフローを採用しています。要件定義・設計・実装のすべてのフェーズで AIDLC を使用するため、開発開始前に必ずセットアップしてください。
### セットアップ
```bash
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
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/ # ビルド・テスト手順
```