スペック駆動開発 テンプレート

チケット駆動・マーメイド図を活用した開発フローのテンプレートリポジトリです。

クイックスタート

1. このリポジトリをコピー（clone または "Use this template"）
2. 利用手順書 に従い環境変数を設定
3. ./scripts/verify-env.sh で検証
4. Cursor でプロジェクトを開き、要件を伝えて開発開始

構成

.
├── .cursor/rules/     # Cursor 用ワークフロー・ルール
├── docs/              # ドキュメント
│   ├── diagrams/      # 全体設計時のマーメイド図
│   ├── templates/     # チケットテンプレート等
│   ├── EXECUTION_PLAN.md
│   ├── ENV_SETUP_GUIDE.md  # 環境変数設定（Supabase/Vercel）
│   └── GETTING_STARTED.md  # 利用手順書
├── lib/supabase/      # Supabase クライアント（スキーマ対応）
├── scripts/
│   ├── verify-env.sh  # 環境変数検証スクリプト
│   ├── supabase-setup-schema.sh  # スキーマ作成支援
│   └── required-env.txt   # 必須環境変数一覧
├── .env.example
└── README.md

チケット管理

• Linear を使用
• 実装は必ずチケット番号を指定して進める

デプロイ（Web アプリの場合）

• ステージング: staging ブランチ → Vercel プレビュー
• 本番: main ブランチ → Vercel 本番

詳細は docs/GETTING_STARTED.md を参照してください。