에이전트 결과 보고 형식을 표준화하기

언제 사용하나

에이전트 작업 결과를 매번 같은 형식으로 받아 검토를 빠르게 할 때.

작성 전 확인

• 검토에 꼭 필요한 정보(변경/검증/위험)를 정한다.

표준 보고 형식

## 작업 요약
{{한두 문장}}

## 변경 내역
- {{파일/모듈}}: {{무엇을 왜}}

## 실행·검증
- 실행한 명령: `{{CMD}}`
- 결과: {{통과/실패 요약}}

## 남은 위험 / 확인 필요
- {{미해결/가정/후속 작업}}

## 건드리지 않은 것
- {{범위 밖으로 남겨둔 것}}

placeholder 설명

• 각 항목을 실제 내용으로 채우게 한다.

입력 예시

"변경 내역과 실행한 테스트 결과를 반드시 포함"

기대 결과

일관된 형식으로 빠르게 검토·승인할 수 있다.

검증 방법

보고에 검증 결과와 남은 위험이 항상 포함되는지 확인한다.

주의사항과 흔한 실수

• "다 했습니다"만 있는 보고는 검토가 어렵다.
• 실패를 숨기지 말고 그대로 보고하게 한다.

관련 문서

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