「レビューで直しました」は、
コードに書かない。 Fixes go in code.
Stories go in git.

// なぜ要るのか// why this exists

エージェントは“経緯”をコードに焼き込む Agents bake the meeting minutes into the code

エージェントにレビュー往復をさせると、修正のたびに「指摘に従って直した」という報告文が コメントとして積まれていきます。CLAUDE.md やフックで指示しても止まらないことは公式 issue でも報告されている挙動です。コードの制約を書くコメントは資産ですが、開発の出来事を 引用形式で語るコメントは、半年後の読者には何の情報でもありません。経緯なら git blame と PR スレッドが持っています。 Send an agent through a review loop and every round deposits another “per the review feedback, we now …” into your source. Instructions in CLAUDE.md or hooks don't reliably stop it — there are open issues about exactly this. A comment that states a constraint is an asset; a comment that narrates what happened during development tells a reader six months from now nothing. git blame and the PR thread already keep the story.

// Empty string means "--diff with no value":
// fall back to comparing against HEAD.
if (input === "") return "HEAD";

// Note: Codex review flagged this case.
// Per that feedback, we now guard it.
if (input === "") return "HEAD";

// できること// what it does

検出・集計から、壊さない削除まで From detection to deletion that doesn't break

// 安全装置// the guard rails

「壊れないコメント削除」を、真面目にやる Comment removal that refuses to break your build

正規表現でコメントを消すと、文字列の中の // やテンプレートリテラル、JSX を平気で壊します。削除を真面目にやると意外と深い — このツールが踏んでいる地雷の一部: Regex-based stripping happily corrupts strings, template literals and JSX. Done properly, removal turns out to be deep — a sample of the mines this tool steps around:

// この挙動は 1377 本のテストと 100% カバレッジ(statements / branches / functions / lines)で固定しています // pinned by 1377 tests at 100% coverage — statements, branches, functions and lines

// 92 のディレクティブ// the 92 directives

消すとビルドが壊れるコメントを、知っている It knows which comments your build depends on

判定は「それっぽい文字列を含むか」ではなく、各ツールの実際のパーサー実装(正規表現・文字列比較)に合わせてあります。 Detection is not “contains a similar-looking string” — each rule mirrors the actual parser implementation of the tool it protects.

• rspackChunkName: ブロックコメントの途中にあっても有効 — Rspack 1.x と 2.1 以降は文章や JSDoc の * の後ろにあるキーも拾うため、webpack では無効な /** webpackChunkName: … */ もディレクティブとして保持。rspackChunkName のような rspack 接頭辞のキーは 2.1 から。 Live anywhere in a block comment — Rspack 1.x and 2.1+ pick the key out past prose or a JSDoc star, so /** webpackChunkName: … */, void to webpack, is kept as a directive. Keys with the rspack prefix work since 2.1.
• codeql[...] 改行を含まないコメントのみ — CodeQL の AlertSuppression クエリは 1 行に収まるコメントしか読まないため、/* lgtm[...] */ は有効、複数行にまたがるブロックコメントは普通のコメント扱い。 Single-line comments only — CodeQL's AlertSuppression query reads only comments without a line break, so /* lgtm[...] */ counts while a block comment spanning lines stays ordinary.
• //// @ts-ignore tsc 7 だけが有効とみなす — Go 移植版の tsc 7 は余分なスラッシュをいくつでも読み飛ばすため、tsc 6 では普通のコメントでもディレクティブとして保持。 Live to tsc 7 alone — the Go port skips any number of extra slashes, so the comment is kept although tsc 6 reads it as an ordinary one.
• /*jslint マーカー直後に空白があると無効 — JSLint はコメント開始直後の文字列しか見ないため、空白ありは普通のコメント扱い。 Void if a space follows the marker — JSLint only honours the pragma glued to the comment opener.

// 使い方// how to use it

まず見る、それから消す Look first, then delete

1. 絞るScope --diff HEAD でエージェントが直近触った範囲だけを対象にする。 --diff HEAD narrows the target to what the agent just touched.
2. 確かめるPreview --dry-run で削除対象を人間が最終確認する。元からあった資産コメントを守るのはここ。 --dry-run puts a human in the loop — this is where pre-existing comment assets get protected.
3. 掃除するSweep 削除して、本当に必要な知見は経緯抜きの Why コメントとして書き直させる。 Delete, and have real insights rewritten as Why comments — without the narration.

終了コード: 0 成功 · 1 --fail-on-comment でコメント検出 · 2 引数・実行時エラー / Node.js ≥ 20 / MIT Exit codes: 0 success · 1 comments found with --fail-on-comment · 2 usage or runtime error / Node.js ≥ 20 / MIT