속도보다 정확도, Claude Code의 무분별한 코딩을 막는 FRAME 구조

Context

AI 코딩 도구의 빠른 실행 속도가 오히려 요구사항 오해와 중복 작업의 원인으로 작용. 명확한 합의 과정 없이 코드를 작성하여 결과물의 일관성이 결여되는 구조적 한계 발생.

Technical Solution

• Markdown 파일 기반의 역할 정의 및 단계별 승인 게이트(Gate) 도입을 통한 통제 구조 설계
• SHAPE, BREAKDOWN, DESIGN, BUILD, CHECK의 5단계 워크플로우를 통해 요구사항 추출부터 검증까지 단계적 수행
• Cartridge 개념을 도입하여 소프트웨어 개발, 코드 감사 등 도메인별 최적화된 역할과 절차를 모듈화
• 프로젝트 목표, 제약 사항, 수용 기준을 명시한 SHAPE 블록을 생성하여 구현 전 개발 계약(Contract) 확립
• 각 단계의 결정 사항을 파일로 기록하여 세션의 상태를 보존하고 추적 가능한 기록물(Record) 생성
• 별도의 런타임이나 종속성 없이 Markdown 파일 복사만으로 동작하는 Zero-Infrastructure 지향 설계

Impact

• 단순 버그 수정 시 Plain Claude Code(1분) 대비 FRAME(10분)으로 소요 시간 증가
• 프로세스 기반 접근을 통해 단순 직관으로는 발견하지 못한 엣지 케이스(공백 문자열 처리 등) 추가 발굴

Key Takeaway

결과물 생성 속도보다 중요한 것은 '완료의 정의(Definition of Done)'에 대한 상호 합의이며, 구조화된 프로세스는 복잡한 의사결정이 필요한 작업에서 휴먼 에러를 줄이는 핵심 장치임.