[プロジェクト] 新規プロジェクト初期化
入力:
- プロジェクトの概要(任意)
- 省略時: 壁打ちから開始
例: 新しいポートフォリオサイトを作りたい SaaSダッシュボードを始めたい Astro + Svelte でブログを作りたい
🎯 目的
- 要件定義からプロジェクト作成までを壁打ちしながら一気通貫で実施
- ボイラーテンプレートの作り方を毎回調べる手間をなくす
- ai-template(.claude/ CLAUDE.md doc/)を自動適用し、rdd.md に要件定義を反映した状態で開発を開始
Phase 0: テンプレートソースの検出
このスキルは ai-template ディレクトリ内から実行しても、グローバルスキルとしてどこからでも実行しても動く。
検出ロジック(AIが自動実行)
# 1. カレントディレクトリが ai-template か確認
if [ -f "./CLAUDE.md" ] && [ -d "./.claude/skills/project-init" ]; then
TEMPLATE_SOURCE="$(pwd)"
# 2. グローバル設定ファイルから読み取り
elif [ -f "$HOME/.claude/ai-template-path" ]; then
TEMPLATE_SOURCE="$(cat $HOME/.claude/ai-template-path)"
# 3. よくあるパスを探索
elif [ -d "$HOME/output/ai-template/.claude/skills" ]; then
TEMPLATE_SOURCE="$HOME/output/ai-template"
# 4. 見つからない → ユーザーに確認
else
# AIがユーザーにパスを質問する
echo "ai-template のパスを教えてください"
fi
テンプレートパスの永続化(初回のみ)
見つかったパスを ~/.claude/ai-template-path に保存して、次回以降自動検出できるようにする。
ユーザーに保存の確認を取ること。
Phase 1: 壁打ち(/pair plan と同じ進め方)
/pairスキルと同じ壁打ちスタイルで進める。推測で断言せず、前提・選択肢・トレードオフを言語化する。
適用skill(ガイド)
biz-researcher/proposition-reviewer(事業仮説・ターゲットの整理)architecture-expert(技術選定・アーキテクチャ判断)ui-designer(UIが中心のプロジェクトの場合)
進め方(/pair と共通)
ステップ1: 不足情報を短問で確認(1〜3問)
プロジェクト概要を聞き、以下の不足を埋める:
| 確認ポイント | rdd.md の対応セクション |
|---|---|
| 何を作る?誰のため? | プロジェクト概要 > 目的・想定ユーザー像 |
| どこで動く? | ターゲット表示環境 |
| 制約は?(期限/体制/予算) | 制約 |
ステップ2: 技術スタックを2〜3案提示(トレードオフつき)
| レイヤー | 選定基準 |
|---|---|
| フロント | ターゲット環境・インタラクション要件・SSR/SSG要否 |
| バックエンド | API要件・リアルタイム要否・認証要件 |
| データ | 永続化要件・スケール・コスト |
| インフラ | デプロイ先・CI/CD・コスト |
| テスト | テスト戦略(Unit/Integration/E2E) |
ステップ3: 推奨案と理由
採用する技術スタックの推奨案を、根拠とともに提示する。
ステップ4: rdd.md ドラフト生成 → 次の一手
壁打ちの結果を doc/input/rdd.md のフォーマットに整形する。
この時点ではメモリ上に保持(ファイル書き込みは Phase 3 で行う)。
ドラフトをユーザーに見せて「この内容でプロジェクトを作成しますか?」と確認する。 承認後、Phase 2 へ進む。
Phase 2: ボイラーテンプレート作成
2.1 プロジェクト名・ディレクトリの決定
質問:
- プロジェクト名(slug形式)は? 例: my-portfolio, saas-dashboard
- 作成先ディレクトリは? 例: ~/output/, ~/projects/
2.2 ボイラーテンプレートの選定
Phase 1 で決めた技術スタックに基づき、CLI コマンドを提案する。
よく使うボイラーテンプレート一覧
| 技術スタック | CLIコマンド | 補足 |
|---|---|---|
| Astro | npm create astro@latest |
対話式。テンプレート選択あり |
| Next.js | npx create-next-app@latest |
App Router/Pages Router選択 |
| Remix | npx create-remix@latest |
テンプレート選択あり |
| SvelteKit | npx sv create |
テンプレート選択あり |
| Vite + React | npm create vite@latest -- --template react-ts |
軽量。SPA向き |
| Vite + Svelte | npm create vite@latest -- --template svelte-ts |
軽量。SPA向き |
| Vite + Vue | npm create vite@latest -- --template vue-ts |
軽量。SPA向き |
| Express | npx express-generator |
バックエンド単体 |
| Hono | npm create hono@latest |
軽量エッジバックエンド |
| T3 Stack | npm create t3-app@latest |
Next.js + tRPC + Prisma + Tailwind |
| Turborepo | npx create-turbo@latest |
モノレポ。複数パッケージ管理 |
上記にない場合は、技術スタックに合った公式 CLI を Web 検索で確認する。
2.3 ボイラーテンプレートの実行
- ユーザーにCLIコマンドを提示して確認を取る
- 承認後、
Bashツールで実行する - 対話式プロンプトがある場合は、Phase 1 の決定事項を基に選択肢を案内する
注意:
- CLIの対話式プロンプトは自動応答が難しい場合がある。その場合はユーザーに手動実行を案内する
- 実行前に必ず
lsで作成先ディレクトリの存在を確認する - TypeScript を使う場合は TS テンプレートを優先する
2.4 依存パッケージの確認
ボイラーテンプレート作成後:
package.json等を確認して、追加で必要なパッケージを提案する- Phase 1 で決めた技術スタックに基づき、追加インストールを実行する
- Prettier をボイラーテンプレート標準に含める:
prettier+ 対象スタックのeslint-config-prettier相当を導入し、設定ファイルを配置する。.claude/hooks/format-on-edit.shが編集直後に適用するため、後付けの摩擦を避けるべく最初から導入する - テストランナーを最初から導入する: RDD のテスト戦略に従いテストランナー(Vite系なら Vitest 等)を導入し、
package.jsonにtestスクリプトとスモークテスト1本(起動確認レベル)を置く。TDD 前提のためタスク1本目からテストが生まれる。CI の Test ゲート(main 向け PR で実行)を最初の PR から緑にするための布石で、「初期開発が終わってからテストを設定する」運用はしない
Phase 3: AIテンプレートの適用
3.1 コピー対象
Phase 0 で検出した TEMPLATE_SOURCE から、以下をコピーする:
| コピー元 | コピー先 | 説明 |
|---|---|---|
.claude/skills/ |
.claude/skills/ |
判断軸・手順系スキル一式 |
.claude/settings.json |
.claude/settings.json |
Claude Code 設定(存在する場合) |
CLAUDE.md |
CLAUDE.md |
プロジェクトルール |
.claude/rules/ |
.claude/rules/ |
運用ルール(自動適用) |
doc/input/rdd.md |
— | コピーしない(Phase 3.2 で生成する) |
コピーコマンド例
TEMPLATE_SOURCE="/path/to/ai-template"
PROJECT_DIR="/path/to/new-project"
# ディレクトリ構造を作成
mkdir -p "$PROJECT_DIR/.claude"
mkdir -p "$PROJECT_DIR/.claude/rules"
mkdir -p "$PROJECT_DIR/doc/input"
# skills をコピー(既存があればマージ)
cp -r "$TEMPLATE_SOURCE/.claude/skills" "$PROJECT_DIR/.claude/"
# 設定ファイルをコピー(存在する場合のみ)
[ -f "$TEMPLATE_SOURCE/.claude/settings.json" ] && cp "$TEMPLATE_SOURCE/.claude/settings.json" "$PROJECT_DIR/.claude/"
# CLAUDE.md をコピー
cp "$TEMPLATE_SOURCE/CLAUDE.md" "$PROJECT_DIR/"
# 運用ルールをコピー
cp -r "$TEMPLATE_SOURCE/.claude/rules/" "$PROJECT_DIR/.claude/rules/"
3.2 rdd.md の生成
Phase 1.3 で作成したドラフトを doc/input/rdd.md に書き出す。
# rdd.md を Write ツールで生成
# Phase 1 のドラフト内容を doc/input/rdd.md に書き込む
3.3 project-design-language の初期起票
Phase 3.1 でコピーされた穴埋め雛形 .claude/skills/project-design-language/SKILL.md を、judgment-harness の発酵ループに従ってこのタイミングで対話起票する(雛形のまま放置しない):
- 基本方針(存在設計の核)だけを対話で埋める: 誰のためのプロダクトか / 何を良しとするか(北極星)/ 単一メタファー宣言。Phase 1 の壁打ち・rdd.md の内容から手がかりを拾い、弱ければ候補提示→人間選定
- 固有値レジストリ(色/タイポ/モーション/声)は TBD のままでよい。推測で埋めない
- UIを持たないプロジェクト(CLI/ライブラリ等)の場合は、その旨を確認してスキップしてよい(スキップした事実を rdd.md に記録する)
ここで最低限の核を入れておくことで、後続の
auto-build/auto-design/creative-coder/deep-reviewがメタファー参照で動ける状態になる。
3.4 CI セットアップの確認(ユーザーに聞く)
「GitHub Actions で CI をセットアップしますか?」とユーザーに確認する。YES なら .claude/rules/git.md の CI 要件に準拠した .github/workflows/ci.yml を生成する:
# CI要件は .claude/rules/git.md に準拠:
# task/*, feature_fix/* push → Lint + TypeCheck
# main への PR(sprint/hotfix)→ Lint + TypeCheck + Build + Test
name: CI
on:
push:
branches: ['task/**', 'feature_fix/**', 'hotfix/**', 'sprint/**']
pull_request:
branches: [main]
jobs:
check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
- run: npm ci
- run: npm run lint
- run: npm run typecheck
- name: Build(main向けPRのみ)
if: github.event_name == 'pull_request'
run: npm run build
- name: Test(main向けPRのみ)
if: github.event_name == 'pull_request'
run: npm test
- パッケージマネージャ(npm/pnpm)と scripts 名は、生成したボイラーテンプレートの
package.jsonに合わせて調整する - 対応する scripts(
lint/typecheck/build/test)がpackage.jsonに無い場合は先に追加する(testは Phase 2.4 のテストランナー導入とセット。TDD 前提なので Test ステップも最初から有効にし、後から足す運用はしない) - プライベートリポジトリでは GitHub Actions の無料枠を超えると従量課金になる旨を一言添える
3.5 .gitignore の確認
ボイラーテンプレートの .gitignore に以下が含まれているか確認し、なければ追記する:
# セッション一時ファイル
.claude/session-context.md
# 環境変数(セキュリティ)
.env
.env.local
.env.*.local
Phase 4: 初期化完了と案内
4.1 初期コミット
cd "$PROJECT_DIR"
git init # ボイラーテンプレートが git init 済みでない場合
git add -A
git commit -m "feat: プロジェクト初期化(ボイラーテンプレート + AIテンプレート適用)"
4.2 完了メッセージ
以下を表示する:
✅ プロジェクトの初期化が完了しました!
📁 プロジェクト: {PROJECT_DIR}
🛠 技術スタック: {選定した技術スタック}
📝 要件定義書: doc/input/rdd.md
🚀 次のステップ:
1. 新しいプロジェクトで Claude Code を起動してください:
cd {PROJECT_DIR} && claude
2. /session-start でセッションを開始してください
3. /task-list でタスクを計画してください
4.3 テンプレートソースの永続化確認
Phase 0 で新たにテンプレートパスを検出/指定した場合:
💡 ai-template のパスを保存しますか?
保存先: ~/.claude/ai-template-path
次回から自動検出されます。
出力
- 新規プロジェクトディレクトリ(ボイラーテンプレート + AIテンプレート適用済み)
doc/input/rdd.md(壁打ちの成果が反映済み)- 初期コミット
品質チェックリスト
- rdd.md の「AI用事実ブロック」が埋まっている(技術スタック/ターゲット環境/制約)
- project-design-language の基本方針(誰のため/北極星/メタファー)が埋まっている(またはスキップ理由が rdd.md に記録済み)
- .claude/skills/ がコピーされ、スキル一覧で認識される
- CLAUDE.md がプロジェクトルートに存在する
- .gitignore にセキュリティ関連(.env等)が含まれている
- ボイラーテンプレートの依存パッケージがインストール済み
- 初期コミットが作成されている
自己評価
- 成功自信度: (1-10)
- 一言理由: {短く理由を記載}
トラブルシューティング
テンプレートソースが見つからない
# 手動でパスを設定
echo "/path/to/ai-template" > ~/.claude/ai-template-path
ボイラーテンプレートのCLIが対話式で自動実行できない
- ユーザーに別ターミナルでの手動実行を案内する
- 完了後にこのスキルの Phase 3 から再開する
既存プロジェクトにAIテンプレートだけ適用したい
- Phase 2 をスキップして、Phase 0 → Phase 1 → Phase 3 → Phase 4 の順で実行する
- 「既存プロジェクトにテンプレートを適用したい」と伝えればAIが判断する