Detailed Design Workflow

詳細設計・完全ワークフロー (v2.9)

基本設計書を入力として、詳細設計書を作成し、モックアップ生成とテスト設計までを一貫して行うワークフロー。

入力

$ARGUMENTS（基本設計書のパス）

全体フロー

Phase規約: workflow-phase-convention skill を参照

Phase 0: ドキュメント計画

1. 基本設計書を分析し、必要なサブ機能とドキュメントを特定
2. 機能タイプに応じて必須ドキュメントを判定（下表参照）
3. ドキュメント一覧をユーザーに提示し承認を得る

機能タイプ別 必須設計書

共通設計書（機能群ごとに1つ）

Phase 0.5: 影響分析【追加仕様時】

トリガー: 既存の詳細設計書・Issue・コードが存在する場合

ユーザー確認オプション: 1. 続行 / 2. 調整 / 3. 中断（番号選択）

Phase 1: 設計書作成

detailed-design-writer エージェントが各サブ機能に対して設計書を作成。

テンプレート: detailed-design-templates skill を参照

Phase 1.5: 検証 & モックアップ

ASCII禁止チェック（BLOCKING）

grep -r -l '┌\|┐\|└\|┘\|│\|─' docs/designs/detailed/{機能名}/**/画面設計書.md
# → 0件であること

モックアップ生成

ツール: wireframe-generator skill を使用

1. 画面設計書から Wireframe DSL を生成
2. bun run generate.ts で mockup.html 等を生成
3. Playwrightでスクリーンショット撮影
4. 画面設計書に画像埋め込み

生成対象:

• mockup.html (Desktop)
• mockup-mobile.html (Mobile, 固定幅375px)
• mockup-error.html

Phase 2: 品質保証ループ

Phase 2.5: ユーザー承認ゲート

共通仕様: approval-gate skill を参照

Phase 3: 成果物作成 & Issue化

⚠️ 責任分離（重複防止）

Issue粒度ルール

作成フロー

Step 3.1: テスト項目書作成

test-spec-writer エージェントに以下を指示：

MUST DO:
- テスト項目書を {出力パス} に作成する
- 設計書のテスト観点を網羅する

MUST NOT DO:
- GitHub Issue を作成しない（Issue作成は後続ステップで行う）
- gh コマンドを実行しない
- 設計書内の TASK-XXX を Issue 化しない

Step 3.2-3.4: Issue作成（重複チェック必須）

# Issue作成前に既存Issueを確認
gh issue list --repo $REPO --search "{機能ID}" --json number,title

# 重複がなければ作成
gh issue create --title "..." --body "..."

Step 3.5: Sub-issue連携

GraphQL API: github-graphql-api skill を参照

テンプレート: detailed-design-templates skill を参照

チェックリスト

Phase 1 完了条件

• 全サブ機能に 詳細設計書.md が存在
• 全サブ機能に バックエンド設計書.md が存在
• 画面機能に 画面設計書.md と フロントエンド設計書.md が存在
• 共通フォルダに DB/インフラ/セキュリティ設計書が存在

Phase 1.5 完了条件

• ASCII罫線チェック: 0件
• 全画面に mockup.html / mockup-mobile.html / mockup-error.html が存在

Phase 3 完了条件

• Epic Issueが作成されている
• 各子Issueが200行以下・3ファイル以下
• 依存関係がMermaid形式で記述されている
• 子IssueがEpicのSub-issueとして登録されている
• ドキュメント更新IssueがSub-issueとして登録されている

Phase 3.5: 次ステップ選択【必須】

共通仕様・出力形式: approval-gate skill の「ワークフロー完了後の次ステップ選択」を参照

サーキットブレーカー

参考スキル

変更履歴