기업들은 AI가 생성한 버그를 수정하는 데 AI 토큰의 44%를 소비하고 있습니다 (Entelligence AI, 2026년 5월). CodeRabbit은 오픈 소스 PR(Pull Requests)을 분석하여 AI가 인간의 코드보다 1.7배 더 많은 문제를 생성한다는 사실을 발견했습니다.

저는 지난주에 에이전트가 생성한 20분 분량의 코드를 리팩터링(Refactoring)하는 데 3일을 보냈습니다. 겉보기에는 아키텍처(Architecture)가 괜찮았습니다. 컴파일도 되었고, 테스트도 통과했으며, 기능도 작동했습니다. 하지만 그 이면에는 다음과 같은 문제들이 있었습니다:

• 에러 핸들링(Error handling)이 모든 곳에서 catch (e) {}로 되어 있어 조용히 무시됨
• 임시 파일이 생성되었지만 전혀 정리되지 않음 (일주일 만에 200MB의 고아 파일 발생)
• 에이전트가 라이브러리 v3의 메서드를 사용함. 우리는 v5를 사용 중임. 해당 메서드는 존재하지 않음.
• 어디에도 finally 블록이 없음 — 실패 시 연결(Connections)이 누수됨

익숙하신가요? 만약 여러분이 Cursor, Claude Code, Codex 또는 Copilot을 단순한 보일러플레이트(Boilerplate) 이상의 용도로 사용하고 있다면, 이런 상황을 겪어보셨을 것입니다.

AI 특유의 문제점
이것들은 무작위적인 버그가 아닙니다. 일정한 패턴이 있습니다. AI 에이전트는 "올바르게 보임"과 "해피 패스(Happy path) 통과"를 최적화합니다. 이들은 다음과 같은 사항들을 체계적으로 놓칩니다:

• 실패 모드(Failure modes) — 요청 도중 네트워크가 끊기면 어떻게 되는가?
• 고아 리소스(Orphaned resources) — 이벤트 리스너(Event listeners), 연결(Connections), 정리되지 않은 임시 파일
• 엣지 케이스(Edge cases) — 빈 배열, null 입력, 유니코드(Unicode), 동시 액세스(Concurrent access)
• 환각된 의존성(Hallucinated dependencies) — 올바르게 보이지만 존재하지 않는 임포트(Imports)
• 아키텍처 드리프트(Architectural drift) — 에이전트가 프로젝트의 패턴을 무시하고 새로 만들어버림

해결책: 자기 감사(Self-Audit)를 강제하는 기술
저는 ai-debt-detector를 만들었습니다. 이는 에이전트가 코드 생성 세션이 끝날 때마다 정확히 이러한 실패 패턴에 대해 자신의 출력을 스스로 확인하도록 만드는 98줄짜리 행동 기술(Behavioral skill)입니다.

이것은 린터(Linter)가 아닙니다. CI 도구도 아닙니다. 여러분이 코드를 확인하기도 전에, 에이전트 내부의 쓰기 시점(Write-time)에 실행됩니다.

설치 (Cursor)

npx skills@latest add Adit-Jain-srm/skill-forge

설치 (Claude Code)

/plugin marketplace add Adit-Jain-srm/skill-forge
/plugin install skill-forge@skill-forge

이 기술은 코드 생성 후 자동으로 활성화됩니다. 다음 사항들을 스캔합니다:

catch (e) {} — 삼켜진 에러 (red flag)
리소스가 열렸을 때 누락된 finally 블록
// TODO: handle error — 에러를 회피하는 AI의 방식
존재하지 않는 경로로부터의 Import
정리(cleanup) 과정이 없는 타임아웃
연결(Connection)은 열렸으나 풀(pool)로 반환되지 않은 경우

더 큰 시스템의 일부
ai-debt-detector는 skill-forge에 포함된 17개 스킬 중 하나입니다. 이 self-improving 컬렉션에는 다음 기능들도 포함되어 있습니다:

/prove-it — "완료"라고 주장하기 전에 증거를 강제함
/diagnose — 체계적인 디버깅 루프 (재현 → 최소화 → 수정)
/grill — 잘못된 것을 만드는 것을 방지함
/error-resilience — 재시도 패턴 (retry patterns), 서킷 브레이커 (circuit breakers), 우아한 성능 저하 (graceful degradation)
/session-guard — 긴 세션의 손상을 방지함

101개의 테스트 통과, 0개의 검증 경고, MIT 라이선스. Cursor, Claude Code, Codex CLI, Gemini CLI, 그리고 Copilot에서 작동합니다.

사용해 보기
npx skills@latest add Adit-Jain-srm/skill-forge
그 다음 에이전트와 함께 코드를 작성해 보세요. 스킬이 자동으로 활성화되어 당신이 놓칠 수 있는 부분을 잡아냅니다.

GitHub | MIT License | 17 skills | 101 tests