클로드 코드의 사양 기반 개발 워크플로우: 분해, 컨텍스트 정리 및 비용 관리

Spec Driven Development Workflow (SDDW)라는 새로운 오픈소스 플러그인이 구조화된 분해와 컨텍스트 관리를 통해 복잡한 작업에서 Claude Code의 성능을 향상시키는 것을 목표로 합니다. 개발자 sermakarevich가 Hacker News에 공유한 이 접근법은 Claude의 기본 plan + code 모드가 한계를 보이는 중대형 프로젝트를 위해 설계되었습니다.

핵심 개념

• 2차원 분해: 먼저 여러 단계(요구사항, 코드 분석, 설계)로 사양을 생성합니다. 그런 다음 구현을 하위 작업으로 나누어 하나씩 실행합니다.
• 단계 간 컨텍스트 초기화: 사양 생성 후와 각 하위 작업 구현 후에 컨텍스트를 초기화합니다. 이렇게 하면 비용이 낮게 유지되고 집중력이 향상되어 성능이 향상됩니다.
• 디스크에 사양 저장: 영구적인 사양 파일이 세션 간 정보를 유지하여 컨텍스트 초기화 시 손실을 방지합니다.
• 계층별 전달: 사양을 점진적으로 전달하여 초기에 오해를 발견합니다.

사용 시기

저자에 따르면 SDDW는 plan + code가 잘 작동할 때 이를 대체하는 것이 아닙니다. plan + code가 기능이 너무 복잡해서 실패하는 시나리오를 위한 것입니다. 이중 분해는 혼란을 줄이고 복잡한 작업의 성공률을 높이는 데 도움이 됩니다.

저자는 또한 SDDW가 에이전트 플릿과 잘 작동한다고 언급합니다. SDDW 단계 시퀀스를 큐에 삽입하고 여러 에이전트가 하위 작업을 처리하게 할 수 있습니다.

다른 도구와 비교

GSD(일반화된 사양 기반 개발)과 같은 도구와 비교할 때, SDDW는 중간 규모 프로젝트에 맞춰져 있습니다. GSD는 훌륭했지만 작은 작업에는 토큰 소모가 컸습니다. SDDW는 일반적인 프로젝트 규모에 맞게 조정할 수 있습니다.

커뮤니티의 비판

일부 HN 댓글 작성자들이 우려를 제기했습니다:

• 에이전트 준수 및 태만 — 상세한 사양이 있어도 에이전트가 여전히 상당한 다듬기와 광택이 필요한 출력을 생성할 수 있습니다.
• 공식적인 벤치마크 부재 — 저자는 성공 측정이 주관적임을 인정하지만, plan + code가 실패하고 SDDW가 작동하면 순이익이라고 주장합니다.
• 사양을 실행할 수 없는 코드로 봄 — 충분히 상세한 사양은 거의 코드와 동등하므로 오버헤드가 항상 정당화되지는 않을 수 있습니다.

시작하기

플러그인은 GitHub에서 사용할 수 있습니다: github.com/sermakarevich/sddw. 더 자세한 내용이 담긴 슬라이드는 HN 토론에 링크되어 있습니다.