chisle-audit

Chisle Audit

対象（差分、ファイル、リポジトリツリー）をスキャンし、両方の観点から削るべきものを報告します。一度限りの監査です。読み取り専用です。編集、フラグの書き込み、修正の適用は行いません。

対象範囲

• 引数なし → 現在の git diff（ステージ済み＋未ステージ）を監査します。差分が空の場合は HEAD~1..HEAD を監査します。
• パス指定 → そのファイルまたはディレクトリを監査します。
• 「repo」／「whole repo」 → ツリーを走査します（ベンダー提供のもの、生成物、node_modules、dist、ロックファイルはスキップします）。

指摘対象

コード（YAGNI の観点）：

• 標準ライブラリの機能を独自に再実装しているもの（手書きのデバウンス、ディープクローン、groupBy、リトライループ、日付計算）
• 実装が1つしかない抽象化（単一ケース向けのインターフェース／ファクトリー／ラッパー）
• 数行のコードや導入済みの依存関係で対応できることに、新しい依存関係を追加しているもの
• 値が変わることのない設定／オプション／フラグ
• 現在の呼び出し元がない、将来に備えた投機的な足場
• ネイティブのプラットフォーム機能（CSS、DB 制約、<input type>）で実現できる冗長なコード

文章（圧縮の観点）。コードだけを監査するツールが見落とす、もう一方の観点です：

• コードの内容をそのまま言い換えるコメント（i += 1 // increment i）
• 埋め草、曖昧な表現、形式的な文言、重複した内容で水増しされた Docstring／README
• 簡潔な一文で意味が伝わるのに、複数段落で説明しているもの
• 情報を増やさず、文字数だけを増やす装飾的な表、絵文字、見出し
• 放置された TODO の山、古くなった「関連項目」へのリンク、廃止されたセクションなどの不要な文章

指摘しないもの

信頼境界での入力検証、データ損失を防ぐエラー処理、セキュリティ、アクセシビリティ、すでに文書化されている意図的な // chisle:／// ponytail: のショートカット、そして「何を」ではなく「なぜ」を説明するドメイン固有のコメント。

出力

削減効果が最も大きいものを先頭にした、順位付きリストを1つ出力します。1行につき1件の指摘とします。前置きも称賛も不要です。

path:line  [code|prose]  <what's bloated> → <the lean replacement>. (~N lines/tokens)

最後に、2行の要約を付けます。

N findings: X code, Y prose. Est. removable: ~A lines code, ~B lines prose.
Biggest win: <the single highest-impact cut>.

不確実な場合は正直に示してください。スニペットから確認できない動作が失われる可能性のある削除には (check) を付けます。推測に基づく長いリストより、確信度の高い指摘を少数に絞ってください。