doc-flow について
仕様駆動開発（SDD）チーム向けのワークフロールーティングスキルです。文書自体は作成せず、適切なスキルの選択、進捗報告、上流文書の方針遵守を支援します。
主な機能
- 01タスクを適切な文書スキルへ振り分け
- 02成果物を確認して進行状況を報告
- 03テンプレート必須項目を検査し不足を提示
- 04次の作業と並行作業を提案
- 05上流文書と変更管理の方針を適用
- 06設定された有効レイヤーを反映
活用シーン
- 01タスクに使う文書スキルの選定
- 02SDD プロジェクトの段階と次の作業の確認
- 03文書に不足する必須セクションの発見
- 04既存プロジェクトの文書作業の計画
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/doc-flowを入力して読み込まれたか確認します。
詳細
doc-flow
目的
仕様駆動開発（SDD）ワークフローを案内します。タスクに適したスキルを示し、現在の進行位置を報告し、上流成果物に関するポリシーを適用します。doc-flow は成果物自体を作成しません。成果物は各スキルが作成します。
レイヤー：横断的（上流レイヤーなし。8 つすべてのレイヤーに案内します）。
正式な仕様：${CLAUDE_PLUGIN_ROOT}/framework/SPEC_DRIVEN_DEVELOPMENT_GUIDE.md。
使用するタイミング
| 状況 | アクション |
|---|---|
| どのスキルが適切か分からない | doc-flow（このスキル）を使用 |
| 新規プロジェクト | 最初に ../project-init/SKILL.md を使用し、その後 doc-flow を使用 |
| 既存コードに SDD を導入する | 最初に ../project-adopt/SKILL.md を使用 |
| 公開済みの成果物を編集する | 直線的なフローではなく、../doc-chg/SKILL.md を使用 |
| 単一レイヤーをエンドツーエンドで生成する | そのレイヤーの -autopilot |
8 レイヤーのフロー
BRD (1) → PRD (2) → EARS (3) → BDD (4) → ADR (5) → SPEC (6) → TDD (7) → IPLAN (8) → Code
| レイヤー | 成果物 | 目的 | 基本スキル |
|---|---|---|---|
| 1 | BRD | ビジネス要件 | doc-brd |
| 2 | PRD | 製品要件と KPI | doc-prd |
| 3 | EARS | WHEN-THE-SHALL 形式の正式な要件 | doc-ears |
| 4 | BDD | Gherkin テストシナリオ | doc-bdd |
| 5 | ADR | アーキテクチャ上の決定 | doc-adr |
| 6 | SPEC | 技術仕様 | doc-spec |
| 7 | TDD | テストケースの定義としきい値 | doc-tdd |
| 8 | IPLAN | 実行可能な実装計画 | doc-iplan |
各レイヤーには、4 つのスキルがあります。基本スキル（作成）、-autopilot（エンドツーエンド）、-audit（ゲートレポート）、-fixer（監査の修正を適用）。
スキルの選択
| 手元にあるもの | 必要なもの | 使用するスキル |
|---|---|---|
| なし | ビジネス要件 | doc-brd |
| BRD | 製品要件 | doc-prd |
| PRD | 正式な要件 | doc-ears |
| EARS | テストシナリオ | doc-bdd |
| BDD | アーキテクチャ上の決定 | doc-adr |
| ADR | 技術仕様 | doc-spec |
| SPEC | テストケースの定義 | doc-tdd |
| TDD | 実装計画 | doc-iplan |
| IPLAN | コード | 実装 |
| いずれかの段階 | 補足ドキュメント | doc-ref |
意図 → スキル（レイヤーが明確な場合は、動詞に基づいて選択します）：
| アクション | スキル |
|---|---|
| 作成／草案作成 | レイヤーの基本スキルまたは -autopilot |
| 監査／評価 | レイヤーの -audit |
| 修正／是正 | レイヤーの -fixer |
| 検証／トレース／リンク／孤立項目 | ../doc-validator/SKILL.md |
| 公開済みの成果物を変更する | ../doc-chg/SKILL.md + ../gate-check/SKILL.md |
| ロードマップ／フェーズ分け | ../adr-roadmap/SKILL.md |
| スキャフォールド／新規プロジェクト | ../project-init/SKILL.md |
| 導入／既存プロジェクト | ../project-adopt/SKILL.md |
| テーラリング／プロファイル | ../project-profile/SKILL.md |
| セキュリティ／脅威 | ../security-audit/SKILL.md |
ユーザーがスキル名を指定した場合は、そのスキルを直接実行します。
現在の状況と次のステップ
現在の状況。 docs/<NN>_<X>/ をスキャンして成果物を確認し、各ドキュメント管理欄の Status を読み取ります（ほとんどのレイヤーは Draft → In Review → Approved、IPLAN は Draft → In Progress → Completed）。プロジェクトの有効なレイヤーに対応付けます（Adaptation を参照）。現在の位置と進捗を報告します。進捗 ＝ 最終ステータスの成果物数 ÷ 有効なレイヤー数です。
テンプレート準拠チェック（必須）。 見つかったすべての成果物について、${CLAUDE_PLUGIN_ROOT}/framework/layers/<NN>_<X>/<TYPE>-TEMPLATE.yaml を読み込み、必須のトップレベルセクションがすべて ## 見出しとして存在することを確認します。欠落したセクションは Status にかかわらず逸脱の指摘事項として報告します。例：「BRD-01 は必須セクション 18 個中 6 個が欠落しています：…」。逸脱を「簡潔版」「文書化されたウォークスルー」「lint 固定」の例外として正当化しないでください。テンプレートは 1 つ、正規のセクション一覧も 1 つです。Lint の合格が示すのは構造上の要件の一部であり、テンプレートへの完全な準拠ではありません。不足を解消するため、doc-<layer>-fixer（再作成する場合は -autopilot）を推奨します。
次のステップ。 累積チェーンに従って次の成果物を推奨します（各レイヤーには前提条件が必要です）。優先順位は次のとおりです。
- P0 — 必須の上流成果物が欠落している場合、またはクリティカルパスの次のステップ。
- P1 — P0 のブロックが解除された後、次に着手可能なレイヤー。
- P2 — 任意／並行作業（追加の ADR、
doc-refによる補足など）。
並行作業の機会（共通の前提条件を持たない独立したトラック）を示し、それぞれに実行するスキルを明記します。
コンテキストのスキャン（作成前）。 対象タイプに関連する上流文書の候補を、関連性、トピックの一致度、新しさ、Approved ステータスに基づいて順位付けします。また、プロジェクトの用語（タイトル、見出し、用語集）を収集し、新しい文書で実際に使われている ID と一貫した用語を再利用できるようにします。
ユーティリティスキル
| スキル | 用途 |
|---|---|
../project-init/SKILL.md | 新しいプロジェクトのスキャフォールド作成（いずれかのレイヤーより前に実行） |
../project-adopt/SKILL.md | 既存のコードベースへの SDD の導入（ブラウンフィールド） |
../project-profile/SKILL.md | フローの調整（任意。.aidoc/profile.yaml を設定） |
../doc-naming/SKILL.md | ID／命名規則の定義（TYPE-NN、TYPE.NN.SS.xxxx） |
../doc-ref/SKILL.md | 自由形式の参考文書（BRD-REF／ADR-REF） |
../doc-validator/SKILL.md | 文書間の検証＋双方向のトレーサビリティ＋文章レビュー |
../review-team/SKILL.md | 監査／修正ツール／オートパイロット向けの複数ペルソナレビュー |
../quality-advisor/SKILL.md | 単一文書のリアルタイム作成ガイダンス |
../charts-flow/SKILL.md | Mermaid ダイアグラムとファイルの管理 |
../adr-roadmap/SKILL.md | ADR に基づく実装ロードマップ |
../security-audit/SKILL.md | セキュリティレビュー（OWASP／CWE、STRIDE） |
変更管理
公開済みの成果物への変更には、直線的なフローではなく CHG オーバーレイを使用します。../doc-chg/SKILL.md（および -autopilot／-audit／-fixer）が変更を分類（C1～C3／緊急）し、適切なゲートに振り分けます。../gate-check/SKILL.md がゲート（GATE-01／03／06／08／CODE、または framework/ の仕様変更には GATE-SPEC）を実行し、承認フォームを準備します。承認するのは人間です。スキルが承認することはありません。
上流成果物のポリシー
欠落している上流成果物を捏造しないでください。すべての成果物は、実在するビジネス／製品上の根拠にトレースできなければなりません。
| 状況 | 対応 |
|---|---|
| 上流成果物が存在する | 正確な ID で参照する |
| 必須の上流成果物が欠落している | スキップして報告し、先に作成するよう助言する |
| 任意の上流成果物が欠落している | タグに null を設定する |
| 該当しない | タグを省略する |
検証モデル
各スキル自体がバリデーターです（実行時コードはありません）。各成果物の作成後に、そのレイヤーの -audit を実行します。次へ進む前に、累積した上流タグが存在することを確認します（PRD→1 … IPLAN→7）。
適応
.aidoc/profile.yaml を読み込みます。active_layers に従ってください。無効化されたスキップ可能なレイヤー（BDD／ADR）は、クリティカルパス、進捗の分母、次のステップの推奨から除外します。不明なキーは無視してください。プロファイルがない場合は、8 レイヤーすべてのフローを使用します。
権威ある情報源：${CLAUDE_PLUGIN_ROOT}/framework/governance/ADAPTATION.md。
同梱ファイルの読み込み
スキルのパスには ${CLAUDE_PLUGIN_ROOT}/framework/… を使用します。CLAUDE_PLUGIN_ROOT
は Claude Code がインストール時に設定する 環境変数 であり、リテラルなフォルダー名ではありません。シェルでは展開されます（cat "$CLAUDE_PLUGIN_ROOT/framework/…"）。未設定の場合、framework/ バンドルはプラグインルートの skills/ と同じ場所に格納されています。
リテラルの ${CLAUDE_PLUGIN_ROOT} という文字列は決して開かないでください。
関連リソース
- 仕様ガイド：
${CLAUDE_PLUGIN_ROOT}/framework/SPEC_DRIVEN_DEVELOPMENT_GUIDE.md - レイヤーレジストリ：
${CLAUDE_PLUGIN_ROOT}/framework/registry/LAYER_REGISTRY.yaml - ID 標準：
${CLAUDE_PLUGIN_ROOT}/framework/governance/ID_NAMING_STANDARDS.md - トレーサビリティ：
${CLAUDE_PLUGIN_ROOT}/framework/governance/TRACEABILITY.md - ガバナンスコア：
${CLAUDE_PLUGIN_ROOT}/framework/governance/DOC_GOVERNANCE_CORE.md - 作成スタイル：
${CLAUDE_PLUGIN_ROOT}/framework/governance/AUTHORING_STYLE.md - レイヤーごとのガイダンス：
${CLAUDE_PLUGIN_ROOT}/framework/layers/NN_<X>/README.md