| name | tdd-onboard |
| description | 既存プロジェクトにTDD環境をセットアップする。フレームワーク検出、CLAUDE.md生成、docs/STATUS.md作成を行う。「TDDセットアップ」「onboard」「プロジェクト初期化」で起動。 |
TDD Onboard
既存プロジェクトにTDD環境をセットアップする。
Progress Checklist
コピーして進捗を追跡:
Onboard Progress:
- [ ] プロジェクト分析(フレームワーク/テストツール検出)
- [ ] 検出結果をユーザーに確認
- [ ] docs/ 構造作成(cycles/, README.md, STATUS.md)
- [ ] CLAUDE.md 生成(既存あればマージ)
- [ ] 階層CLAUDE.md推奨(任意)
- [ ] .claude/ 構造生成(rules/, hooks/)
- [ ] Pre-commit Hook確認(推奨)
- [ ] 初期Cycle doc作成
- [ ] Next Steps 表示
Workflow
Step 1: プロジェクト分析
フレームワークとツールを検出:
ls artisan 2>/dev/null
ls app.py wsgi.py 2>/dev/null
ls wp-config.php 2>/dev/null
ls composer.json package.json pyproject.toml 2>/dev/null
Step 2: 検出結果確認
AskUserQuestion で確認:
- フレームワーク
- パッケージマネージャ
- 既存CLAUDE.mdの処理方法
Step 3: docs/ 構造作成
mkdir -p docs/cycles
作成ファイル:
docs/README.md - ドキュメント索引
docs/STATUS.md - プロジェクト状況(tdd-commitで自動更新)
テンプレートは reference.md を参照。
Step 4: CLAUDE.md 生成
- 既存あり → マージ or 上書き確認
- 既存なし → テンプレートから生成
テンプレートとマージ戦略は reference.md を参照。
Step 5: 階層CLAUDE.md推奨(任意)
tests/, src/, docs/ に CLAUDE.md 配置を推奨(各30-50行)。
詳細は reference.md を参照。
Step 6: .claude/ 構造生成
存在しない場合に作成。rules/: git-safety, security, git-conventions。hooks/: recommended。推奨設定: Skill(tdd-core:*) をallowedToolsに追加。詳細は reference.md。
Hook設定の案内: .claude/hooks/recommended.md に推奨Hook設定が記載されている旨をユーザーに伝え、~/.claude/settings.json にコピーしてClaude Codeを再起動するよう案内する。
Step 7: Pre-commit Hook確認(推奨)
hookなし → セットアップ推奨。詳細は reference.md を参照。
Step 8: 初期Cycle doc作成
docs/cycles/YYYYMMDD_0000_project-setup.md を作成。
Step 9: 完了
セットアップ完了メッセージを表示。次: tdd-init で開発開始。