document

ドキュメント作成 - ドキュメント作成ステージ

不変条件

• 検証に合格し、ユーザーがタスクを承認した後にのみ実行します。
• タスク文書、テストレポート、実際に変更されたファイルに基づいてドキュメントを作成します。
• 再利用可能な教訓については LEARNINGS.md を更新します。
• 安定したプロジェクトレベルの指示がある場合にのみ AGENTS.md を更新します。
• 引き継ぎ前に、タスクが TASKS.md の Approved にあることを確認します。前のステージで移動されていない場合は、ここで該当行を Approved に修正し、トラッカーを再読み込みして確認します。

ランタイムアダプターでは、このステージがスラッシュコマンド、メニューアクション、または自然言語によるスキル呼び出しとして公開される場合があります。移植可能なステージ名は document です。

ワークフロー

1. AGENTS.md を読みます。
2. タスク ID を特定します。
3. タスク文書とテストレポートを読みます。
4. git diff --name-only を確認し、実際に変更されたファイルを特定します。
5. 開発者向けドキュメントが必要な場合は、docs/features/ の機能ドキュメントを作成または更新します。
6. ユーザー向けの動作に変更があった場合は、docs/guides/ のユーザーガイドを作成または更新します。
7. docs/learnings/{ID}-{task-name}.md に振り返りを記述します。
8. 既存の項目と重複しないように、再利用可能な教訓を LEARNINGS.md に追記します。
9. タスクによって長期的に有効なプロジェクトレベルの動作が確立された場合にのみ、AGENTS.md を更新します。
10. TASKS.md でタスクを Approved に移動します（test がすでに移動している場合は何もしません。移動されていない場合は、以前のセクションから修正します）。
11. TASKS.md を再読み込みし、タスクの行が Approved にあり、Planned、In Progress、Testing にはないことを確認します。行が想定されるセクションにない場合は、移動が漏れています。引き継ぎ前に編集して修正します。

ドキュメント作成の契機

変更	ドキュメント
新しいユーザー向け機能	機能ドキュメントとユーザーガイド
ユーザーから見える動作を伴うバグ修正	トラブルシューティングまたはガイドの更新
API または CLI の動作	開発者向けドキュメントまたはリファレンスノート
新たに定められた、長期的に有効なプロジェクト規約	AGENTS.md
再利用可能な教訓や注意点	LEARNINGS.md
テスト設定に関する学び	LEARNINGS.md とテストレポートのメモ

振り返りのテンプレート

# Task {ID} Retrospective

## Plan Vs Reality
- {What matched or changed}

## Quality Gate Findings
- {What simplify caught}

## Verification Findings
- {What test found}

## Reusable Lessons
- {Actionable lesson}

引き継ぎ

Documentation complete for task {ID}
Task status: Approved
Next stage: ship {ID}