Documentation Generator

学習科学の原則に基づき、読者が確実に理解できる技術ドキュメントを生成するスキル。

発動条件

• 「ドキュメント作成」「ドキュメント生成」「docs書いて」
• 「技術文書を書いて」「解説ドキュメント」
• 新しい技術ドキュメントの作成を依頼された時

ドキュメント種別の判定

ワークフロー

[Phase 1] 調査・設計
├── 対象の理解（コード読解 / 技術調査）
├── 読者レベルの確認
└── セクション構成の設計

[Phase 2] 執筆
├── セクション構成テンプレートに従い執筆
├── 学習科学の原則を適用
└── コード例・比較表・図の作成

[Phase 3] 整合性チェック
├── 理解度チェックの整合性検証（最重要）
├── フォーマット規則の確認
└── 読み直しと推敲

学習科学の原則（必ず適用）

詳細は @references/learning-science.md を参照

セクション構成テンプレート

詳細は @references/section-templates.md を参照

フォーマット規則

詳細は @references/formatting-rules.md を参照

理解度チェックの鉄則（最重要ルール）

理解度チェックの全ての問題は、そのセクション内（チェックより前の部分）の記述だけで答えが導けなければならない。

チェックリスト:

1. 問題を作成したら、セクション内に答えの根拠があるか逆引き確認する
2. 「〜の理由を説明できるか？」→ 本文に「なぜ」の説明があるか
3. 「〜を N つ挙げられるか？」→ 本文に N 個以上の項目が列挙されているか
4. 「〜が適しているケースは？」→ 本文にそのケースの説明があるか
5. 本文を変更したら、既存の理解度チェックに影響がないか確認する

既存ドキュメントの参照

Argus プロジェクトの実例:

• 技術選定: docs/TECH_STACK_AND_ARCHITECTURE.md
• コードベース解説: docs/PROJECT_STRUCTURE_AND_CODEBASE_GUIDE.md