| name | claude-md-manager |
| description | AGENTS.md / CLAUDE.mdの作成・編集・整理を行うスキル。CLAUDE.mdを50行以下を推奨とし、詳細ルールはrules/やスキルにモジュール化して分割管理する。以下のリクエストで使用する: (1)「CLAUDE.mdを作って」「AGENTS.mdを整理して」などCLAUDE.mdの新規作成・編集、(2)「ルールを追加して」「rules/に分割して」などルールの追加・分離、(3)「ディレクトリ構成を更新して」など参照の更新、(4) 新しいディレクトリやルールファイルを作成した後のCLAUDE.md反映。 |
| license | MIT |
| author | shohei |
| version | 1.0.0 |
CLAUDE.md Manager
AGENTS.md / CLAUDE.mdをモジュール化して分割管理するためのスキル。
実体は AGENTS.md 側に置き、CLAUDE.md は AGENTS.md へのシンボリックリンクとして設定する。理由は、Claude Code 以外の Codex などのAIエージェントも同じ指示内容を共通で参照できるようにするため(AGENTS.md は複数AIツールで共通利用される標準ファイル名)。
基本原則
- AGENTS.md / CLAUDE.mdは50行以下を推奨(公式は200行以下)。詳細は
rules/ やスキルにモジュール化して分割する
- CLAUDE.mdにはパスと目的の参照のみ記載する
CLAUDE.mdの構成
以下のセクションを必要に応じて含める。
- タイトル・概要(1〜2行)
- ディレクトリ構成(サブディレクトリがあれば)
- ルール(参照リンク)
- その他、そのディレクトリ固有の設定
記載フォーマット
ディレクトリ構成セクション
## ディレクトリ構成
- `ディレクトリ名/` — 責務の説明。どういう時に使うか
例:
- `docs/` — 外部参考資料。ガイドライン参照や資料確認時に使う
- `rules/` — 投稿パターン・記事ルール・日々のルーティン
- `posts/` — 投稿の下書き・記録(日付フォルダで管理)
単体ファイルも同じ形式:
- `ME.md` — 代表者・会社プロフィール。自己紹介が必要な時に参照する
ルールセクション
## ルール
- `rules/ファイル名.md` — そのルールの目的
例:
- `rules/post_patterns.md` — 投稿パターン集・禁止表現・作成ルール
- `rules/writing_rules.md` — 文章の書き方ルール
ワークフロー
CLAUDE.mdの新規作成
- そのディレクトリの責務を1〜2行で記述する
- サブディレクトリがあれば「ディレクトリ構成」セクションを追加する
- rules/ があれば「ルール」セクションを追加する
- 50行以下を推奨。超える場合はモジュール化を検討する
ルール追加時
- 詳細なルールは
rules/ファイル名.md に書く
- CLAUDE.mdの「ルール」セクションに
ファイルパス — 目的 の1行を追加する
- CLAUDE.mdに詳細を直接書かない
行数超過時の対処
- 詳細な説明を
rules/ に切り出す
- CLAUDE.mdには参照リンクのみ残す
- 重複する記述を統合する
新しいルールファイルやディレクトリを作成した時
- そのディレクトリの CLAUDE.md に
パス — 説明 の1行を追加する
- ルートの AGENTS.md にも反映が必要か確認し、必要なら追加する
- 新しいトップレベルディレクトリ → AGENTS.md の「ディレクトリ構成」に追加
- サブディレクトリやルールファイル → 該当ディレクトリの CLAUDE.md に追加
参考資料
注意事項
- CLAUDE.mdに詳細なルールや手順を直接書かない
- 「
パス — 説明」の形式を必ず守る
- ルートのAGENTS.mdには「作業前に対応ディレクトリのCLAUDE.mdとrules/を必ず読むこと」と明記する
- 新しいファイルやディレクトリを作成したら、必ず対応するCLAUDE.md / AGENTS.mdを更新する