CLIツール多重計測でリファクタ優先度をランク付けする

「探索と分析はCLIに任せ、LLMは結果の解釈に専念する」という分業を実践した記録。

使ったツールと役割

ツール	計測軸
`knip`	未使用 export / file / dependency
`madge --circular` / `--summary`	循環参照・hub依存数
`type-coverage --strict --detail`	`any` の数（ファイル別）
`semgrep --config=p/security-audit`	セキュリティ監査
`git log`	変更頻度（hot）・バグ修正集中（fix grep）・Temporal Coupling

単一シグナルでは判断できない。

ホットスポット単独は問題ではない。「変更が多い」=「ビジネス重要で活発」というポジティブシグナルでもある。問題は 型穴・循環参照・バグ多発と重なるとき だけ。

実測例: 1ファイルが hot×循環×hub×型穴 の4冠 → 最優先リファクタ対象として一発で炙り出せた。

単位	配置
単一ツール（knipなど）	`CLAUDE.md` に「あるよ」と一行
複数ツール連携の段階分析	スキル化（`/refactor-priority` 等）

ツールごとに dotfiles/docs/tools/{tool}.md を書き、CLAUDE.md は索引として参照する設計。スキル数を増やしすぎない。

mise use -g npm:knip npm:madge npm:type-coverage npm:dependency-cruiser
brew install semgrep

mise の npm: バックエンドで ~/.config/mise/config.toml に追記される（Brewfile相当の再現性）。