---

name: project-init description: "SDD対応プロジェクトの初期セットアップ。Git/GitHubリポジトリ作成、.claude/ディレクトリ構成（agents, commands, hooks, skills, settings.json）、CLAUDE.md、README.md の雛形生成。新しいプロジェクトを始めるときに使う。"

Project Init

新しいプロジェクトのSDD対応初期セットアップを行うスキル。

ワークフロー

1. プロジェクトディレクトリ作成

mkdir -p /Users/satokeita/dev/<project-name>
cd /Users/satokeita/dev/<project-name>
git init && git branch -m main

2. CLAUDE.md 作成

以下を含む:

• プロジェクト概要（ユーザー、提供価値、ユースケース）
• アーキテクチャ構成
• 技術スタック
• 開発コマンド
• SDD ワークフロー説明

3. .claude/ ディレクトリ構成

.claude/
├── settings.json       # hooks設定
├── agents/             # サブエージェント定義
├── commands/           # カスタムコマンド（sdd-workflow等）
├── hooks/              # セッション開始、pre/post実装チェック
└── skills/             # プロジェクト固有スキル

settings.json テンプレート

→ references/config-settings.json を参照してコピーする。

必須 hooks

• session-start.sh: SDD状態サマリー表示（specs数、ブランチ情報）
• pre-implementation-check.sh: Write/Edit前のSpec存在確認
• post-spec-update.sh: Write/Edit後の通知

agents テンプレート

プロジェクトの技術スタックに応じて作成。各agentに:

• name, description, model, color
• 専門領域、プロジェクト構成理解、開発原則、品質チェックリスト

4. GitHubリポジトリ作成

git add -A && git commit -m "Initial commit: <project-name> project setup"
gh repo create <project-name> --private --source=. --push

5. README.md

プロジェクト概要、技術スタック、評価領域などを記載。

参考プロジェクト

history-quiz-appの.claude/構成: /Users/satokeita/dev/history-quiz-app/.claude/

⚠️ よくある落とし穴

• hooksスクリプトに chmod +x を忘れる: hooks/ 配下のシェルスクリプトに実行権限を付与しないと、Claude Code のフック実行時にサイレントに失敗する。作成直後に必ず chmod +x する
• プロジェクトディレクトリの配置場所を間違える: すべてのプロジェクトは /Users/satokeita/dev/ 配下に作成する。別の場所に作ると他のスキルやスクリプトのパスが通らない
• GitHubリポジトリのデフォルト公開設定: gh repo create のデフォルトは private。public にする場合は明示的に --public を指定する。意図せず公開しないよう注意
• settings.json の hooks matcher 記述ミス: "matcher": "Write|Edit" のようにパイプで区切る形式。正規表現と混同してカンマ区切りや配列にすると動かない