Claude의 작업 표류 방지를 위한 Spec-Driven Development (SDD) SOP

커뮤니티 반응

작성자의 SOP가 오버헤드가 클 수 있다는 의견과 함께, 작업 표류 문제에 공감하며 유사한 해결책을 찾는 사용자들의 반응이 있음.

주요 논점

01찬성분열

AI 코딩 시 명세 기반 개발(SDD)을 통해 모델의 작업 표류를 방지할 수 있다.

합의점 vs 논쟁점

합의점

긴 세션에서 AI 모델의 작업 표류(Drift) 현상은 실무에서 흔히 발생하는 문제임

논쟁점

SDD 방식이 모든 프로젝트에 적용하기에 오버헤드가 크지 않은가에 대한 의문

실용적 조언

세션 시작 시 현재 상태를 정의한 문서(SPRINT.md 등)를 읽게 하여 맥락 유실 방지
구현 전 테스트를 먼저 작성하여 모델의 잘못된 코드 생성을 방지

섹션별 상세

AI 코딩 세션에서 발생하는 작업 표류 문제: 세션이 진행될수록 모델이 요구사항을 임의로 재해석하거나 불필요한 기능을 추가하는 현상이 반복됨. 작성자는 이를 'untethered' 상태라고 정의하고, 규제 산업의 변경 관리 방식을 도입하여 해결하고자 함.

Spec-Driven Development(SDD) SOP 도입: SPEC.md(요구사항), 설계 문서, 계획, 테스트, 코드 순으로 이어지는 문서 스택을 AI의 작업 메모리로 활용함. 모든 작업은 승인된 설계 문서 없이는 구현하지 않는다는 원칙을 세움.

역할 분리 및 테스트 우선 전략: Planner, Test Designer, Developer, Spec Reviewer, Code Reviewer 등 5개 역할을 정의하고, 각 에이전트가 역할을 혼용하지 않도록 제한함. 구현 전 Test Designer가 명세에 기반한 실패 테스트를 작성하여 개발자가 올바른 방향으로 코드를 작성하도록 강제함.

세션 시작 프로토콜 및 규칙 적용: 모든 세션 시작 시 AGENTS.md와 SPRINT.md를 읽고 현재 위치를 보고하게 하여 맥락 유실을 방지함. 총 8가지 규칙을 통해 '빠른 수정'조차도 설계 문서 승인 절차를 거치도록 하여 일관성을 유지함.

언급된 리소스

GitHubAI-SDD-SOP GitHub