Santa Augmentcode Intent Ep.5

Context

기존 소프트웨어 개발에서는 개발자가 대략적인 아이디어로 즉시 코드 작성을 시작하는 "Build First, Discover Later" 패턴이 일반적이었다. 이로 인해 절반 이상 진행된 후 이해관계자가 의도와 다른 결과물을 발견하게 되고, 모든 작업을 다시 수행해야 하는 문제가 발생했다. 또한 코드 리뷰는 2,000줄 이상의 Pull Request를 검토하기 때문에 비용이 높고 오류 가능성이 크다.

Technical Solution

• 스펙을 코드 작성 이전의 주요 산출물로 정의: 개발 시작 전에 목표, 성공 기준, 제약조건, 의존성을 명시적으로 문서화
• Coordinator Agent가 스펙 존재 확인 후에만 Specialist Agent 생성: 스펙 작성 없이 구현이 진행되지 않도록 강제
• 스펙을 동적으로 업데이트: 에이전트가 작업 완료, 의사결정 기록, 새로운 제약조건 발견할 때마다 스펙 자동 갱신
• 스펙 리뷰를 코드 리뷰보다 우선 배치: 구현 전 의도 검토를 별도로 진행하여 기본 오정렬을 조기에 포착
• Verifier Agent가 구현된 코드를 스펙에 대해 검증: 스펙을 진실의 원천으로 삼아 코드가 의도에 부합하는지 확인

Impact

SDD 워크플로우에서 스펙 작성은 10분 소요되며 수일 규모의 재작업을 절감할 수 있다.

Key Takeaway

소프트웨어 팀이 변경 불가능한 마감일 제약 하에서 스펙을 명시적으로 정의하면 범위 변경이 가시화되고, 조기에 의사결정 대화를 갖게 되어 마지막 순간의 재작업 비용을 크게 줄일 수 있다.