codexstar69/bug-hunter

What it solves

Bug Hunter는 AI 기반 코드 리뷰에서 흔히 발생하는 높은 오탐(false positives) 비율을 줄이기 위해 설계되었습니다. 그럴듯하지만 검증되지 않은 주장을 길게 나열하는 대신, 적대적 프로세스(adversarial process)를 사용하여 증거에 기반하고 도달 가능한 런타임 버그 및 보안 취약점만 보고하도록 합니다.

How it works

The project는 버그 발견과 검증을 분리하는 다단계, 역할 기반 파이프라인을 구현합니다:

1. Risk Triage: 모델 토큰을 사용하지 않고 스캔 순서를 우선순위화하기 위해 파일의 위험도를 점수화하는 결정론적 사전 패스(deterministic pre-pass)입니다.
2. The Adversarial Trio:
   • Hunter: 잠재적인 버그를 식별하고 증거와 런타임 트리거를 제공합니다.
   • Skeptic: 코드를 추적하고 누락된 컨텍스트를 식별하여 Hunter의 주장을 반박하려고 시도합니다.
   • Referee: 양측의 증거를 평가하여 최종 판결(REAL_BUG, NOT_A_BUG, 또는 MANUAL_REVIEW)을 내립니다.
3. Verification & Reporting: 시스템은 하이브리드 검증(테스트, 타입 체크, 퍼징)을 실행할 수 있으며, 구조화된 JSON 아티팩트와 Markdown 보고서를 생성합니다.
4. Remediation: 권한이 부여되면, 수정 계획을 생성하고 승인된 편집을 적용합니다.

Who it’s for

이 도구는 노이즈를 최소화하면서 고정밀 보안 감사 또는 코드 리뷰 프로세스가 필요한 AI 코딩 에이전트(Claude Code, Cursor, GitHub Copilot, 또는 Windsurf와 같은)를 사용하는 개발자와 보안 감사관을 위해 구축되었습니다.

Highlights

• Adversarial Review: 발견 사항이 사용자에게 전달되기 전에 Hunter-Skeptic-Referee 모델을 사용하여 결과에 이의를 제기합니다.
• Measurable Quality: 정밀도(precision), 재현율(recall), F1 스코어를 추적하기 위한 벤치마크 품질 게이트를 포함합니다.
• Adaptive Execution: 감사의 위험도와 범위에 따라 fast, balanced, 및 assurance 프로필을 제공합니다.
• Fail-Closed Safety: 소스 코드 편집 및 자율 수정은 명시적인 허가가 필요합니다. 시스템은 무결성을 유지하기 위해 소스 드리프트(source drift)를 거부합니다.
• Broad Agent Support: 휴대 가능한 자연어 인터페이스를 통해 광범위한 파일 기반 AI 코딩 에이전트와 호환됩니다.