에이전트 격리로 불필요한 토큰 소비 막기
레거시 프로젝트는 모든 로직이 서로 엉켜 있습니다. Claude Fable 5 같은 에이전트는 수정 한 번을 위해 수십 개의 연관 없는 파일까지 모두 스캔합니다. 이런 무분별한 스캔은 곧 비용 폭탄입니다. Stripe가 마이그레이션 과정에서 전체 소스를 넣지 않고 핵심 로직 단위로 모듈을 격리해 오작동을 방어했듯, 우리도 물리적인 경계가 필요합니다.
임시 세션 공간을 만들어 에이전트의 접근 범위를 강제로 제한하십시오.
- git worktree 생성: 메인 브랜치와 분리된 디렉토리에서 에이전트를 구동해 원본 코드 오염을 방지합니다.
- 접근 권한 제한:
.claude/settings.local.json파일의denyWrite속성으로 핵심 엔진과 개인 키,.env같은 인증 자산을 에이전트가 건드리지 못하게 설정합니다. - CLAUDE.md 배치: 각 디렉토리마다 에이전트가 참조할 가이드 파일을 두어 문맥을 제어합니다.
이 방식은 에이전트가 실수하더라도 원클릭 롤백이 가능하게 만들고, 불필요한 스캔 범위를 줄여 토큰 소비를 낮춥니다.
테스트 자동화 파이프라인 구축
개발자가 직접 터미널에서 테스트를 돌리고 결과를 에이전트에게 전달하는 과정은 시간 낭비입니다. Git Hook을 활용해 이 과정을 자동화하십시오. 커밋을 시도할 때 에이전트가 변경된 파일에 대해서만 테스트를 돌리고 결과를 캐싱하게 만듭니다.
.git/hooks/pre-commit 파일에 다음 로직을 삽입합니다.
- 변경 사항 감지:
git diff --name-only로 수정된 파일만 타겟팅합니다. - 테스트 연동:
npm test -- --findRelatedTests를 실행해 변경된 코드와 관련된 테스트만 수행하고 결과를.claude/diagnostics/local_test_run.log에 저장합니다. - 자율 복구: 테스트 실패 시
claude -p에--allowedTools와--dangerously-skip-permissions플래그를 붙여 호출합니다.
이 파이프라인을 쓰면 개발자는 수동 검증 없이 무결성이 검증된 빌드 자산만 커밋하게 됩니다. 주당 최소 5시간의 디버깅 시간을 줄입니다.
토큰 사용량 제어와 예산 관리
Claude Fable 5의 API 비용은 입력 100만 토큰당 10달러, 출력 50달러입니다. 장기 실행 시 예산이 빠르게 소진됩니다. 불필요한 파일 스캔을 차단하는 스크립트로 비용을 통제하십시오.
이 식에서 를 최소화하는 것이 핵심입니다. bin/optimize-fable-context.sh 스크립트를 작성해 다음을 수행하십시오.
- 동적 필터링:
git diff로 최근 수정한 파일만 검출해ACTIVE_DIR에 할당하고, 나머지 경로는.claudeignore에 동적으로 추가해 에이전트가 읽지 못하게 합니다. - 캐싱 활용: 프롬프트 캐싱 기능으로 반복 호출 영역에서 90% 할인을 적용합니다.
- 라우팅: 단순 분석은 Sonnet이나 Haiku에 맡기고, 고위험 핵심 로직 수정에만 Fable 5를 사용합니다.
이 방식을 적용하면 파일 탐색으로 인한 토큰 소모를 평균 40% 줄일 수 있습니다.
작업 로그를 관리 도구에 자동 기록
에이전트와의 협업 기록이 세션 종료와 함께 사라지면 남는 것은 관리 부채뿐입니다. 작업 내용을 Notion이나 Jira에 자동 기록하는 파이프라인을 구축하십시오.
- 정규화: Fable 5 실행 시
--json-schema플래그를 사용해 아웃풋을 고정된 JSON 규격으로 출력하게 합니다. - API 연동: 파이썬
requests라이브러리로bin/publish_agent_report.py를 작성합니다. - 문서화: 코드 리뷰 결과물을 Notion API의 마크다운 필드나 Jira Wiki Markup 형식으로 매핑해 전송합니다.
기록이 중앙에 남아야 나중에 다른 개발자가 프로젝트를 이어받을 때 혼란이 없습니다. 코드 시작과 끝에 // [AI-GEN-START]와 // [AI-GEN-END] 태그를 붙여 AI가 작성한 영역임을 명시하십시오. 명확하지 않은 코드는 TODO(human) 주석을 남겨 사람이 다시 검토하게 만들어야 레거시가 무너지지 않습니다.
