新規プロジェクトを AI と協働で立ち上げる際の手順を定義する. 各フェーズを順番に進め,成果物を確定させてから次のフェーズに移ること.
| フェーズ | やること | 成果物 |
|---|---|---|
| 方針決定 | プロジェクトの目的・スコープを決める | PLAN_01_要件定義書.md |
| 技術選定 | 言語・フレームワーク・インフラを決める | ENV_01_技術スタック.md |
| 環境構築 | 開発環境のセットアップ手順を整備する | ENV_02_環境構築手順.md,ENV_03_管理者用環境構築手順.md |
| 仕様設計 | アーキテクチャ・データモデル・画面設計を決める | SPEC_01_*.md |
| 規約整備 | 技術スタックに応じたコーディング規約を作る | GUIDE_*_*.md |
| 開発計画 | ステップを分割し,開発順序を決める | PLAN_02_開発ステップ.md |
| 実装開始 | 開発計画に沿って実装を進める | ソースコード |
プロジェクトの全体像を明確にする.
PLAN_01_要件定義書.md要件に基づいて技術スタックを決定する.
ENV_01_技術スタック.md開発環境を構築し,手順をドキュメント化する.初回のみの管理者作業と,メンバーが繰り返し行う構築手順を分けて整備する.
git — バージョン管理(GUIDE_04 で運用ルールを定義)gh — GitHub CLI(PR 作成・マージ等に使用)main にするため,リポジトリの初期化には git init -b main を使用すること./sync-template を実行する(git リモートの登録は不要)..gitignore の作成,Dockerfile や devcontainer.json 等の構築用ファイルの作成ENV_02_環境構築手順.md — メンバーの参加時や環境の再構築時に使う手順ENV_03_管理者用環境構築手順.md — プロジェクト作成時に一度だけ行う初期設定(リポジトリ作成,外部サービスの設定等)アプリケーションの設計を行う.
SPEC_01_*.md(プロジェクトの規模に応じて複数ファイルに分割)技術スタックに応じたコーディング規約やプロジェクト固有のガイドを作成する. 汎用ガイド(GUIDE_01〜05)は本テンプレートに含まれている.ここではプロジェクト固有の規約を追加する.
GUIDE_06 コーディング規約 — 命名規則,フォーマット,import 順序,型の使い方,コメントの書き方,コード内ドキュメントの規則GUIDE_07 ディレクトリ構造規則 — プロジェクトのディレクトリ構成とファイル配置ルールGUIDE_08 テスト方針 — テストの種類,粒度,実行タイミング,カバレッジ基準,モック方針,テストファイルの配置規則GUIDE_09 エラーハンドリング方針 — エラーの分類,処理方法,ログ出力の方針.claude/agents/refactorer.md の判断基準を共通ルールとして使用する/implement で定義済みのため,別途作成しない実装の順序とステップを決定する.
PLAN_02_開発ステップ.md開発計画に沿って AI と協働で実装を進める.
CLAUDE.md は AI が会話開始時に最初に読むファイルであり,プロジェクトの引継ぎ情報を一元管理する.
AI は毎回新しい会話で始まるため,このファイルが唯一の継続的な文脈となる.