| name | post-edit-test-guard |
| description | 파일을 편집할 때마다 그 파일과 연관된 테스트만 자동으로 돌려서 회귀(regression)를 즉시 잡아내는 훅(hook) 기반 루프입니다. 사용자가 "편집할 때마다 관련 테스트 자동 실행", "파일 고치면 바로 연관 테스트 돌려줘", "회귀 조기 감지 훅", "post-edit test guard", "run related tests after every edit", "test guard on save"처럼 편집-테스트 가드를 걸고 싶을 때 사용하세요. 이벤트 기반이라 Claude Code에서는 hooks 설정이 필요합니다. (구분: 커밋 직전 차단은 looping:pre-commit-guard, 머지 직후 스모크는 looping:post-merge-regression-guard, 전체 스위트를 수동으로 green까지 돌리는 건 looping:test-until-green) |
편집 후 테스트 가드 (Post-Edit Test Guard)
파일 편집 후 연관 테스트를 돌려 회귀를 조기에 잡는 훅 기반 루프.
| 항목 | 값 |
|---|
| 카테고리 | 테스트(Testing) |
| 트리거 | 이벤트(event) — file_edit(파일 편집) 발생 시 |
| 종료 조건(Exit) | 편집 묶음마다 연관 테스트가 종료 코드 0 |
| 매 반복 체크 명령 | npm test -- --findRelatedTests <편집된 파일> |
| 설치 파일 | 있음 — 훅 설정 필요 |
| 가드레일 | 강화됨(Hardened) |
| 지원 에이전트 | Claude Code · Cursor |
이 루프는 언제 쓰나
큰 변경을 진행할 때 "방금 고친 파일이 다른 걸 깨뜨렸나?"를 매번 수동으로 확인하기 번거로울 때 씁니다. 편집이 일어날 때마다 그 파일과 연관된 최소 테스트 집합만 자동으로 돌려, 회귀를 다음 변경으로 넘어가기 전에 잡습니다. 전체 스위트를 매번 돌리는 것보다 빠르고, 실패의 원인이 방금 한 편집이라는 게 분명합니다.
루프 흐름
〔파일 편집 시〕→ 편집된 파일 감지 → 연관 테스트 실행 →〔피드백 게이트〕
연관 테스트 통과? → 아니오: 다음 편집 전에 수정 / 예: 계속 진행
매 반복(pass)마다 하는 일
- 편집된 파일 감지 — 직전 턴에 어떤 소스 파일이 편집됐는지 식별합니다.
- 연관 테스트 실행 — 편집된 파일에 연관된 가장 작은 테스트 부분집합을 돌립니다. 실패하면 계속 진행하기 전에 고칩니다.
npm test -- --findRelatedTests
가드레일 (점수 조작 방지 규칙)
- 체크 명령이나 종료 기준을 고쳐서 억지로 성공시키지 않는다.
- 체크를 건너뛰거나 우회해서 종료 조건을 통과시키지 않는다.
- 여러 번 반복해도 막히면, 지표를 조작하지 말고 멈추고 블로커를 보고한다.
- 스위트를 통과시키려고 테스트를 약화·삭제·skip 하지 않는다.
- 진짜 단언을 항상 통과하는 껍데기 테스트로 바꾸지 않는다.
- green으로 만들려고 테스트를 땜질하기보다 프로덕션 코드를 고치는 쪽을 택한다.
Claude Code에서 실행하기
이 루프는 이벤트(훅) 기반입니다. 원본 사이트는 .cursor/·.claude/ 훅 번들 zip을 제공하지만, Claude Code에서는 .claude/settings.json의 hooks로 직접 설정하는 것이 가장 깔끔합니다.
방법 1 — 프롬프트만으로(설정 없이) 가드 켜기
아래를 붙여넣으면, 이번 세션 동안 에이전트가 편집할 때마다 스스로 연관 테스트를 돌립니다.
"편집 후 테스트 가드(Post-Edit Test Guard)" 루프를 켭니다.
목표: 파일을 한 묶음 편집할 때마다, 연관 테스트가 통과해야 다음으로 넘어간다.
매 반복 사이 실행: npm test -- --findRelatedTests <편집된 파일>
종료 조건: 연관 테스트가 종료 코드 0일 때.
1단계: 편집 후 연관 테스트를 돌린다. 실패하면 더 변경하기 전에 고친다.
방법 2 — .claude/settings.json 훅으로 영구 자동화 (권장)
편집 도구(Edit/Write) 사용 후 자동으로 연관 테스트가 돌도록 PostToolUse 훅을 등록합니다.
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write|MultiEdit",
"hooks": [
{ "type": "command", "command": "npm test -- --findRelatedTests $CLAUDE_FILE_PATHS 2>&1 | tail -40" }
]
}
]
}
}
저장 후 Claude Code 세션을 재시작하면 훅이 등록됩니다. 훅 출력(테스트 실패)이 에이전트에게 전달되므로, 위 kickoff를 한 번 붙여넣어 "실패하면 다음 편집 전에 고친다"는 규칙을 알려 두면 됩니다.
참고: 훅은 "언제 깨어날지"를 자동화하고, kickoff는 "매 회차 무엇을 할지"를 정의합니다. 둘은 보완 관계입니다.
팁 / 변형
- 테스트 러너 교체:
--findRelatedTests는 Jest 기능입니다. Vitest는 vitest related, 파이썬은 pytest --picked(pytest-picked) 등으로 바꾸세요.
- 연관 루프: 커밋 직전 차단은
looping:pre-commit-guard, 머지 직후 스모크는 looping:post-merge-regression-guard.
원본 영어 kickoff (loops.elorm.xyz 원문)
Install and run the "Post-Edit Test Guard" loop.
Goal: after each batch of file edits, related tests must pass before continuing.
Between iterations run: npm test -- --findRelatedTests <edited files>
Exit when: related tests exit 0.
Step 1: After edits, run related tests. If they fail, fix before making more changes.
출처: https://loops.elorm.xyz/loops/post-edit-test-guard
