// PRD、ADR、Design Doc、UI Spec、作業計画書の作成を支援。技術ドキュメントの作成・レビュー時、または「UI Spec/画面設計/コンポーネント分解」が言及された時に使用。
| name | documentation-criteria |
| description | PRD、ADR、Design Doc、UI Spec、作業計画書の作成を支援。技術ドキュメントの作成・レビュー時、または「UI Spec/画面設計/コンポーネント分解」が言及された時に使用。 |
| 条件 | 必要ドキュメント | 作成順序 |
|---|---|---|
| 新機能追加（バックエンド） | PRD → [ADR] → Design Doc → 作業計画書 | PRD承認後 |
| 新機能追加（フロントエンド/フルスタック） | PRD → UI Spec → [ADR] → Design Doc → 作業計画書 | Design Doc前にUI Spec |
| ADR条件該当（下記参照） | ADR → Design Doc → 作業計画書 | 即座に開始 |
| 6ファイル以上 | ADR → Design Doc → 作業計画書（必須） | 即座に開始 |
| 3-5ファイル | Design Doc → 作業計画書（推奨） | 即座に開始 |
| 1-2ファイル | なし | 作業計画書なしの実装サイクル |
type A = { b: { c: { d: T } } }
目的: ビジネス要件とユーザー価値を定義
含むもの:
スコープ: ビジネス要件、ユーザー価値、成功指標、ユーザーストーリー、優先順位のみ。技術実装詳細はDesign Doc、技術選定理由はADR、フェーズとタスク分解は作業計画書に記載。
目的: 技術的決定の理由と背景を記録
含むもの:
スコープ: 決定事項、根拠、選択肢比較、アーキテクチャへの影響、原則的な指針のみ。実装手順とコード例はDesign Doc、スケジュールと担当割り当ては作業計画書に記載。
目的: フロントエンド機能のUI構造、画面遷移、コンポーネント分解、インタラクション設計を定義
含むもの:
スコープ: 画面構造、遷移、コンポーネント分解、インタラクション設計、ビジュアル受入条件のみ。技術実装とAPIコントラクトはDesign Doc、テスト実装はテストスケルトン生成出力、スケジュールは作業計画書に記載。
必須構造要素:
プロトタイプコードの取り扱い:
docs/ui-spec/assets/{feature-name}/に配置目的: 技術的実装方法を詳細定義
含むもの:
必須構造要素:
変更影響マップ:
変更対象: [コンポーネント/機能]
直接影響: [ファイル/関数]
間接影響: [データ形式/処理時間]
波及なし: [影響を受けない機能]
インターフェース変更マトリクス:
既存: [メソッド名]
新規: [メソッド名]
変換必要性: [あり/なし]
互換性確保: [方法]
スコープ: 技術実装方法、インターフェース、データフロー、受入条件、検証戦略のみ。技術選定理由はADR、スケジュールと担当は作業計画書に記載。
目的: 実装タスクの管理と進捗追跡
含むもの:
スコープ: タスク分解、依存関係、スケジュール、検証戦略の要約、進捗追跡のみ。技術的な根拠はADR、設計詳細はDesign Docに記載。
フェーズ分割基準（Design Docの実装アプローチに応じて適用）:
垂直スライス選択時:
水平スライス選択時:
ハイブリッド選択時:
全アプローチ共通: 最終フェーズは常に品質保証（受入条件達成、全テストパス、品質チェック）。各フェーズの検証手法はDesign Docの検証戦略に従う。
タスク完了定義の3要素:
| ドキュメント | パス | 命名規則 | テンプレート |
|---|---|---|---|
| PRD | docs/prd/ | [機能名]-prd.md | prd-template.md |
| ADR | docs/adr/ | ADR-[4桁]-[タイトル].md | adr-template.md |
| UI Spec | docs/ui-spec/ | [機能名]-ui-spec.md | ui-spec-template.md |
| UI Specアセット | docs/ui-spec/assets/{feature-name}/ | プロトタイプコードファイル | - |
| Design Doc | docs/design/ | [機能名]-design.md | design-template.md |
| 作業計画書 | docs/plans/ | YYYYMMDD-{type}-{description}.md | plan-template.md |
| タスクファイル | docs/plans/tasks/ | {plan-name}-task-{number}.md | task-template.md |
※作業計画書は.gitignoreで除外
Proposed → Accepted → Deprecated/Superseded/Rejected
各ドキュメントで必須の図表（mermaid記法使用）：
| ドキュメント | 必須図表 | 目的 |
|---|---|---|
| PRD | ユーザージャーニー図、スコープ境界図 | ユーザー体験と範囲の明確化 |
| ADR | 選択肢比較図（必要時） | トレードオフの視覚化 |
| UI Spec | 画面遷移図、コンポーネントツリー図 | 画面フローとコンポーネント構造の明確化 |
| Design Doc | アーキテクチャ図、データフロー図 | 技術構造の理解 |
| 作業計画書 | フェーズ構成図、タスク依存関係図 | 実装順序の明確化 |
テンプレートはreferences/ディレクトリにあります：
サブエージェントのタスク分担と連携を調整。規模判定と自律実行モードを制御。大規模タスク分割時に使用。
Coordinates subagent task distribution and collaboration. Controls scale determination and autonomous execution mode.
Guides PRD, ADR, Design Doc, UI Spec, and Work Plan creation. Use when creating or reviewing technical documents, or when "UI spec/screen design/component decomposition" is mentioned.
コードの品質問題、アンチパターン、可読性を検査。機能実装、コードレビュー、リファクタリング時に使用。
Detects code smells, anti-patterns, and readability issues. Use when implementing features, reviewing code, or refactoring.
Provides project-specific prerequisites for AI execution accuracy — domain constraints, development phase, directory conventions, external resource access methods. Use when the session starts, when checking project structure, or when a task references domain rules or external resources outside the repository.