에이전트 요청의 완료 정의 3줄 | 범위, 금지, 완료 조건

AI 에이전트에게 '모두 해줘'라고 넘기면, 범위를 벗어난 차이점, 임의로 추가된 의존성, 끝을 알 수 없는 탐색 등이 늘어나기 쉽습니다. 품질 게이트(quality gate) 전에 요청 자체의 완료 정의를 3줄로 고정하는 것이 중요합니다.

예상 독자: Cursor나 Claude Code에서 에이전트에게 구현을 맡기기 시작한 엔지니어

연결: AI 출력을 납품으로 만들기 전의 품질 게이트 3가지

작성하지 않을 것: 미확인 속도나 매출에 대한 이야기. 화면 예시는 설명용 더미로 한정합니다.

결론

에이전트에게 요청할 때는 범위(scope), 금지(prohibition), 완료 조건(completion condition)의 3가지가 충분합니다.

3줄이 없는 요청은 품질 게이트 전에 '무엇을 통과시킬지'가 결정되지 않았다는 의미입니다. 게이트는 후보를 통과시킬지 말지 보는 장치입니다. 3줄은 무엇을 요청했는지, 언제 끝날지를 미리 작성해 주는 것입니다.

왜 게이트 전에 3줄이 필요한가?

게이트에 넘기기 전의 차이점(diff)이 이미 지저분한 경우가 있습니다. 무관한 파일, 리포지토리 전체를 정리하는 작업, 끝없는 탐색 등이 그것입니다. 이는 합격/불합격을 판단하기 전에 일어나고 있는 일입니다.

3줄은 그 이전에 배치되어야 합니다.

• 범위는 건드려도 되는 장소(area)입니다.
• 금지는 해줬으면 하지 않는 작업입니다.
• 완료 조건은 사람이 보고 '끝났다'라고 말할 수 있는 상태입니다.

이 3가지가 없으면, 에이전트는 '도움이 될 것 같은 변경 사항'을 계속 추가합니다. 끝난 후보를 만들 수 없기 때문에, 게이트에 넘길 것도 할 수 없습니다.

요청 직후에 3줄을 배치하고, 그 3줄 다음에 실행합니다. 실행 결과 중 '끝났다'고 말할 수 있는 것만 품질 게이트로 전달합니다.

3줄 작성 방법

설명용 더미입니다. 고객 이름이나 실제로 존재하는 리포지토리 경로도 포함되어 있지 않습니다. 경로와 완료의 기준만 자신의 요청에 맞게 변경하세요.

## 범위
- 건드려도 되는 경로: `src/ui/Button.tsx` 뿐
## 금지
...

금지는 작업의 이름으로 작성합니다. 의존성 추가, 포맷팅 등