← ブログに戻る
Ai読了目安 13 分

plannotator は agent の diff の前に人間のチェックポイントを置く

公開日 2026年11月14日
plannotator は agent の diff の前に人間のチェックポイントを置く

agent 支援の開発には、物事が良くなるどころか悪くなる瞬間があります。agent がタスクを終え、要約を出し、これで受け入れるかと聞いてきます。あなたはスクロールします。diff は 400 行。ちゃんと読むほうが自分で書くより時間がかかるので、承認します。

plannotator は今週 10,500 スター前後まで伸びているプロジェクトで、その瞬間を直す試みです。コーディング agent に接続し、agent に決めてほしいことがあるときに開く、ローカルのブラウザベースのレビュー面です。計画や文書、diff に書き込みを入れると、そのコメントが agent の次の入力として戻ります。

タグラインは「ループの中にいること」についてです。アーキテクチャが扱っているのはもっと狭くて実用的な話で、人間の注意力を、あってもなくてもいい工程から、正式な工程へ引き上げることです。

どう繋がるのか

あなたの agent を置き換えるものではありません。agent に挿し込まれます。README には Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、DeepSeek Harness、Pi が並んでおり、Inbox は Grok Bot、Muse、Hermes、OpenClaw のような個人アシスタントとも使えます。接続は各 harness のプラグイン、hook、コマンド経由なので、統合の深さはツールによって変わります。

コマンドはおなじみの形です。

/plannotator-review                    # uncommitted changes
/plannotator-review <github-pr-url>    # a pull request
/plannotator-annotate README.md        # a file
/plannotator-annotate https://docs.rs  # a URL
/plannotator-last                      # the agent's last message
plannotator inbox                      # the queue

Codex ではスラッシュコマンドが `!plannotator ...` になるか、パッケージされた skills を使います。計画モードではコマンドは一切不要です。各 harness の hook に配線されているので、agent が計画を書いた時点でレビュー面がひとりでに開きます。この細部は見た目より効きます。呼び出すのを覚えていないといけないチェックポイントは、忙しい日に飛ばされ、その忙しい日こそ必要な日です。

レビューは Git、GitButler、Jujutsu、Perforce、GitHub、GitLab にまたがるので、特定の forge に縛られません。行にコメントし、コードを提案でき、コメントは agent に返り、誰も読まない PR スレッドには残りません。

面白いのは受信箱のほう

単一 agent のレビューは解決済みの問題で、解き方も退屈です。diff を開いてコメントを残す。

Inbox は、多くの人が実際に置かれている状況のためにチームが作ったもので、その状況は複数の agent が同時に走っていることです。ローカルの窓がひとつあって、agent はそこでメッセージ、質問、ファイル、ガイド付きレビューを預け、作業を続けます。質問にはクリックで答え、ファイルに注記し、手が空いたときに送信を押します。その間どの agent セッションも開いたままになりませんし、返信は質問したセッションに戻ります。

この一文が実際のデッドロックを解きます。human-in-the-loop の標準的な形は、agent が止まって待つことです。agent がひとつなら問題ありません。四つになると、あなたがシステムで一番遅いプロセスになり、残り三つはあなたが昼食を終えるあいだコンテキストを燃やします。非同期の受信箱なら、止めておけるのは質問だけで、セッションは動き続けます。

Claude Code、Pi、OpenCode はプラグイン経由で繋がり、返信は次のターンとして届きます。それ以外は MCP 経由で `plannotator inbox mcp` を使います。そして `plannotator inbox --help` は、agent がこのプロトコルを学ぶための文書を兼ねています。小さな設計で効果は大きい。ヘルプ文が統合仕様になっています。

なぜブラウザで、なぜローカルか

ターミナルの diff はコードを読むには十分で、それ以外を読むには向きません。製品仕様、HTML モックアップ、レンダリングされたレポートをページャでレビューするのは目を細める作業で、agent はいまこの三つを日常的に出してきます。ブラウザに描画し、描画結果の上にピンを置いてもらうのが、その種の成果物に正しい面です。

plannotator のローカルレビュー画面のイメージ

README のプライバシーの節は、この規模のツールにしては異例なほど具体的で、要約で済ませず、中身を引く価値があります。テレメトリはありません。計画、diff、注記、下書き、履歴は既定でローカルに留まります。各画面は読み込み時に GitHub に最新リリースを問い合わせ、この確認は切れません。ローカル Git レビューは、既定ブランチと古いベースラインを検出するために、設定された origin に対して `git ls-remote` を実行することがあり、この問い合わせはレビューを開いたとき、diff を読み込んだとき、base を切り替えたとき、fetch を押したときに走ります。暇なレビューページはネットワークを呼びません。これは多くのツールが出すより強い約束です。

コンテンツがマシンの外に出るのは、ネットワーク機能が必要とするときだけです。URL 注記はページを取得し、GitHub レビューは認証済みの CLI を使い、Ask AI は選んだ質問とコンテキストを設定したプロバイダに送り、共有は暗号文を paste サービスにアップロードします。

ソースコードの上に座るツールとしては、この開示の水準が正しい感覚です。agent ツールの典型的な壊れ方は、親切そうな助手が黙ってリポジトリをサーバに送ることで、ユーザーの唯一の防御は、聞かれる前に境界を書いておくメンテナです。

居心地の悪い含意

このプロジェクトの全部が、agent の仕事の制約はモデルの能力より人間のレビュー帯域にあるという賭けです。

その賭けは正しいと思います。複数の agent を走らせている知人は、一日の大半を読むことに使っています。計画、diff、テスト出力、agent が自分でやったと思っていることの要約。生成の部分は速く、どんどん速くなっています。検証の部分は、人が読んで決める速さで上限が決まります。

二次的な効果にも名前を付けておく価値があります。判断を記録するレビュー面は、判断の記録を残します。plannotator には保存された計画の判断を読み取り専用で見る archive コマンドがあり、注記はデータディレクトリに残るので、ターミナルのレビューとアプリのレビューが一か所に積み上がります。コメント付きの承認済み計画が数百件になると、どの単一セッションにも入っていないものを持ちます。あなたのチームがどう決めるかの記述です。

資産はそこにあります。diff ビューアは誰でも作れます。溜まるのは推論の跡のほうです。

まだ痛いところ

二つあり、どちらも構造的です。

一つ目は、レビューツールが良くするのはレビューであって、レビューと正しさは別だということです。悪いアーキテクチャに対する注記の丁寧な承認は、やはり悪いアーキテクチャの承認ですし、整ったレビュー面は承認を勤勉のように感じさせます。Inbox はとくにキューを空にしやすくし、キューを空にするのと理解するのは別の行動です。

二つ目は、このツールがターミナルだけだったワークフローに、ブラウザ、ローカルサーバ、hook 層を足すことです。壊れるものが三つ増え、hook が壊れるときの失敗は静かです。agent はチェックポイントを通らずに進み、あなたは後で気づきます。

どちらも、買っているものに対しては許容できるコストです。買っているのは人間が立つ場所です。もう一つのやり方は多くのチームが今日やっていることで、チャットのログを読んで、大事な部分がそこに入っていることを願う。

一つだけ試すなら

次に未コミットの変更があるときに `/plannotator-review` を走らせ、三行にコメントしてみてください。言うことがなくても構いません。コメント自体はおまけです。分かるのは、面がレビューのために設計されているときに実際のレビューがどれだけかかるかで、その数字が新しいスループットの上限になります。ほとんどのチームはそれを測ったことがありません。

関連記事