┌─────────────────────────────────────────────────┐
│  1. 要件ヒアリング                              │
│     - ユーザーからの自然言語入力を受け取る      │
│     - 不明点があれば質問する                    │
│                                                 │
│  2. ユーザーストーリー生成                      │
│     - ペルソナ、目的、価値、理由を明確化        │
│     - 暗黙の要件を明示化                        │
│                                                 │
│  3. EARS記法でAC生成                            │
│     - WHEN/GIVEN/THEN形式で構造化               │
│     - エッジケースを考慮                        │
│     - セキュリティ/パフォーマンス要件を補完     │
│                                                 │
│  4. ユーザー確認                                │
│     「この要件で進めますか？」                  │
│     - 「次に進んで」→ Phase 2へ                 │
│     - 「修正して」→ 内容を調整                  │
└─────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────┐
│  1. 既存コードベース分析                        │
│     - 関連する既存コードを探索                  │
│     - 使用技術スタック確認                      │
│     - 既存パターンとの整合性確認                │
│                                                 │
│  2. 技術設計生成                                │
│     - データフロー図（Mermaid）                 │
│     - インターフェース定義（TypeScript）        │
│     - API設計（必要に応じて）                   │
│                                                 │
│  3. アーキテクチャ決定                          │
│     - 複数アプローチがある場合は選択肢を提示    │
│     - トレードオフを説明                        │
│                                                 │
│  4. ユーザー確認                                │
│     「この設計で進めますか？」                  │
│     - 「次に進んで」→ Phase 3へ                 │
│     - 「修正して」→ 設計を調整                  │
└─────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────┐
│  1. EPIC/Story/Subtask分割                      │
│     - 適切な粒度でSubtaskに分割                 │
│     - 1 Subtask = 1機能                         │
│     - 依存関係を整理                            │
│                                                 │
│  2. 実装順序の最適化                            │
│     - 依存関係に基づく順序付け                  │
│     - 基盤機能を先に配置                        │
│                                                 │
│  3. ファイル生成プレビュー                      │
│     - 生成するファイル一覧を表示                │
│     - 各ファイルの概要を説明                    │
│                                                 │
│  4. ユーザー確認                                │
│     「このタスク分割で進めますか？」            │
│     - 「次に進んで」→ ファイル生成              │
│     - 「修正して」→ 分割を調整                  │
└─────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────┐
│  生成ファイル:                                  │
│                                                 │
│  specs/{epic-id}/{epic-id}.md                   │
│  ├── ユーザーストーリー                         │
│  ├── EPICレベルAC                               │
│  └── 関連Storyへのリンク                        │
│                                                 │
│  specs/{epic-id}/{story-id}/{story-id}.md       │
│  ├── ユーザーストーリー                         │
│  ├── StoryレベルAC                              │
│  └── 関連Subtaskへのリンク                      │
│                                                 │
│  specs/{epic-id}/{story-id}/{subtask-id}.md     │
│  ├── ユーザーストーリー                         │
│  ├── EARS記法によるAC                           │
│  ├── 設計セクション（該当する場合）             │
│  └── テストケーステンプレート                   │
│                                                 │
│  一覧ファイル:                                  │
│  specs/epic-list.md                             │
│  specs/{epic-id}/story-list.md                  │
│  specs/{epic-id}/{story-id}/subtask-list.md     │
└─────────────────────────────────────────────────┘

- [ ] WHEN [トリガー・状況]
      GIVEN [前提条件]
      THEN [期待動作]
      AND [追加動作]

- [ ] WHILE [状態・プロセス]
      THE SYSTEM SHALL [必須動作]
      AND [関連動作]

- [ ] WHERE [機能・コンポーネント]
      IF [条件・状態]
      THE SYSTEM SHALL [対応動作]

「ユーザー認証機能のspecを作成して。OAuth対応、多要素認証を含めて」

## ユーザーストーリー

**ペルソナ**: エンドユーザー / 管理者
**目的**: セキュアにシステムにアクセスする
**価値**: 個人情報を保護しながら利便性を確保
**理由**: 不正アクセスを防ぎつつ、ログイン体験を向上させたい

## Acceptance Criteria（EARS記法）

### 基本認証

- [ ] WHEN ユーザーがログインを試行する際
      GIVEN 有効なメールアドレスとパスワードを入力した場合
      THEN システムはセッションを作成する
      AND ダッシュボードにリダイレクトする

- [ ] WHEN ユーザーがログインを試行する際
      GIVEN 無効な認証情報を入力した場合
      THEN システムはエラーメッセージを表示する
      AND 試行回数をカウントする

### OAuth認証

- [ ] WHEN ユーザーがOAuthプロバイダーでログインを選択した際
      GIVEN Google/GitHubアカウントで認証した場合
      THEN システムはアカウントを連携する
      AND 初回の場合はユーザープロファイルを作成する

### 多要素認証

- [ ] WHEN MFA有効ユーザーがパスワード認証を完了した際
      GIVEN 正しいパスワードを入力した場合
      THEN システムはMFAコード入力画面を表示する
      AND 認証アプリまたはSMSでコードを送信する

この要件で進めますか？

/spec 開始
    │
    ├─ Phase 1: Requirements Discovery
    │
    ├─ Phase 2: Design Exploration
    │
    ├─ Phase 3: Task Breakdown
    │       │
    │       └─ ユーザー確認後 → /branch 発火
    │          ブランチ: spec/{subtask-id}-{description}
    │
    ├─ ファイル生成
    │   - specs/{epic-id}/{epic-id}.md
    │   - specs/{epic-id}/{story-id}/{story-id}.md
    │   - specs/{epic-id}/{story-id}/{subtask-id}.md
    │   - 各 *-list.md ファイル
    │
    └─ 完了時 → /pr 発火
        PR: 仕様レビュー用

Claude: 仕様ファイルを生成する前に、ブランチを作成します。

        ブランチ名: spec/001-01-01-user-auth
        ベース: main

        作成してよいですか？

Claude: 仕様ファイルの生成が完了しました。

        PRを作成しますか？
        タイトル: spec: ユーザー認証機能の仕様策定

        ## Summary
        - 001-01-01 の仕様を策定
        - specs/001-environment-setup/001-01-common-config/001-01-01-*.md を作成

        ## レビュー観点
        - [ ] ユーザーストーリーが明確か
        - [ ] ACがEARS記法で記述されているか

/spec（仕様策定）
    ├─ /branch 発火（spec/*）
    ├─ ファイル生成
    └─ /pr 発火（仕様レビュー）
        ↓ マージ後
spec-workflow（実装）
    ├─ /branch 発火（impl/*）
    ├─ TDD実装
    └─ /pr 発火（実装レビュー）