실패 시 중단 조건을 정의하기

언제 사용하나

에이전트가 막혔을 때 무리하게 진행하지 않고 멈춰 보고하게 할 때.

작성 전 확인

• 어떤 상황이면 사람이 판단해야 하는지 미리 정한다.

중단 조건 예시

다음이면 진행을 멈추고 상황을 보고하라:
1. 요구사항이 모호해 여러 해석이 가능할 때
2. 지정한 범위를 벗어난 변경이 필요할 때
3. 테스트를 통과시킬 수 없고 원인이 불확실할 때
4. 파괴적/되돌리기 어려운 작업이 필요할 때
5. 비밀값·권한 등 민감한 결정이 필요할 때

보고 형식: 무엇을 시도했고, 왜 막혔고, 어떤 선택지가 있는지

placeholder 설명

• 프로젝트 위험도에 맞게 조건을 조정한다.

입력 예시

"DB 스키마 변경이 필요하면 실행하지 말고 보고"

기대 결과

불확실할 때 무리한 진행 대신 명확한 질문/보고를 받는다.

검증 방법

모호한 작업을 줘서 에이전트가 멈추고 질문하는지 확인한다.

주의사항과 흔한 실수

• 중단 조건이 없으면 잘못된 가정으로 끝까지 밀어붙일 수 있다.
• 반대로 너무 자주 멈추면 비효율적이니 균형을 맞춘다.

관련 문서

• Claude Code 문서: https://docs.claude.com/en/docs/claude-code