🚨도구

AI 코딩 에이전트의 헛짓을 감지하고 차단하는 '삼천포(anti-samcheonpo)'

AI 에이전트가 같은 테스트 반복, 엉뚱한 작업, 무한 루프로 시간과 비용을 낭비하는 것을 실시간 감지하고 차단하는 로컬 하네스 도구

↗ 원본 링크

#AI에이전트#모니터링#비용절감#개발도구

왜 필요한가

AI 코딩 에이전트를 사용하다 보면 이런 경험 있으시죠?

▸같은 테스트를 계속 반복해서 실행

▸로그인 오류를 고쳐달라고 했는데 전체 시스템을 갈아엎기 시작

▸"거의 다 됐습니다"라고 하면서 같은 실패를 반복

개발자는 이런 헛짓을 바로 알아채지만, 비개발자는 알아채기 어렵습니다. 그 사이 시간과 API 비용은 계속 늘어나죠.

삼천포가 하는 일

삼천포는 AI 에이전트의 실행 과정을 모니터링하며 3가지 헛짓 패턴을 감지합니다:

1️⃣ 과잉 검증

코드는 그대로인데 같은 테스트를 몇 번이고 반복 실행

2️⃣ 맥락 이탈

요청과 무관한 엉뚱한 방향으로 작업 진행

3️⃣ 무한 루프

같은 실패를 되풀이하거나 코드로 해결 불가능한 문제를 계속 시도

동작 방식

사용자 → AI 에이전트 → 삼천포 데몬(로컬)
                         ↓
                    헛짓 감지
                         ↓
        ┌────────────────┼────────────────┐
     첫 감지          반복 감지        심각한 상황
        ↓                ↓                ↓
     귀띔하기          차단하기         즉시 정지

단계별 대응

▸

1단계: 근거와 함께 AI에게 귀띔

▸

2단계: 경고 후 같은 행동 반복 시 실행 전 차단

▸

3단계: 예산 초과나 코드 외 원인 발견 시 즉시 정지

실제 사용 예시

AI가 같은 시험을 4번 돌렸는데, 그 사이 코드는 한 글자도 바뀌지 않았습니다.
AI에게 이렇게 말해 보세요: 
"같은 시험을 다시 돌리지 말고, 직전 실패 원인을 먼저 찾아 줘."

[/samcheonpo:keep now 이번만 허용]
[/samcheonpo:keep normal 이 판정은 틀림]
[/samcheonpo:summary 멈추고 요약 받기]

실시간 상태 표시

[지켜보는 중] 진척 1/2 · 공회전 API환산 1,240원 · 헛짓 12% (계측분)

상태	의미
🟢 순조로움	진척이 있고 경고 없음
🟡 지켜보는 중	아직 진척 미확인
🔴 지금 끼어드세요	반복된 헛짓 감지
⚪ 확인 불가	관측 데이터 부족

핵심 특징

✅ 로컬 실행: 모든 판단이 내 컴퓨터에서 이루어짐

✅ 모델 호출 없음: 추가 API 비용 발생 안 함

✅ 실행 결과 기반: AI의 말이 아닌 실제 결과로 판단

✅ 쉬운 알림: 비개발자도 이해할 수 있는 명확한 메시지

시작하기

GitHub: JinHo-von-Choi/anti-samcheonpo

라이선스: MIT

요구사항: Go 1.27+

---

💡 이름의 유래: "삼천포로 빠진다"는 한국 속담에서 따왔습니다. 이야기가 엉뚱한 방향으로 흐르는 것을 의미하죠.