피드로 돌아가기
Claude Code를 활용한 예측 가능한 바이브 코딩 전략
컬리 기술블로그컬리 기술블로그
AI/ML

Claude Code를 활용한 예측 가능한 바이브 코딩 전략

Claude Code와 LLM 기반 에이전트의 인지적 한계를 Todo, Plan 모드, 서브에이전트, CLAUDE.md로 시스템화하여 예측 가능한 바이브 코딩 구현

2025년 12월 17일16intermediate

Context

LLM 기반 에이전트(Claude Code)로 자동 코드 생성 시 요구사항이 누락되고 오류가 눈덩이처럼 커지는 문제가 발생한다. Lost in the Middle 현상으로 긴 스펙 문서의 중간 정보가 무시되고, 학습 데이터 편향으로 구버전 패턴이 반복되며, 작업 기억 한계로 여러 규칙을 동시에 추적하지 못한다.

Technical Solution

  • 요구사항 관리: Todo 리스트로 스펙을 명시적으로 항목화하여 각 요구사항이 누락되지 않도록 추적
  • 단계별 검증: Plan 모드로 에이전트의 계획을 사전에 확인한 후 실행하여 대규모 오해 방지
  • 작업 분리: 복잡한 작업을 서브에이전트로 분리하여 각 에이전트가 관리할 컨텍스트 크기 축소
  • 컨벤션 고정: 디렉토리별 CLAUDE.md 파일에 사용할 기술 버전과 패턴을 명시적으로 저장하여 긴 대화에서 정보 희석 방지
  • 자동 검증: Agent Skills로 반복되는 검사 로직을 작성하여 일회성 피드백의 학습 불가 문제 해결
  • 컨텍스트 최소화: Compact 방식으로 이전 대화 히스토리를 압축하여 중요 정보의 weight 증가

Key Takeaway

LLM의 작업 기억 한계는 근본적으로 해결 불가능하므로, 시스템 수준에서 외부 도구(Todo, Plan 모드, 파일 시스템)를 작업 공간으로 제공하고 반복 가능한 규칙을 스킬로 자동화하는 것이 예측 가능한 에이전트 개발의 핵심이다.


Claude Code를 사용하는 개발팀에서 30개 항목 이상의 스펙을 구현할 때, 전체 문서를 한 번에 전달하는 대신 Todo로 5~7개 항목씩 분리하고 Plan 모드로 각 단계를 사전 검증한 후 실행하면, 요구사항 누락과 오류 중첩으로 인한 재작업을 70% 이상 줄일 수 있다.

원문 읽기