プランを書くのは、コーディングエージェント。コードを書く前に、レビューを。

コードの前に、プランをレビューする

プランの間違った前提は、コメント1つで直せます。同じ前提がコードに入ると、diffを読み、リバートして、もう一度実行する手間がかかります。変更が安いうちに、まずプランを読みましょう。

ターミナルでは、プランはスクロールして読む長い文章です。DotMDでは整形されたドキュメントで、あなたの指摘はそれぞれ該当する箇所に結びつきます。

1. プランをファイルで頼む

   「プランをdocs/plan.mdに書いて、レビュー用にDotMDで送って」

2. おかしいところにコメントする

   箇所を選択し、⌥⌘Mを押して、望む変更を書きます。プラン全体でそれを繰り返し、Sendをクリックします。

3. 修正をdiffで確認する

   エージェントがファイルを編集します。古いテキストは赤、新しいテキストは緑で、各修正が答えているコメントの横に表示されます。Accept、Reopen、またはAccept Allです。

4. 承認して、作らせる

   Approveをクリックすると、エージェントはコードの作業に進みます。

エージェントは、各コメントを、その箇所、行番号、書いた人とともに受け取るので、あなたの意図が正確にわかります。選択した箇所も読めます。「DotMDで選択した段落を書き直して」

終わったら「変更点をDotMDで見せて」と頼むと、エージェントがレビューを開いてくれます。

エージェントが書くドキュメント

プランは始まりにすぎません。エージェントはほかにも書き、同じようにレビューできます。

• スペックと設計ドキュメント。
• アーキテクチャ決定記録（ADR）。
• READMEとCHANGELOGの項目。
• 移行、ロールアウト、テストのプラン。
• ライブラリやサービスの比較表。

2つ目のエージェントに、1つ目の仕事をレビューさせることもできます。Claude Codeが書き、Codexがコメントし、あなたが決めます。エージェントがエージェントをレビューをご覧ください。

いまの環境に合う

DotMDはMac上で小さなMCPサーバーを動かし、エージェントは1行でそこにつながります。Claude Code、Codex、Cursor、Visual Studio Codeのどれでも動きます。正確な設定は、各ガイドにあります。

• コピーではなく、ファイルそのもの。DotMDは、プロジェクトのフォルダにあるMarkdownファイルを直接読み書きします。取り込みも同期も不要です。
• git。git、エディタ、エージェントがファイルを変更すると、DotMDが気づいて、以前のテキストをバージョンとして残します。git mvで名前を変えたファイルのコメントは、新しい場所で最初に開いたときについてきます。
• Docker。コンテナ内のエージェントは、http://host.docker.internal:8089/mcpでDotMDにつながります。

習慣にする。AGENTS.mdに数行

エージェントは、頼まれたときにドキュメントをレビュー用に送ります。毎回そうさせ、コメントをDotMDで探させるには、次の行を、CodexならAGENTS.mdに、Claude CodeならCLAUDE.mdに追加します。

Comments and reviews on Markdown files are kept in DotMD (MCP server `dotmd`), not in the files.
When I mention comments, a review or remarks on a .md file, read them with get_review_comments,
fix each one and send it back with resolve_review_comments.
After writing or substantially changing a spec, plan or design doc for me, send it to me with
request_review and wait for my answer; call it again after fixing my comments, until I approve.

いちばん大事なのは1行目です。コメントはファイルではなくDotMDに保存されるため、DotMDのことを考えないエージェントはプロジェクト内を探して、何も見つけられません。

ファイルは、あなたのものです

• アカウントはありません。ファイル、コメント、バージョン履歴は、あなたのMacに残ります。
• MCPサーバーは127.0.0.1でしか応答しないので、ほかのコンピュータからは届かず、Webページから使うこともできません。
• コメントと履歴は、ファイルではなくDotMDが保管します。リポジトリ内のMarkdownに、マーカーもHTMLコメントも入りません。

開発者からの質問

その他の質問