코딩 에이전트용 작업 프롬프트 작성 규칙

언제 사용하나

에이전트에 작업을 맡길 때 재현 가능하고 안전한 작업 지시문을 만들 때.

작성 전 확인

• 작업의 완료 조건과 건드리면 안 되는 영역을 명확히 한다.

작업 프롬프트 구조

1. 목표: 무엇을 왜 하는지 한 문단
2. 범위: 바꿔도 되는 것 / 절대 바꾸지 말 것
3. 제약: 성능/호환/보안 요구
4. 절차: 조사 → 계획 → 구현 → 테스트 → 요약
5. 검증: 실행할 테스트/명령
6. 중단 조건: 무엇이 확인되면 멈추고 물어볼지
7. 결과 형식: 변경 요약, 실행 결과, 남은 위험

placeholder 설명

• 각 항목을 구체적 문장으로 채운다.

입력 예시

"범위: src/payment/만 수정, DB 스키마·다른 모듈 변경 금지"

기대 결과

에이전트가 범위를 지키며 검증까지 수행한 결과.

검증 방법

결과가 명시한 검증 절차와 결과 형식을 따르는지 확인한다.

주의사항과 흔한 실수

• 범위·중단 조건을 빼면 에이전트가 과하게 손댈 수 있다.
• "알아서 해줘"식 지시는 재현성이 낮다.

관련 문서

• Claude Code 모범 사례: https://docs.claude.com/en/docs/claude-code