AI 요약
기존의 Claude Code를 활용한 개발은 모델의 성능에 의존하는 '가챠(뽑기)'식 품질 불균형이 실무 적용의 큰 장애물이었습니다. 이를 해결하기 위해 저자는 '생각(설계)은 인간이, 작업(구현)은 AI가' 담당하는 사양 주도 개발(Spec-Driven Development, SDD) 프레임워크를 제안합니다. 특히 클래스메소드(Classmethod)에서 공개한 오픈소스 도구인 'tsumiki'를 활용하여 요구사항 정의와 설계 단계에서 AI와 철저한 벽打ち(질의응답)을 거침으로써 설계의 완성도를 극대화했습니다. tsumiki는 불확실성을 신호등 색상으로 시각화하고, 설계된 내용을 바탕으로 AI가 자동화된 TDD 사이클을 돌려 구현을 완성하는 구조를 가집니다. 이를 통해 개인의 프롬프트 스킬 격차를 해소하고 팀 단위의 표준화된 고품질 개발 프로세스를 구축할 수 있음을 확인했습니다.
핵심 인사이트
- 사양 주도 개발(SDD): 인간이 요건 정의와 설계를 책임지고 AI가 구현 태스크를 수행하여 개발 품질의 재현성을 확보하는 프레임워크입니다.
- tsumiki 라이브러리: 일본의 클래스메소드(Classmethod)사가 개발한 도구로, cc-sdd나 OpenSpec 대비 문서 가독성과 인간에 대한 질문 기능이 뛰어납니다.
- 신호등 시스템: 요구사항(requirements.md)과 설계(design.md)의 각 항목을 청색(확실), 황색(추측), 적색(근거 없음)으로 분류하여 검토 효율을 높입니다.
- 비용 최적화: Claude Code 사용 시 월 100달러 비용으로 Opus 모델을 효율적으로 활용할 수 있는 구조를 제안합니다.
주요 디테일
- TDD 자동화 프로세스: 설계가 완료되면 AI가 Red(실패 테스트) → Green(구현) → Refactor → Verify(최종 확인)의 단계를 자동으로 수행합니다.
- 도구 비교: cc-sdd, OpenSpec 등 유사 도구들이 있으나 흐름은 '요건→설계→태스크→실현'으로 동일하며 tsumiki가 질문 단계에서 가장 꼼꼼함을 보입니다.
- 프로젝트 규칙의 중요성: 구현 단계에서 문제가 발생할 경우 사양 문제보다는 CLAUDE.md나 .claude/rules/ 등 프로젝트 규칙 정의가 미비한 경우가 많음을 지적합니다.
- 현지화된 문서화: tsumiki는 일본 개발 환경을 고려하여 직관적이고 읽기 쉬운 마크다운 문서를 생성하여 협업에 유리합니다.
- 속도 혁신: SDD 모델이 작동할 경우 복잡한 요건도 하루 만에 구현을 완료하고 익일 릴리스할 수 있는 수준의 속도감을 제공합니다.
향후 전망
- AI 개발의 표준화: 프롬프트 엔지니어링을 넘어 '컨텍스트 엔지니어링'과 '프로젝트 룰 관리'가 엔지니어의 핵심 역량이 될 것입니다.
- 분업화의 가속화: '설계 중심의 인간'과 '구현 중심의 AI'라는 분업 모델이 정착되면서 개발 주기가 획기적으로 단축될 전망입니다.