Silent Delegation 제거를 통한 API Contract 무결성 확보 전략

Context

AI Agent 기반 코드 생성 시 Gherkin 문법의 정확성만으로는 구현체의 일관성을 보장하지 못하는 한계 존재. 모호한 Spec이 AI의 자의적 판단(Reasonable Decision)을 유도하여 런타임에 API Contract 불일치 문제를 야기하는 구조적 결함 분석.

Technical Solution

• Internal Implementation Leakage 방지를 위해 DB 필드명(db_status) 대신 외부 노출용 도메인 용어(status) 정의
• Underspecified Given 절의 모호성을 제거하여 404, 422 등 HTTP Response Code의 명확한 규정
• ISO 8601 등 데이터 포맷의 강제 명시를 통한 필드 값의 일관성 확보
• Spec 작성 단계에서 '남겨진 결정 사항(Open Decisions)'을 전수 조사하여 AI의 자의적 해석 가능성 차단
• 구현체와 Spec 간의 일치 여부를 단순 Test Pass 여부가 아닌 Contract 준수 여부로 재정의