wanshuiyin/HERO-Anti-OverDefense

해결하는 문제

기능을 구축하도록 요청받은 AI 코딩 어시스턴트는 때때로 기능 자체보다 방어적인 작업에 노력을 쏟습니다. 아무도 읽지 않는 체크섬을 추가하거나, 여기서 발생할 수 없는 엣지 케이스에 대한 방어를 강화하거나, 판단을 채점 체크리스트로 대체하거나, 아무도 요구하지 않은 미래를 위한 스캐폴딩을 구축합니다. 저자는 이를 에이전트가 '일이 좋은 것'보다 '비난받지 않는 것'을 최적화하는 것으로 설명합니다. 이 프로젝트는 그러한 행동을 제한하기 위해 에이전트의 설정 파일에 붙여넣는 짧은 규칙 블록입니다.

작동 방식

저장소에는 영어와 중국어로 제공되는 9개의 일반 텍스트 규칙이 포함된 블록(RULES.md)이 있으며, 에이전트가 자동으로 로드하는 모든 파일(CLAUDE.md, AGENTS.md, .github/copilot-instructions.md, .cursorrules 등)에 붙여넣을 수 있습니다. 규칙은 '실제로 잘못된 것을 보고'와 '여기서 발생하지 않는 것에 대한 방어를 구축하지 마라' 사이의 경계를 명확히 합니다. 해싱, 엣지 케이스, 루브릭, 과잉 구축의 네 가지 과잉 방어 유형과 과잉 수정이라는 형제 유형을 명명하여 분위기에 대해 논쟁하는 대신 방금 발생한 행동을 정확히 지정할 수 있습니다. 별도의 cases/ 카탈로그는 관찰된 행동(무엇이 요청되었는지, 에이전트가 무엇을 했는지, 왜 과도했는지, 적절한 대응은 무엇인지)을 기록합니다. 이것은 붙여넣는 것이 아니라 에이전트가 논쟁할 때 케이스 ID로 인용하는 것입니다. 선택적 Goal Pulse 스킬과 Codex 장기 실행 목표용 타이머는 메인 에이전트가 30분마다 완료된 작업을 계속 수집하고 차단 요소를 처리하도록 상기시킵니다. 명령줄 설치 프로그램은 블록을 추가합니다(두 번 실행해도 아무 일도 일어나지 않도록 가드가 있음). 블록은 RULES.md를 직접 읽으므로 동기화가 깨지지 않습니다.

대상 사용자

자신의 프로젝트에서 코딩 에이전트를 실행하는 사람(Claude Code, Codex, Antigravity, Cursor, GitHub Copilot, Windsurf, Gemini CLI 또는 요청 없이 설정 파일을 로드하는 모든 도구)으로, 에이전트가 작업 대신 방어적인 작업에 시간과 토큰을 낭비하는 것을 본 사람. README는 이것이 스위치가 아님을 솔직히 밝힙니다. 커뮤니티의 가장 일치된 기대는 '약간 도움이 된다'이며 일부 실행에서는 여전히 방어가 강화될 것입니다. 또한 규칙은 에이전트가 제안하는 것을 제한할 뿐 검색하는 것을 제한하지 않는다는 점이 명확합니다. 요청한 실제 보안, 마이그레이션, 검증 또는 검토 작업은 항상 우선합니다.

하이라이트

• 핵심 블록은 설치나 런타임 버전이 필요 없습니다. 에이전트가 자동으로 로드하는 모든 파일의 일반 텍스트이므로 나열된 모든 호스트에서 작동하며 아마도 그 이상에서도 작동합니다.
• 네 가지 인식 가능한 형태(해싱, 엣지 케이스, 루브릭, 과잉 구축)와 형제 카테고리가 있으며 각각 구체적인 보정 예제가 포함되어 있습니다. 보고해야 할 '과잉 방어처럼 보이지만 그렇지 않은' 두 가지 반례도 포함됩니다.
• 동일한 9개 규칙을 포함하는 짧은 버전으로, 공간이 부족한 설정을 위해 크기가 약 절반입니다.
• 유용한 항목에는 불만 사항뿐만 아니라 '적절한 대응이 무엇인지'가 포함되어야 하는 케이스 카탈로그가 있으며 반례는 명시적으로 환영합니다.
• 블록에는 실제 발견과 과잉 방어를 구분하는 테스트가 포함되어 있습니다. '이것이 어떤 특정 실패를 감지하고, 발생했을 때 나는 무엇을 다르게 할 것인가?'