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. タイトル・概要（1〜2行）
2. ディレクトリ構成（サブディレクトリがあれば）
3. ルール（参照リンク）
4. その他、そのディレクトリ固有の設定

記載フォーマット

ディレクトリ構成セクション

## ディレクトリ構成

- `ディレクトリ名/` — 責務の説明。どういう時に使うか

例:

- `docs/` — 外部参考資料。ガイドライン参照や資料確認時に使う
- `rules/` — 投稿パターン・記事ルール・日々のルーティン
- `posts/` — 投稿の下書き・記録（日付フォルダで管理）

単体ファイルも同じ形式:

- `ME.md` — 代表者・会社プロフィール。自己紹介が必要な時に参照する

ルールセクション

## ルール

- `rules/ファイル名.md` — そのルールの目的

例:

- `rules/post_patterns.md` — 投稿パターン集・禁止表現・作成ルール
- `rules/writing_rules.md` — 文章の書き方ルール

ワークフロー

CLAUDE.mdの新規作成

1. そのディレクトリの責務を1〜2行で記述する
2. サブディレクトリがあれば「ディレクトリ構成」セクションを追加する
3. rules/ があれば「ルール」セクションを追加する
4. 50行以下を推奨。超える場合はモジュール化を検討する

ルール追加時

1. 詳細なルールは rules/ファイル名.md に書く
2. CLAUDE.mdの「ルール」セクションに ファイルパス — 目的 の1行を追加する
3. CLAUDE.mdに詳細を直接書かない

行数超過時の対処

1. 詳細な説明を rules/ に切り出す
2. CLAUDE.mdには参照リンクのみ残す
3. 重複する記述を統合する

新しいルールファイルやディレクトリを作成した時

1. そのディレクトリの CLAUDE.md に パス — 説明 の1行を追加する
2. ルートの AGENTS.md にも反映が必要か確認し、必要なら追加する
   • 新しいトップレベルディレクトリ → AGENTS.md の「ディレクトリ構成」に追加
   • サブディレクトリやルールファイル → 該当ディレクトリの CLAUDE.md に追加

参考資料

• https://code.claude.com/docs/en/memory — Claude Code公式ドキュメント（200行以下推奨、@path インポート、.claude/rules/ 分割）
• https://addyosmani.com/blog/agents-md/ — 階層型アーキテクチャ、rules/ 分割、最小限の記述を推奨
• https://www.humanlayer.dev/blog/writing-a-good-claude-md — 300行未満推奨、ファイル参照によるモジュール化
• https://nyosegawa.com/posts/harness-engineering-best-practices-2026/ — 50行以下推奨、モジュール分割、削減基準の解説

注意事項

• CLAUDE.mdに詳細なルールや手順を直接書かない
• 「パス — 説明」の形式を必ず守る
• ルートのAGENTS.mdには「作業前に対応ディレクトリのCLAUDE.mdとrules/を必ず読むこと」と明記する
• 新しいファイルやディレクトリを作成したら、必ず対応するCLAUDE.md / AGENTS.mdを更新する