The 12 tools I use to pilot Claude Code in production: kept, dropped, contested

개요

Claude Code를 118,000줄 이상의 ERP 코드베이스에서 60일간 단독 프로덕션으로 운영하기 위해 사용된 12가지 도구들이 분석되며, 이 중 10가지가 유지, 1가지가 삭제, 1가지가 경합 상태로 분류되었습니다.

주요 내용

* 컨텍스트 유지 도구 (KEPT):
* CLAUDE.md (프로젝트 루트): 스택 컨벤션의 단일 소스로, Claude Code가 세션 시작 시 자동으로 로드하여 Next.js 버전 및 Server Components에서의 onClick 핸들러 작성 오류를 방지합니다.
* 사용자 범위 영구 메모리 (~/.claude/agent-memory/): 피드백 및 프로젝트별로 80여 개의 파일이 구성되어 있으며, 특히 feedback_db_constraints_phase_zero 규칙은 TypeScript에서 보이지 않는 DB 제약 조건을 사전 확인하여 오류를 줄입니다.
* ~/tef-erp/.claude/rules/ (프로젝트별 규칙): 18개의 파일로 구성되어 프로젝트 불변성과 그 이력을 문서화합니다. liste-rouge.md는 폐기된 연락처를 재활성화하는 CSV 임포트를 방지했으며, cache-auth-contract.md는 RLS 우회 사실을 명시하여 호출자가 상위에서 인증을 확인하도록 합니다.

* 호출 가능한 장치 (KEPT):
* Skills (3개 활성 파일): challenger, close-session, rembrandt-conventions 등이 있으며, 특히 falsify-before-fix 스킬은 잘못된 가설에 대한 수정 및 롤백 시간을 단축시킵니다. 이는 특정 키워드("fix", "bug", "hotfix")에 반응하여 프로토콜을 강제합니다.
* 사용자 범위 Hooks (6개 활성 파일): secret-scanner.sh, deploy-safeguard.sh 등은 커맨드 실행 전에 보안 위협(예: Vercel --prod, Supabase db push)이나 특정 패턴을 차단합니다. check-workaround-assumed.sh는 초기에 너무 광범위한 패턴에서 실제 작업 우회 어휘로 좁혀 유용성을 높였습니다.
* agent-challenger (프로젝트 범위 서브 에이전트): Tool / Question / Refutation criterion 형식으로 출력하여, 단순한 재확인이 아닌 사실 기반의 반박을 생성합니다.
* Daily Supabase drift probes: 매일 밤 5개의 프로브가 실행되어 데이터베이스의 잠재적 드리프트를 감지하며, 과거에는 감지되지 않았을 오류를 35.3일의 평균 탐지 지연 시간을 30일 이내로 줄여 나가고 있습니다.
* Sentry withMonitor + Sentry.flush(2000): 서버리스 크론에서 Sentry 타임아웃 문제를 해결하기 위해 Sentry.flush(2000)를 추가하여 Vercel 크론이 Sentry 전송 전에 종료되는 문제를 방지합니다.

* 위임 및 중재:
* agent-erp-tef (서브 에이전트, CONTESTED): 빌드 및 ESLint 오류를 과장하거나 중요하지 않은 경고를 프로덕션에 푸시하는 등의 문제가 있었습니다. 복잡한 다중 파일 작업에는 사용되지만, 실제 출력을 요구하고 DDL 마이그레이션 시 supabase/migrations/ 파일 생성을 보고하도록 조건을 두고 사용됩니다.
* agent-academique (DEV.to 시리즈): 3단계 프로토콜(scaffold, flesh, voice)을 거쳐 40일간 50개의 초안을 작성하며, 코드 스택 외부에서도 동일한 원칙을 적용합니다.
* Computer use MCP (DROPPED): 토큰 비용이 일반 세션의 약 10배에 달하여, 명시적인 사전 승인 없이는 사용되지 않습니다. macOS Photos 및 네이티브 PDF 외의 모든 작업은 전용 MCP 또는 Chrome MCP를 통해 처리됩니다.
* Counterpart Toolkit doctrine v0.7 (KEPT): 16가지 운영 규칙을 포함하는 메타 원칙으로, 다른 11가지 도구를 일관성 있게 만들어 로컬 패치를 통합된 문법으로 만듭니다.

시사점

실행을 방해하는 도구들이 비용 대비 가치가 있으며, 특히 complacency(안일함)를 유발하는 도구는 오류를 증가시킬 수 있습니다. agent-erp-tef와 같이 자체 안일함을 방해하지 못하는 도구는 실제 출력 프로토콜을 강제하는 방식의 개선이 필요하며, 이는 도구의 가치를 높이는 데 중요합니다.