wanshuiyin/HERO-Anti-OverDefense

HERO – Anti‑OverDefense

What it is

• とても小さな、コピー＆ペースト可能な設定ブロック（およびドキュメント）で、AIコーディングアシスタント（Claude Code、GitHub Copilot、Cursor、Gemini CLIなど）のプロンプト/設定ファイルに追加します。
• ブロックには、モデルがコード、ドキュメント、その他の出力を作成する際にしてはいけないことを伝える9つの「ルール」が含まれています。
• リポジトリには、ルールが対象とする4つの問題の種類を示す実世界の例のカタログ（cases/フォルダ）も同梱されています：
  1. H – Hashing – 誰も読まないチェックサムやダイジェストを追加すること。
  2. E – Edge cases – プロジェクト内で決して発生しない入力に対して防御すること。
  3. R – Rubrics – 人間の判断を、網羅的なスコアリング表や監査ループで置き換えること。
  4. O – Overbuild – 使われることのないスキャフォールディング、機能フラグ、マイグレーションレイヤーを構築すること。
• このアイデアは、LLMベースのエージェントが要求された作業に集中できるように、具体的で言語に依存しない方法を提供することです。

How you use it

1. エージェントが自動的に読み込むファイルを選択します（例：CLAUDE.md、AGENTS.md、.github/copilot‑instructions.md）。
2. READMEに記載されたワンライナーを実行します。これにより、リポジトリからRULES.mdブロックを取得し、ファイルに追加されますが、重複を防ぐための保護が施されています。
3. エージェントが後で出力を行う際、9つのルールが契約として機能します。モデルは不要なハッシュの追加を拒否し、関係のないエッジケースを無視し、果てしないチェックリストを避けるべきで、必要のないスキャフォールディングを生成してはいけません。
4. モデルがまだ過剰に防御する場合、cases/カタログから一致するエントリを引用することで、具体的な「形」（例：HERO‑R‑006）を指摘でき、フィードバックを明確にできます。

Why it matters

• LLMベースのコードアシスタントはしばしば「すべての可能性をカバーしよう」とします。チェックサムを散りばめ、防御的なラッパーを追加し、長大な監査ログを生成することで、納品を遅らせることがあります。
• HEROのルールは、著者の自身の研究（ARISプロジェクト）で観察された実際の事例と、コミュニティからの貢献から抽出・精錬されています。
• 一文のテキストブロックとして防御的でない姿勢を定式化することで、プロンプトファイルを尊重するモデルであれば、別途ライブラリやランタイムを必要とせずに動作します。

What you get from the repo

• RULES.md – 9ルールの契約（完全版と短縮版）。
• cases/ – 実際の過剰防御の例を記録したMarkdownカタログ。各エントリには何が求められたか、モデルが何をしたか、なぜ過剰なのか、適切な解決策が記載されています。
• hosts/ – 各対応エージェントが読み込むファイル名を正確に示すテーブル。
• examples/ – コミュニティが寄稿したオプションの設定スニペット。実プロジェクトでこのブロックをどう統合しているかを示しています。
• 小さな変更履歴（例：2026年9月に追加された「プレスリリース原則」）。

Who it’s for

• 日常開発でLLMコードアシスタントに頼っているチームで、不要なボイラープレートを生成させたくない人。
• 長期間、監視なしでAI駆動のコード生成パイプラインを実行している研究者や趣味人（ARISの「スリープ」研究）で、モデルが過剰に防御する傾向を軽量なガードで抑える必要がある人。

Limitations

• このブロックはソフトな指示です。より強力なモデルや、より優先度の高いシステム制約がある場合、このブロックを上書きできる可能性があります。
• セキュリティやマイグレーション作業を強制するものではありません。これらのルールは明示的に、より優先度の高い要件に従うことを前提としています。
• 効果は限定的です。コミュニティのフィードバックによると、「少し役立つ」程度であり、モデルがすべてのルールを守ると保証するものではありません。

License

• MIT – ブロックとドキュメントを自由にコピー、変更、再配布できます。

---

要するに、HERO‑Anti‑OverDefenseは、AIコーディングアシスタントが機能の周りに不要な「要塞」を築くのをやめ、実際の作業に集中するように指示する、最小限でモデルに依存しないプロンプトファイルです。