AI 코딩 에이전트에게 실행 가능한 사양을 주는 방법

코딩 에이전트는 성공 조건이 관찰 가능할 때 더 안정적입니다. Microsoft의 spec-driven development는 의도와 acceptance criteria를 담은 living specification을 code와 test에 맞춰 계속 업데이트합니다.

1. 결과부터 작성

사용자와 보이는 동작을 먼저 설명합니다.

Goal: A signed-in learner can resume the lesson they started most recently.

User-visible behavior:
- The dashboard shows the most recently started lesson.
- Selecting it opens the lesson at the next incomplete step.
- A learner with no progress sees the existing “Start learning” action.

2. Acceptance criteria

정상 경로, 빈 상태, 잘못된 입력, 권한, 실패 동작을 포함합니다.

Acceptance criteria:
- A learner sees only their own progress.
- Missing progress does not cause a request or render error.
- A completed lesson points to the next lesson, or to the completion state.
- The existing dashboard remains unchanged for signed-out visitors.
- Automated tests cover the resume, empty, and unauthorized cases.

3. 조사 후 계획

Agent가 routes, components, data access, tests를 찾고 계획과 불확실성을 제시하게 합니다. 기존 계약을 보존하는지 확인합니다.

4. 실행 가능하게 만들기

팀이 관리하는 version-controlled 문서나 issue에 저장하고 각 기준을 테스트 또는 수동 확인에 연결합니다.

5. 사람의 검토 지점 유지

Sources: Microsoft on spec-driven development, Build with agents in VS Code, and VS Code trust and safety.

6. 업데이트

사양은 버리는 prompt가 아닙니다. 테스트나 제품 결정이 바뀌면 수정하고 각 기준의 증거를 확인한 뒤 완료합니다.