cd .blueprint-flow && git pull origin main && cd ..
./.blueprint-flow/scripts/update.sh

git -C .blueprint-flow status

git -C .blueprint-flow add -A
git -C .blueprint-flow commit -m "説明"

git -C .blueprint-flow push origin main

git add .blueprint-flow
git commit -m "Update blueprint-flow submodule"

./scripts/blueprint-db-cli.sh overview
./scripts/blueprint-db-cli.sh progress

1. アプリの種類は？ (シンプル / 認証あり / チーム共有型)
2. 主要機能は？ (CRUD基本 / +カテゴリ機能 / +検索機能 / カスタム)

{
  "description": "アプリの概要説明",
  "features": [
    {
      "id": "F001",
      "name": "機能名",
      "description": "機能説明",
      "priority": "必須/任意",
      "depends_on": ["data/tables/tasks"]
    }
  ],
  "tables": [
    {"slug": "tasks", "name": "タスク", "description": "タスク情報を保存"}
  ],
  "requirements": ["要件1", "要件2"],
  "non_goals": ["対象外1", "対象外2"],
  "tech_stack": {
    "backend": "Laravel 12",
    "frontend": "Livewire 4 + Alpine.js",
    "css": "Tailwind CSS 4 + daisyUI 5",
    "database": "SQLite"
  }
}

// ✅ 良い例: ページ単位でまとめる
{
  "features": [
    {
      "id": "F001",
      "name": "タスク管理ページ",
      "description": "タスクの一覧表示・作成・完了切替・削除ができる",
      "priority": "必須",
      "page": "/tasks",
      "operations": ["一覧表示", "新規作成", "完了/未完了切替", "削除"]
    }
  ]
}

AskUserQuestion:
「{テーブル名}テーブルを以下の構成で作成します:

【カラム】
| カラム | 型 | 説明 |
|--------|-----|------|
| id | bigint | 主キー |
| title | string(255) | タスク名 |
| completed | boolean | 完了フラグ |
| timestamps | - | 作成・更新日時 |

【開発用シーダー】
- 買い物に行く (未完了)
- レポートを書く (完了)
- ジムに行く (未完了)

よろしいですか？」

AskUserQuestion:
「{ページ名}のレイアウトです:

┌─────────────────────────────────────┐
│  header: Todo App                   │
├─────────────────────────────────────┤
│  [新しいタスクを入力...] [追加]      │
├─────────────────────────────────────┤
│  ☑ タスク1 (打消線)        [削除]   │
│  ☐ タスク2                 [削除]   │
└─────────────────────────────────────┘

このレイアウトでよいですか？」

Categories: core, data, ui, action

Types:
  - core: overview, const
  - data: tables (シーダー定義を含む)
  - ui: pages, partials, layouts
  - action: sync, async, scheduled

// ui/pages/todo-index
{
  "route": "/",
  "depends_on": ["data/tables/tasks"],
  ...
}

// action/sync/create-task
{
  "depends_on": ["data/tables/tasks"],
  ...
}

// action/async/send-reminder
{
  "depends_on": ["data/tables/tasks", "data/tables/users"],
  ...
}

data/tables (依存なし)
    ↑
action/sync, action/async (tables に依存)
    ↑
ui/pages (tables, actions に依存可能)

./scripts/blueprint-db-cli.sh add core overview app-overview "アプリ概要" '{
  "description": "...",
  "features": [
    {"id": "F001", "name": "...", "description": "...", "priority": "必須"}
  ],
  "requirements": ["..."],
  "non_goals": ["..."],
  "tech_stack": {...}
}'

./scripts/blueprint-db-cli.sh add data tables tasks "tasksテーブル" '{
  "columns": [
    {"name": "id", "type": "bigint", "primary": true},
    {"name": "title", "type": "string", "nullable": false, "max": 255},
    {"name": "completed", "type": "boolean", "default": false},
    {"name": "timestamps", "type": "timestamps"}
  ],
  "indexes": [],
  "relations": [],
  "seeders": {
    "dev": [
      {"title": "買い物に行く", "completed": false},
      {"title": "レポートを書く", "completed": true},
      {"title": "ジムに行く", "completed": false}
    ]
  }
}'

