GSD-Lite: TDD를 강제하고 테스트 생략을 방지하는 Claude 코드용 상태 머신

GSD-Lite는 Claude Code에 부착되어 실행되며 프로젝트를 12단계 워크플로우 머신을 통해 처리하는 오픈소스 MCP 서버입니다. 이 도구는 MIT 라이선스를 따르며 총 약 15개의 소스 파일로 구성되어 있습니다.

작동 방식

Claude와의 대화를 통해 구축할 내용을 계획한 후, GSD-Lite가 자동으로 인수합니다: 코드 작성, 검토, 검증, 다음 단계로 진행. 실행 루프는 다음과 같은 패턴을 따릅니다:

• 오케스트레이터가 다음 작업 선택
• 실행자가 코드 작성 (TDD, 체크포인트)
• 검토자가 확인 (별도 컨텍스트, 사양 + 품질)
• 승인? 다음 작업. 거부? 재작업.
• 모든 작업 완료? 단계 게이트 확인
• 게이트 통과? 다음 단계
• 모든 단계 완료? 완료

주요 기능

TDD 강제: "철의 법칙"이 모든 작업 디스패치에 내장되어 있습니다: 실패하는 테스트 없이는 프로덕션 코드를 작성할 수 없습니다. 프롬프트는 Claude가 테스트를 건너뛰기 위해 사용하는 정확한 합리화들("이건 그냥 설정 변경이야", "기존 테스트가 이미 이것을 커버하고 있어")을 나열하고 이를 알려진 변명으로 표시합니다.

별도 에이전트 컨텍스트: 검토는 별도의 에이전트 컨텍스트에서 실행되며, 검토자는 실행자의 추론을 전혀 보지 않고 오직 diff와 작업 사양만 확인합니다. 이는 고무도장 찍기를 방지하고 실제 버그를 잡는 데 도움이 됩니다.

디버거 에이전트: 작업이 3번 실패하면, 재시도 대신 디버거 에이전트가 디스패치됩니다. 이 별도의 에이전트는 실패를 재현하고, 가설을 세우고, 이를 테스트하며, 수정이 이루어져야 할 위치를 식별한 후 결과를 실행자에게 제공합니다.

의존성 추적: 한 작업이 API 시그니처를 변경하면, 하류에 있는 모든 것이 자동으로 무효화되고 재대기열에 들어갑니다.

기술적 세부사항

시스템은 6개의 명령어, 4개의 에이전트, 11개의 MCP 도구를 사용합니다. 상태는 하나의 JSON 파일에서 관리되며 스키마 검증과 버전 충돌은 낙관적 동시성 제어를 통해 처리됩니다.

원본 버전이 아닌 이유

첫 번째 버전에는 32개의 명령어, 12개의 에이전트, 100개가 넘는 소스 파일, 그리고 2400줄의 설치 프로그램이 있었습니다. 저자는 그 복잡성의 대부분이 가치를 제공하지 못하면서 컨텍스트 창을 소모하고 있다고 판단하여 버리고 처음부터 다시 작성했습니다.

예상치 못한 발견

반합리화 접근법은 효과가 있었습니다—에이전트 프롬프트에 Claude가 단계를 건너뛰기 위해 사용하는 특정 문구들을 직접 나열하는 것이 건너뛰기 비율을 줄였습니다. 저자는 부정적인 예시들이 단순히 "항상 테스트를 작성하라"고 말하는 것보다 모델을 더 잘 조종하는 것 같다고 언급합니다. 세션 지속성이 가장 어려운 구현 과제였습니다.