claude-md-manager
Skill8 starsChanged 7 months agoMITView on GitHub
AGENTS.md / CLAUDE.mdの作成・編集・整理を行うスキル。CLAUDE.mdを50行以下を推奨とし、詳細ルールはrules/やスキルにモジュール化して分割管理する。以下のリクエストで使用する: (1)「CLAUDE.mdを作って」「AGENTS.mdを整理して」などCLAUDE.mdの新規作成・編集、(2)「ルールを追加して」「rules/に分割して」などルールの追加・分離、(3)「ディレクトリ構成を更新して」など参照の更新、(4) 新しいディレクトリやルールファイルを作成した後のCLAUDE.md反映。
1 other project uses a version of this.
Adopted by
Most recently taken up by
- tdimino/claude-code-minoantheir own version, first seen Apr 16, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- tdimino/claude-code-minoan★ 41same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository10 other files it gives its agents.
- codebase-onboardingSkill
- coding-rulesSkill
- design-md-generatorSkill
- flutter-riverpod-archSkill
- image-compressorSkill
- knowledge-graph-initSkill
- media-transcriberSkill
- meti-ai-guidelineSkill
- nano-banana-image-genSkill
- nextjs-better-auth-postgres-dockerSkill
The file
Files
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 に追加
参考資料
- 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を更新する
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.