{
  "seeders": {
    "dev": [
      {"_comment": "基本状態（一覧表示テスト用）", "title": "買い物に行く", "completed": false},
      {"_comment": "完了状態（完了表示テスト用）", "title": "レポートを書く", "completed": true},
      {"_comment": "長いタイトル（レイアウト確認用）", "title": "これは非常に長いタスク名でレイアウトが崩れないか確認", "completed": false},
      {"_comment": "最小データ（エッジケース）", "title": "a", "completed": false}
    ]
  }
}

./scripts/blueprint-db-cli.sh add ui pages todo-index "Todoメインページ" '{
  "route": "/",
  "component": "Pages/TodoIndex",
  "depends_on": ["data/tables/tasks"],
  "layout_ascii": "┌─────────────────────────────────────┐\n│  header: Todo App                   │\n├─────────────────────────────────────┤\n│  [新しいタスクを入力...] [追加]      │\n├─────────────────────────────────────┤\n│  ☑ タスク1 (打消線)        [削除]   │\n│  ☐ タスク2                 [削除]   │\n└─────────────────────────────────────┘",
  "modals": [],
  "operations": ["一覧表示", "新規作成", "完了切替", "削除"],
  "wireModel": ["tasks", "newTaskTitle"],
  "methods": ["mount", "addTask", "toggleComplete", "deleteTask"]
}'

┌───────────────────────────────────────────────────┐
│  Logo                  Search...           Avatar  │  ← fixed top bar
├───────────────┬───────────────────────────────────┤
│  Sidebar      │               Main Content        │
│  w-64         │                                   │
│  - Item 1     │  ┌─────────────────────────────┐  │
│  - Item 2     │  │ Content Area               │  │
│  - Item 3     │  └─────────────────────────────┘  │
└───────────────┴───────────────────────────────────┘

┌─────────────────────────────────┐
│  Modal Title              [×]  │
├─────────────────────────────────┤
│  Form content here             │
│  [Input field               ]  │
│                                │
│         [Cancel] [Save]        │
└─────────────────────────────────┘

./scripts/blueprint-db-cli.sh add action sync create-task "タスク作成アクション" '{
  "depends_on": ["data/tables/tasks"],
  "description": "新しいタスクを作成する",
  "input": {
    "title": {"type": "string", "required": true, "max": 255}
  },
  "output": "Task",
  "events": ["TaskCreated"],
  "class": "App\\Actions\\CreateTask"
}'

./scripts/blueprint-db-cli.sh add action async send-reminder "リマインダー送信Job" '{
  "depends_on": ["data/tables/tasks", "data/tables/users"],
  "description": "期限が近いタスクのリマインダーを送信",
  "trigger": "TaskDueSoon event",
  "input": {
    "task_id": {"type": "int", "required": true}
  },
  "queue": "notifications",
  "class": "App\\Jobs\\SendReminder"
}'

./scripts/blueprint-db-cli.sh add action scheduled cleanup-old-tasks "古いタスク削除Command" '{
  "depends_on": ["data/tables/tasks"],
  "description": "30日以上前の完了タスクを削除",
  "schedule": "daily",
  "signature": "app:cleanup-old-tasks",
  "class": "App\\Console\\Commands\\CleanupOldTasks"
}'

./scripts/blueprint-db-cli.sh overview         # 全spec一覧
./scripts/blueprint-db-cli.sh progress         # status別の進捗
./scripts/blueprint-db-cli.sh available        # 実装可能なspec
./scripts/blueprint-db-cli.sh pending-review   # レビュー待ち
./scripts/blueprint-db-cli.sh needs-attention  # 要対応
./scripts/blueprint-db-cli.sh add <cat> <type> <slug> <name> '<json>'
./scripts/blueprint-db-cli.sh update <id> '<json>'
./scripts/blueprint-db-cli.sh status <id> <status>
./scripts/blueprint-db-cli.sh reviewed <id>    # レビュー完了マーク

draft → pending_review → approved → in_progress → impl_review → testing → done
              ↑                           ↓
              └────── needs_revision ←────┘

// 1. ページに遷移
mcp__playwright-mcp__playwright_navigate({
  url: "http://localhost:8000/path",
  headless: true
})

// 2. スクリーンショット取得
mcp__playwright-mcp__playwright_screenshot({
  name: "page-name_state",
  savePng: true,
  fullPage: true
})

// 3. 終了（必須）
mcp__playwright-mcp__playwright_close()