audit-agent-context

Audit Agent Context — AGENTS.md / CLAUDE.md をリポジトリの実態と照合して監査する

Goal

プロジェクトの AGENTS.md および／または CLAUDE.md に記載された内容と、リポジトリの実際の状態との食い違いを検出して報告します。自動で修正することはありません。対象となるのは、フォルダー構成、コマンド、技術スタック、命名規則、記載された適用範囲、複数エージェントの連携ルールです。このスキルは分類済みのレポートを作成します。編集は、後の明示的な手順でユーザーが決定して適用します。

実行されるタイミング

• ユーザーが /audit-agent-context を実行したとき。
• 「AGENTS.md の記述が今も正しいか確認して」「エージェントのコンテキストを更新して」「CLAUDE.md の内容が古くなっていないか」など、同等の依頼をしたとき。

Input

必須の入力はありません。任意で、cwd とは異なるプロジェクトパスを指定できます（例：サブプロジェクトや worktree を監査する場合）。

Workflow

1. 対象範囲を特定します。

   • プロジェクトのルート：git rev-parse --show-toplevel（失敗した場合は cwd を使用）。
   • 関連するすべての AGENTS.md と CLAUDE.md を特定します。リポジトリのルート、cwd（ルートと異なる場合）、および作業対象として記載されたサブフォルダー内にネストされたファイルが対象です。それぞれ1つだけだと決めつけないでください。複数の階層に同種のファイルが存在することがあります。

2. 見つかった各ファイルから、検証可能な主張を言い換えずに抽出します。特に次の点を確認します。

   • 記載されたパスやファイル名／フォルダー名（存在するか、現在も残っているか）。
   • 記載されたコマンド（ビルド、lint、テスト、gentle-ai ...、herdr ... など）。参照先のバイナリ／スクリプトは存在するか、実行可能か。
   • 否定的な主張（「コードがない」「package.json がない」「テストがない」など）。現在も正しいか。
   • 宣言された命名規則／構成（例：HU-0X-<slug>.md、PLAYBOOK-<ROL>.md）。実際のファイルは規則に従っているか。
   • 記載された適用範囲（その AGENTS.md／CLAUDE.md が対象とするフォルダー）と、ツリー内での実際のファイルの配置。
   • 複数エージェントの連携ルール（プレイブックのパス、スキル名、呼び出しコマンド）。

3. 各主張を実際のリポジトリと照合します。

   • 構成と内容の確認には Glob／Grep／Read を使用します。追跡対象か未追跡かを確認するには git ls-files／git status を使用します。
   • リポジトリにコードがあり、CodeGraph を利用できる場合は、広範な grep を行う前に、実際のアーキテクチャに関する質問で CodeGraph を優先します（構造に関する質問では、すでに全体に適用されているルールです）。
   • コマンドについては、バイナリ／スキルの存在を確認します（.claude/skills、.agents/skills、package.json のスクリプトなど）。動作確認だけを目的に、副作用のあるコマンドを実行しないでください。

4. 最終レポートに向けて、各主張を分類します。

   • ✅ 現在も有効 — 実態と一致しています。
   • ⚠️ 古くなっています — 実際の状態と矛盾しています（ファイルの記述と、確認できた証拠を併記します）。
   • ❓ 自動では検証できません — 人による確認が必要です（例：ビジネス上の決定や将来の適用範囲）。
   • 🆕 未記載 — リポジトリに存在するもの（フォルダー、命名規則、スキル、プレイブック）が、どの AGENTS.md／CLAUDE.md にも記載されていません。

5. レポートを作成します。 複数のファイルを監査した場合は、ファイルごとに項目をまとめます。各項目には、引用した主張、確認できた証拠、分類を記載します。最後に、変更案の一覧を追加します。ユーザーがファイルに反映するかどうか判断できるよう、適用せずに、具体的な提案として記載します。

守るべきルール

• このスキル内の AGENTS.md／CLAUDE.md は絶対に編集しないでください。 修正の適用は、その後に明示的に行うステップであり、この監査の対象外です。
• 確認されていない意図を決して推測しないでください。 記述が曖昧な場合や、ビジネス／チームの判断に依存する場合は、推測で解決せず ❓ を付けます。
• 監査対象のプロジェクトに独自のドメインルール（この test-project の「未解決事項」や「範囲 — 対象外」など）がある場合、このスキルもそれらのルールに従います。対象範囲を作り出したり、矛盾を黙って解決したりしません。
• 解決された対象範囲内に AGENTS.md も CLAUDE.md も見つからなかった場合は、その旨を明示的に報告してください。見つからないことを黙って済ませてはいけません。

注記

• このスキルはリポジトリに対して読み取り専用です。ファイルの書き込みやコミットは行いません。
• ステップ 2〜4 は汎用的で、test-project の構造にハードコードされていません。呼び出されたあらゆるリポジトリのエージェントコンテキストを監査するために使用できます。