agents-md-improverlisted

# Agents MD Improver（エージェント指示ファイルの監査・改善） リポジトリ内のエージェント指示ファイル（CLAUDE.md / AGENTS.md / GEMINI.md 等）を監査・評価・改善し、コーディングエージェントが最適なプロジェクトコンテキストを持てる状態を保つ。 **このスキルは指示ファイルへ書き込みうる。** ただし必ず品質レポートを提示し、ユーザー承認を得てから的を絞った更新のみを適用する。 ## 対象ファイル | 種別 | 場所 | 用途 | |------|------|------| | プロジェクトルート | `./CLAUDE.md` / `./AGENTS.md` / `./GEMINI.md` | プロジェクトの一次コンテキスト（git 管理・チーム共有） | | ローカル上書き | `./.claude.local.md` | 個人・ローカル限定設定（gitignore 対象。Claude Code 固有） | | パッケージ単位 | `./packages/*/CLAUDE.md` 等 | monorepo のモジュール単位コンテキスト | | サブディレクトリ | 任意のネスト位置 | 機能・ドメイン固有コンテ���スト | | グローバル | `~/.claude/CLAUDE.md`（Claude Code）/ `~/.codex/AGENTS.md`（Codex）/ `~/.gemini/GEMINI.md`（Gemini CLI） | ユーザー全体のデフォルト。**明示的に依頼されたときのみ対象にする** | 多くのエージェントは親ディレクトリの指示ファイルを自動発見するため、monorepo 構成でもネスト配置が機能する。 ## Phase 1: Discovery（走査） リポジトリ内の指示ファイルをすべて洗い出す: ```bash find . \( -name "CLAUDE.md" -o -name "AGENTS.md" -o -name "GEMINI.md" -o -name ".claude.local.md" \) -not -path "*/node_modules/*" -not -path "*/.git/*" 2>/dev/null | head -50 ``` **symlink の扱い（重要）:** - 各ファイルが symlink かを確認する（`ls -l <path>`）。`AGENTS.md → CLAUDE.md` のような symlink は実体と合わせて **1 エンティティ**として扱い、評価・編集は実体側に対して行う（二重カウント・二重編集しない） - 同名役割のファイルが**別実体**として複数存在する場合（例: CLAUDE.md と AGENTS.md が独立ファイル）、内容の乖離（drift）を確認し、乖離があれば問題として報告する ## Phase 2: 品質評価 各ファイルを品質基準に照らして評価する。詳細ルーブリックは [references/quality-criteria.md](references/quality-criteria.md) を参照。 **クイックチェックリスト:** | 基準 | 重み | 確認内容 | |------|------|---------| | コマンド・ワークフローの文書化 | 高 | build / test / deploy コマンドがあるか | |