| name | doc-coauthoring |
| description | Guide users through a structured workflow for co-authoring documentation.
Triggers: 「ドキュメントを書いて」「仕様書を作成」「READMEを更新」「提案書を作って」「PRD」「設計ドキュメント」
Use when: Writing documentation, proposals, technical specs, decision docs, or similar structured content.
Workflow: Context Gathering → Refinement & Structure → Reader Testing
|
Doc Co-Authoring Workflow
構造化されたドキュメント共同作成ワークフロー。3つのステージを通じてユーザーをガイドする。
Stage 1: Context Gathering
（ステージ1：コンテキスト収集）
目標: ユーザーの知識とエージェントの知識のギャップを埋める。
初期質問
- ドキュメントの種類は？（技術仕様、提案書、決定文書等）
- 主な読者は？
- 読者に期待する反応は？
- テンプレートや特定のフォーマットはある？
- その他の制約やコンテキストは？
情報収集
- プロジェクト/問題の背景
- 関連するチーム議論やドキュメント
- 代替案が採用されない理由
- タイムライン制約
- 技術アーキテクチャや依存関係
終了条件
エッジケースやトレードオフについて質問できるようになったら、次のステージへ。
Stage 2: Refinement & Structure
（ステージ2：構造化と改善）
目標: セクションごとにブレインストーミング・キュレーション・反復的改善で構築。
各セクションの作業フロー
- Clarifying Questions: セクションに含める内容について5-10の質問
- Brainstorming: 5-20のアイデアを生成
- Curation: ユーザーが保持/削除/結合を判断
- Gap Check: 不足している重要な情報がないか確認
- Drafting: セクションを起草
- Iterative Refinement: フィードバックに基づく改善
品質チェック（80%完了時）
- セクション間の流れと一貫性
- 冗長性や矛盾
- 「スロップ」がないか（英語の "slop"：汎用的な埋め文・内容のない定型表現）
- 全ての文が意味を持つか
Stage 3: Reader Testing
（ステージ3：読者視点でのテスト）
目標: 新鮮な視点でドキュメントをテストし、盲点を発見する。
- Reader Questions: 読者が質問しそうな5-10の質問を予測
- Testing: 予測した質問をドキュメントに対してチェック
- Additional Checks: 曖昧さ、前提知識、矛盾を確認
- Fix: 見つかった問題を修正し、Stage 2に戻る
最終レビュー
Reader Testingが通ったら:
- ユーザー自身の最終読み通しを推奨
- 事実、リンク、技術詳細のダブルチェック
- 望んだインパクトが達成されているか確認
Resources
resources/implementation-playbook.md - 詳細なワークフロー手順、サブエージェント活用、アーティファクト管理方針
