테스트·빌드를 자동 실행하는 하네스 설정

언제 사용하나

에이전트가 변경 후 스스로 빌드·테스트를 돌려 회귀를 잡게 할 때.

작성 전 확인

• 빠르게 도는 테스트 명령과 전체 검증 명령을 구분한다.

설정 방법

지침 파일(AGENTS.md/CLAUDE.md)에 명시:
- "코드를 바꾼 뒤 반드시 `{{TEST_CMD}}`를 실행하고 통과시켜라."
- "빌드는 `{{BUILD_CMD}}`로 확인하라."
- "테스트가 실패하면 원인을 고치거나, 못 고치면 멈추고 보고하라."

CI에도 동일 게이트를 두어 사람이 놓쳐도 막는다:
- PR에서 빌드·테스트·린트를 필수 통과로 설정

placeholder 설명

• {{TEST_CMD}} / {{BUILD_CMD}} : 테스트/빌드 명령

입력 예시

{{TEST_CMD}} = ./gradlew test

기대 결과

에이전트가 통과하는 상태로만 작업을 마무리한다.

검증 방법

일부러 실패하는 변경을 유도해 에이전트가 감지·보고하는지 본다.

주의사항과 흔한 실수

• 전체 테스트가 너무 느리면 핵심 테스트부터 빠르게 돌리게 한다.
• 지침에만 의존하지 말고 CI 게이트로 이중 방어한다.

관련 문서

• GitHub Actions: https://docs.github.com/ko/actions