wanshuiyin/HERO-Anti-OverDefense

HERO – 방어 과잉 방지

무엇인가요

• AI 코드 보조 도구(Claude Code, GitHub Copilot, Cursor, Gemini CLI 등)의 프롬프트/설정 파일에 추가하는 아주 작은, 복사-붙여넣기 가능한 구성 블록(문서 포함)입니다.
• 이 블록은 모델이 코드, 문서, 기타 결과물을 작성할 때 무엇을 하지 말아야 하는지 알려주는 아홉 가지 "규칙"을 담고 있습니다.
• 리포지토리에는 또한 네 가지 문제 유형을 대상으로 한 실제 사례 목록(cases 폴더)이 포함되어 있습니다:
  1. H – 해싱 – 아무도 읽지 않는 체크섬 또는 다이제스트를 추가하는 것.
  2. E – 에지 케이스 – 프로젝트에서 결코 발생하지 않는 입력에 대비하는 것.
  3. R – 기준 – 인간의 판단을 완전한 점수표나 감사 루프로 대체하는 것.
  4. O – 과잉 구축 – 결코 사용되지 않는 스크래핑, 기능 플래그, 마이그레이션 레이어를 만드는 것.
• 핵심 아이디어는 LLM 기반 에이전트가 요청된 작업에 집중하도록 하기 위해, 구체적이고 언어에 구애받지 않는 방법을 개발자에게 제공하는 것입니다.

사용 방법

1. 에이전트가 자동으로 읽는 파일을 선택하세요 (예: CLAUDE.md, AGENTS.md, .github/copilot‑instructions.md).
2. README에 제공된 일문장 명령어를 실행하세요. 이 명령어는 리포지토리에서 RULES.md 블록을 가져와서 파일에 추가하며, 중복 방지를 위한 보호 기능이 있습니다.
3. 이후 에이전트가 출력을 생성할 때, 아홉 가지 규칙이 계약처럼 작동합니다. 모델은 불필요한 해시를 거부하고, 무관한 에지 케이스를 무시하며, 끝없이 늘어지는 체크리스트를 피하고, 필요 없는 스크래핑을 생성하지 않아야 합니다.
4. 모델이 여전히 과도하게 방어적이라면, cases/ 목록에서 일치하는 항목을 인용하여 구체적인 "형태"(예: HERO‑R‑006)를 지적함으로써 피드백을 정확하게 할 수 있습니다.

왜 중요한가요

• LLM 기반 코드 보조 도구는 종종 "모든 가능성을 커버하려"는 경향이 있습니다. 해시를 뿌리고, 방어적 래퍼를 추가하거나, 긴 감사 기록을 생성하여 배포를 지연시킵니다.
• HERO의 규칙은 저자의 연구(ARIS 프로젝트)에서 관찰한 실제 사례와 커뮤니티 기여를 바탕으로 요약된 것입니다.
• 단순한 텍스트 블록으로 방어적 태도를 명문화함으로써, 프롬프트 파일을 존중하는 모든 모델과 호환되며, 별도의 라이브러리나 런타임이 필요하지 않습니다.

리포지토리에서 얻을 수 있는 것

• RULES.md – 아홉 가지 규칙 계약(완전 버전과 단축 버전).
• cases/ – 구체적인 방어 과잉 사례를 담은 마크다운 목록. 각 사례에는 무엇이 요청되었는지, 모델이 무엇을 했는지, 왜 과도한지, 적절한 해결책이 포함됩니다.
• hosts/ – 지원되는 각 에이전트가 읽는 정확한 파일 이름을 알려주는 표.
• examples/ – 커뮤니티 기여의 선택적 설정 스니펫으로, 실제 프로젝트에서 블록을 통합한 사례를 보여줍니다.
• 아주 작은 변경 기록으로, 규칙 업데이트를 문서화합니다 (예: 2026년 9월에 추가된 "프레스 리리스 원칙").

누구를 위한 것인가요

• 일상 개발에서 LLM 코드 보조 도구에 의존하는 팀으로, 보조 도구가 불필요한 보일러플레이트를 생성하지 않도록 하고 싶은 분들.
• 장기간 자동으로 실행되는 AI 기반 코드 생성 파이프라인(ARIS의 "수면 연구")을 운영하는 연구자나 애호가로, 모델이 과도하게 방어적일 가능성을 가볍게 차단하고 싶은 분들.

제한 사항

• 이 블록은 소프트 지시입니다. 더 강력한 모델이나 더 높은 우선순위의 시스템 제약 조건은 여전히 이를 무시할 수 있습니다.
• 보안 또는 마이그레이션 작업을 강제하지 않습니다. 이러한 규칙은 명시적으로 더 높은 우선순위의 요구사항에 맡깁니다.
• 효과는 제한적입니다: 커뮤니티 피드백에 따르면 "조금 도움이 된다"고 하지만, 모델이 모든 규칙을 반드시 따를 것이라고 보장하지는 않습니다.

라이선스

• MIT – 블록과 문서를 자유롭게 복사, 수정, 재배포할 수 있습니다.

---

요약하면, HERO‑Anti‑OverDefense는 AI 코드 보조 도구가 기능 주변에 불필요한 "성벽"을 쌓는 것을 멈추고 실제 작업에 집중하도록 하는 최소한의, 모델에 구애받지 않는 프롬프트 파일입니다.