Part 1 · Ch05 · SDD

좋은 spec이란 — 다섯 가지 질문

spec은 길 필요가 없다. 다만 다른 엔지니어나 AI가 읽고 올바른 결과를 만들 수 있을 만큼 다섯 질문에 명시적으로 답해야 한다.
What 무엇
입력·출력·관측 가능한 동작. 무엇이 들어가고 무엇이 나오는가.
Why
성공 기준·측정 가능한 결과. 성공했는지를 숫자로 말할 수 있어야.
무게중심
Constraints 제약
성능·호환성·컨벤션. 응답 시간, 하위 호환성, 프레임워크 관례.
Boundaries 경계
명시적으로 범위 밖인 것. 빠지면 AI가 멋대로 범위를 넓힌다.
무게중심
Edge cases 엣지
빈 입력·타임아웃·부분 실패·설정 누락. 여기서 코드 품질이 갈린다.
무게중심은 3번 Constraints와 5번 Edge cases — 제약이 헛다리를 막고, 엣지가 자기 교정 루프를 돕는다. 4번 Boundaries는 가장 값싼 안전장치.