DotMDCLAUDE.mdとAGENTS.mdをMacで読み、編集し、レビューする。
これらのファイルは、Claude CodeやCodexにプロジェクトでの動き方を伝えます。DotMDはそれらをページとして表示し、すべてのバージョンを残し、エージェントがスペックをレビュー用に送ってくるようになる行を追加できます。
macOS 14以降。閲覧は無料で、編集とレビューは1回のお支払いです。
要点
CLAUDE.mdとAGENTS.mdはふつうのMarkdownファイルなので、DotMDは他の.mdと同じように、整形し、アウトライン付きで、すべてのバージョンを残して開きます。Settings → MCP → Agent rulesで、Add to Claude CodeまたはAdd to Codexを押すと、DotMDのレビュー用ルールが~/.claude/CLAUDE.mdまたは~/.codex/AGENTS.mdに入り、エージェントがスペックをすべて送ってきて、コメントを待つようになります。
CLAUDE.mdとAGENTS.mdを開いて編集する
⌘Oを押してプロジェクトのフォルダを選ぶと、CLAUDE.mdとAGENTS.mdが他のMarkdownと一緒にサイドバーに表示され、アウトライン付きのページとして開きます。サイドバーは隠しフォルダを表示しないので、~/.claude/CLAUDE.mdは、⌘Oを押し、パネルで⇧⌘Gを押してパスを入力すると開けます。
ファイルを変更するには⌘Eを押します。ページは入力に合わせて整形されるテキストに変わり、変更はすぐにファイルへ保存されます。編集はDotMD Editorに含まれます。
エージェントがファイルを編集したとき
Claude Code、Codex、gitがワークスペース内のファイルを変更すると、開いているページは自動で読み込み直され、追加・削除された行数とともにChanged on diskのバナーが表示されます。Show Changesでバージョン履歴が開き、DotMD Reviewerなら古いテキストが赤、新しいテキストが緑で表示されます。
入力中にファイルが変更された場合、DotMDはLoad from DiskかKeep My Versionかを尋ね、どちらでもあなたのテキストを履歴に保存します。
エージェントの修正を1つずつ確認するには、エージェントの変更をレビューする方法をご覧ください。
DotMDのレビュー用ルールをワンクリックで追加
モデルは、ツールが自分について述べることよりも、あなた自身のCLAUDE.mdとAGENTS.mdを重く見ます。そこでDotMDは、エージェントにレビューを使わせる行をそれらに追加できます。Settings → MCPを開き、Agent rulesを展開して、Add to Claude CodeまたはAdd to Codexを押します。ルールは~/.claude/CLAUDE.mdまたは~/.codex/AGENTS.mdに入ります。
<!-- dotmd:begin (added by DotMD; DotMD can update or remove this block) -->
## DotMD
- When you create or substantially change a spec, plan, design doc or any Markdown document for the user, your LAST step is to call the DotMD MCP tool `request_review` with the file's path and wait for the answer. While it says the user is still reviewing, call it again. Never end your turn by just saying the file is ready.
- Fix each review comment, call `resolve_review_comments`, then `request_review` again until the user approves.
- When you review a file for the user, leave your remarks with `add_review_comments` and finish with `complete_review`.
<!-- dotmd:end -->DotMDが変更するのは2本のマーカー行の間だけで、最初の変更の前のファイルのコピーを.dotmd-backupで終わる名前で残します。Updateは、新しいDotMDにより良いルールがあるときにブロックを置き換え、Removeは取り除きます。
プロジェクト自身のファイルや、Cursorなどほかのエージェントには、同じ場所でCopyを押し、エージェントがルールを読む場所に貼り付けます。Claude CodeとCodexのガイドには、使える短いバージョンもあります。
エージェントはルールをどう使うか
ルールがあると、エージェントは書いたスペック、プラン、設計ドキュメントをすべてあなたに送り（request_review）、コメントを待ち、1つずつ直して、承認するまで送り直します。MCP経由のエージェントとのレビューはDotMD Reviewerに含まれます。
CLAUDE.mdとAGENTS.mdに関するよくある質問
CLAUDE.mdとAGENTS.mdとは？
コーディングエージェントへの指示を書いたMarkdownファイルです。Claude CodeはCLAUDE.md、CodexはAGENTS.mdを、プロジェクト内、またはすべてのプロジェクト共通として~/.claudeや~/.codexから読みます。
DotMDは勝手にCLAUDE.mdを変更しますか？
いいえ。DotMDがファイルに書き込むのは、Settings → MCP → Agent rulesでAddまたはUpdateを押したときだけで、2本のマーカー行の間に限られます。その前に.dotmd-backupとしてコピーを残します。
エージェントの実行中にDotMDでCLAUDE.mdを編集できますか？
はい。エージェントがファイルを変更するとページが読み込み直されます。入力中だった場合、DotMDはディスクから読み込むか、あなたのバージョンを残すかを尋ねます。
これらのファイルを編集するのにDotMD Reviewerは必要ですか？
いいえ。開くのは無料で、編集はDotMD Editor（$14.99の買い切り）に含まれます。ルールがエージェントに使うよう求める、MCP経由のエージェントとのレビューは、DotMD Reviewer（$39.99の買い切り）に含まれます。