Communityライティング&編集github.com

dustinkeeton/wafflestack

🧇 一つのバッターで全てのリポジトリに対応 — 再利用可能なAIエージェントとスキル定義を、各プラットフォーム(.claude/、.codex/、.agents/)のネイティブファイルに変換します。

wafflestack とは?

このスキルは、wafflestackプロジェクトにおけるドキュメント生成パイプラインを自動化するためのものです。コードベースの変更を監査し、マシンリーダブルなドキュメント(`AGENTS.md`)と人間向けドキュメント(`DECISIONS.md`、`STATUS.md`、`ARCHITECTURE.md`)を最新の状態に保ちます。 **有用性**:コード変更に伴うドキュメントの更新漏れや整合性の問題を防ぎます。特に、複数のAIエージェントプラットフォーム(Claude Code、Codex、Cursorなど)を横断してスキル定義を管理する場合に、ドキュメントの一貫性を保つのに役立ちます。 **対応プラットフォーム**:wafflestack自体が、Claude Code(.claude/)、Codex(.codex/)、Cursor(.agents/)など、様々なAIエージェントツール向けの設定ファイルを生成する基盤です。このスキルはそのメタドキュメント管理を担当します。 **動作の仕組み**:3ステップのパイプラインで構成されています。Step 1では`general-purpose`エージェントがコードベースの変更を読み取り専用で監査し、変更レポートを生成します。Step 2では`docs-agent`エージェントがそのレポートと実際のソースコードを基にマシンリーダブルドキュメントを更新します。Step 3では`docs-human`エージェントが更新されたマシンリーダブルドキュメントを基に人間向けドキュメントを更新します。各ステップは順次実行され、前のステップの出力が次のステップへの入力となります。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add dustinkeeton/wafflestack

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ドキュメントオーケストレーション

このスキルが呼び出されたら、以下のパイプラインを実行します。

ステップ 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 は、それぞれのドキュメントファイルを変更する必要があります。

関連スキル