d-market-doc-gen
AIコーディングエージェントが実装するための仕様書・設計書を対話的に生成する Claude Code プラグイン。
設計思想
作るプロセスは人間と一緒に、成果物はAI向けに。
- 対話で練り上げる: 全スキルがヒアリング（AskUserQuestion）を起点に、曖昧な回答を深掘りしながら仕様を固める。生成後もレビュー＆修正サイクルで人間と一緒に仕上げる
- 成果物はAIエージェント向け: 生成されるドキュメントは「AIエージェントが読んで実装する」ことに特化。人間向けの承認フロー・ステークホルダー管理・担当者割り当て・変更履歴は含まず、技術的な制約・受入基準・変更禁止事項などAIが正確に実装するために必要な情報に絞る
スキル一覧
| スキル | 説明 | テンプレート数 | |:-------|:-----|:-------------| | draft-spec | 叩き台を素早く生成し、人間と一緒に練り上げる | 1 | | req-spec | 要件・プロダクト定義（AI PRD / SRS / ストーリーマップ / ブリーフ） | 4 | | arch-spec | 設計・アーキテクチャ（RFC / テクニカルデザイン / Arc42 / SDD / 仕様探索） | 5 | | detail-spec | 設計仕様書・実装仕様書。深掘りモードとテンプレートモードの2モード | 4 | | impl-spec | AI実装駆動（AI実装仕様書 / クイックスペック / 実装計画 / タスクリスト） | 4 | | ops-spec | 運用・品質・プロジェクト基盤 | 8 | | feature-spec | 機能単位の仕様書生成。ドメインごとに分割出力 | 5 | | api-spec | API仕様書。Markdown / OpenAPI / GraphQL対応 | 3 | | system-design | システム設計書。ADR / C4モデル対応 | 3 |
draft-spec
議論の出発点となる「叩き台」を素早く生成する。他スキルとはフローが逆で、先にドラフトを出して人間と一緒に練り上げる。
- ヒアリングは最小限（バッチ1回まで）。足りない情報は推測で埋め、
⚠️仮定:マーカーで明示 - 決めきれない論点は「オープンクエスチョン」として列挙し、レビューで一緒に潰す
- 固まったら req-spec / arch-spec / detail-spec 等での本仕様化を提案
req-spec
| ID | テンプレート | 用途 | |:---|:-----------|:-----| | A1 | AI PRD | AI/MLプロダクトのPRD。モデル要件・倫理・ガードレール・HITL設計 | | A2 | SRS | IEEE 830/ISO 29148準拠。機能要件・非機能要件・制約・検証方法 | | A3 | ユーザーストーリーマップ | ストーリー一覧 + GIVEN/WHEN/THEN受入基準 | | A4 | プロダクトブリーフ | 1ページ概要。ビジョン・問題・解決策・成功指標 |
arch-spec
| ID | テンプレート | 用途 | |:---|:-----------|:-----| | B1 | RFC | 技術提案書。問題→提案→代替案→トレードオフ→影響範囲・実装計画 | | B2 | テクニカルデザインドキュメント | 詳細技術設計。データモデル・シーケンス図・API契約・エラー戦略 | | B3 | Arc42 | 12セクション構成のアーキテクチャ文書 | | B4 | SDD | IEEE 1016/ISO 42010準拠。設計ビューポイント・根拠・トレーサビリティ | | B5 | 仕様探索ワークシート | AIとの対話で仕様を段階的に深掘り |
detail-spec
深掘りモード（適応的質問→ドラフト→レビュー＆修正サイクル）とテンプレートモード（固定バッチ質問→素早く生成）の2モードに対応。
| ID | テンプレート | 用途 | |:---|:-----------|:-----| | B6 | 設計仕様書 | 設計判断・境界・振る舞い・エッジケースを網羅。解釈の余地がない精度の設計 | | C5 | 実装仕様書 | 設計意図+コードレベル実装詳細。ファイル構成・関数シグネチャ・処理フロー・エラー処理 | | C6 | 実装前コードベース探索 | 実装仕様書の前段階。コードベースを探索し技術的事実を収集・記録 | | C7 | タスクリスト | 実装仕様書からタスク分解。blockedBy・並列可否・完了基準を明示 |
impl-spec
| ID | テンプレート | 用途 | |:---|:-----------|:-----| | C1 | AI実装仕様書（フェーズ型） | フェーズ順の実装仕様。各フェーズに受入基準 | | C2 | クイックスペック | 1ファイル完結。バグ修正・小機能追加・リファクタ用 | | C3 | 実装計画 | 技術コンテキスト→フェーズ→アーティファクト | | C4 | タスクリスト | 仕様/計画からタスク分解。依存順・並列可否・完了基準 |
ops-spec
| ID | テンプレート | 用途 | |:---|:-----------|:-----| | D1 | テスト計画 | テスト戦略・スコープ・テストケース・自動化方針 | | D2 | マイグレーション計画 | 移行戦略・ステップ・ロールバック・データ検証 | | D3 | デプロイメント計画 | リリース手順・環境・チェックリスト・ロールバック | | D4 | ランブック | アラート対応・障害復旧・定期作業手順 | | D5 | インシデント・ポストモーテム | 障害報告。タイムライン→根本原因→影響→対策 | | D6 | SLO/エラーバジェット定義 | サービスレベル目標・エラーバジェット・バーンレート | | E1 | プロジェクトコンテキスト | CLAUDE.md / AGENTS.md 形式。スタック・構造・ルール・ワークフロー | | E2 | プロジェクト憲章 | プロジェクトの原則・技術基準・品質基準・変更禁止事項 |
feature-spec
機能単位で仕様書を生成し、ドメインごとにファイルを分割して出力する。
| テンプレート | 用途 | |:-----------|:-----| | index | 機能の概要・背景・スコープ・全体フロー・仕様一覧 | | frontend-spec | 画面構成・コンポーネント・フォーム・状態管理・レスポンシブ・アクセシビリティ | | backend-spec | APIエンドポイント・ビジネスロジック・認証認可・バッチ処理・外部連携 | | table-spec | テーブル定義・制約・インデックス・リレーション | | PRD | プロダクト要件定義書 |
出力例:
docs/{feature-name}/
├── index.md
├── {domain-a}-spec.md # フロントエンド仕様
├── {domain-b}-spec.md # バックエンド仕様
└── {domain-c}-spec.md # DB仕様api-spec
REST API / GraphQL の仕様書を複数フォーマットで生成する。
| フォーマット | 用途 | |:-----------|:-----| | Markdown | 人間が読めるAPI仕様書。シーケンス図付き | | OpenAPI 3.1 | 機械可読なREST API定義。$refによるスキーマ再利用 | | GraphQL | SDL構文によるスキーマ定義。docstring付き |
system-design
システム全体の設計ドキュメントを生成する。
| フォーマット | 用途 | |:-----------|:-----| | システム設計書 | アーキテクチャ・コンポーネント・データフロー・非機能要件 | | ADR | 個別の設計判断を記録。代替案・トレードオフ・根拠 | | C4モデル | Context → Container → Component の階層ビュー |
共通ワークフロー
全スキル共通の対話フロー:
1. テンプレート選択（キーワード自動判定 or ユーザー選択）
↓
2. ヒアリング（バッチ質問 + 曖昧シグナルの深掘り）
↓
3. テンプレートにヒアリング結果を反映して生成・書き出し
↓
4. レビュー＆修正サイクル（「OK」まで人間と一緒に練り上げる）draft-spec のみ逆フロー（最小ヒアリング → 即ドラフト → レビューで練り上げ）。
ディレクトリ構成
plugins/doc-gen-plugin/
└── skills/
├── draft-spec/ # 叩き台
├── req-spec/ # A1-A4
├── arch-spec/ # B1-B5
├── detail-spec/ # B6, C5-C7
├── impl-spec/ # C1-C4
├── ops-spec/ # D1-D6, E1-E2
├── feature-spec/
├── api-spec/
└── system-design/
（各スキル: SKILL.md + assets/templates/。draft-spec 以外は references/hearing-patterns.md も持つ）ライセンス
MIT
