ドキュメントオーケストレーション
このスキルが呼び出されたら、以下のパイプラインを実行します。
ステップ 1: アーキテクチャ監査
general-purposeエージェントを、以下のプロンプトで起動します。
現在のコードベースを監査し、ドキュメントが最後に更新されてからの変更点を確認してください。既存のマシンリーダブルドキュメント(単一のルート
AGENTS.mdレジストリ)を読み、実際のプロジェクトと比較してください。以下の内容をカバーする、簡潔な変更レポートを作成してください。
- 新しく追加された、または削除されたバンドル、スキル、エージェント、設定キー、CLIコマンド
- 変更されたインストーラエクスポートやテンプレートセマンティクス(
installer/lib/*.mjs)bundle.yamlの設定宣言とプレースホルダーの使用状況の不一致- レンダリング出力のドリフト:
node installer/cli.mjs doctor --allow-missingがクリーンであること (コミットされたレンダリングとロックが同期していること — バンドル編集後は再レンダリングしてコミットすること);.gitignoreが意図的に追跡されていないレンダリング(ラベルフックワークフロー、ワークツリー、.waffle/概要ドキュメント)をカバーしていること構造化テキストとして変更レポートのみを出力してください。ファイルは変更しないでください。
ステップ 2: エージェントドキュメント
変更レポートを取得し、docs-agent エージェントを以下のプロンプトで起動します。
以下は、wafflestackコードベースのアーキテクチャ変更レポートです。
{step-1 output}
プロジェクトの現在の状態を反映するように、マシンリーダブルドキュメント(単一のルート
AGENTS.mdレジストリ)を更新してください。変更レポートだけに頼らず、実際のソースファイルを読んで詳細を確認してください。フォーマットと構造については、docs-agentスキルガイドラインに従ってください。
ステップ 3: 人間向けドキュメント
docs-agentの完了後、docs-human エージェントを以下のプロンプトで起動します。
マシンリーダブルドキュメントが更新されました。これに合わせて、リポジトリルートにある人間向けドキュメント(
DECISIONS.md、STATUS.md、ARCHITECTURE.md)を更新してください。正確性を確保するため、更新されたマシンリーダブルドキュメントと実際のソースを読んでください。フォーマット、構造、およびそのガードレール(所有者の声で書かれたドキュメントはフラグが立てられ、書き換えられることはありません)については、docs-humanスキルガイドラインに従ってください。
重要
- 各ステップは、前のステップが完了してから次のステップを開始する必要があります。各ステップの出力が次のステップへの入力となります。
- ステップ 1 は読み取り専用です — 監査エージェントはレポートのみを作成します。
- docs-agent と docs-human は、それぞれのドキュメントファイルを変更する必要があります。