| name | test-until-green |
| description | 테스트 스위트를 실행해 실패가 나오면 가장 작은 근본 원인을 고치고, 모든 테스트가 통과(종료 코드 0)할 때까지 자동으로 반복하는 닫힌 루프입니다. 사용자가 "테스트 통과할 때까지 돌려줘", "깨진 테스트 다 고쳐줘", "테스트 초록불 만들어줘", "테스트 다 green 되게", "make all tests pass", "test until green", "fix failing tests until they pass"처럼 요청하거나, 실패하는 테스트를 반복적으로 고쳐 전부 통과시키고 싶을 때 사용하세요. (구분: 프로덕션 빌드 에러는 looping:build-until-green, 원격 CI 실패 감시는 looping:ci-failure-watcher, 불안정·간헐 실패 분류는 looping:flaky-test-triage, 커버리지 끌어올리기는 looping:coverage-until-threshold) |
테스트 통과까지 (Test Until Green)
테스트 스위트를 돌리고, 실패하면 가장 작은 근본 원인을 고치고, 모든 테스트가 통과할 때까지 반복합니다.
| 항목 | 값 |
|---|
| 카테고리 | 테스트(Testing) |
| 트리거 | 수동(manual) — 사람이 직접 시작 |
| 종료 조건(Exit) | 테스트가 종료 코드 0으로 끝날 때 |
| 반복 한도(Max iterations) | 10 |
| 매 반복 체크 명령 | npm test |
| 가드레일 | 강화됨(Hardened) |
| 지원 에이전트 | Claude Code · Cursor · Codex |
이 루프는 언제 쓰나
테스트가 여러 개 깨져 있는데 "하나씩 보면서 고쳐달라"고 일일이 지시하기 번거로울 때 씁니다. 한 번 시작하면 에이전트가 실행 → 실패 분석 → 최소 수정 → 재실행을 스스로 반복하며 전부 통과(green)에 수렴시킵니다. 핵심은 한 번에 가장 작은 근본 원인 하나만 고쳐서, 큰 변경으로 새 실패를 만들지 않는 것입니다.
대표 사례: Next.js 앱에서 깨진 Jest 스위트 3개를 6회 반복 만에 복구 — 원인은 async 타이밍, 누락된 mock, 오래된 snapshot이었고 테스트를 건너뛰지 않고 고침.
루프 흐름
수동 시작 → 테스트 실행 → 실패 수정 → 재실행 →〔피드백 게이트〕전부 통과?
↑ │ 아니오
└─────────────────────────────────────────┘
│ 예
종료
매 반복(pass)마다 하는 일
- 테스트 실행 — 프로젝트 테스트 명령을 돌려 실패를 수집합니다. →
npm test
- 실패 수정 — 현재 실패의 가장 작은 근본 원인을 고칩니다. 최소 diff를 선호하세요.
- 재실행 — 다시 테스트를 돌려 실패 0으로 수렴하는지 확인합니다. →
npm test
가드레일 (점수 조작 방지 규칙)
종료 조건을 "가짜로" 통과시키지 못하게 막는 규칙입니다. 반드시 지키세요.
- 체크 명령이나 종료 기준을 고쳐서 억지로 성공시키지 않는다.
- 체크를 건너뛰거나 비활성화·우회해서 종료 조건을 통과시키지 않는다.
- 여러 번 반복해도 막히면, 지표를 조작하지 말고 멈추고 블로커를 보고한다.
- 스위트를 통과시키려고 테스트를 약화·삭제·skip 하지 않는다.
- 진짜 단언(assertion)을 항상 통과하는 껍데기 테스트로 바꾸지 않는다.
- green으로 만들려고 테스트를 땜질하기보다 프로덕션 코드를 고치는 쪽을 택한다.
Claude Code에서 실행하기
가장 간단합니다. 아래 kickoff 프롬프트를 그대로 붙여넣으면 에이전트가 스스로 반복합니다.
"테스트 통과까지(Test Until Green)" 루프를 시작합니다.
목표: 모든 테스트 통과
최대 반복: 10
매 반복 사이 실행: npm test
종료 조건: 테스트가 종료 코드 0으로 끝날 때
1단계: 테스트를 실행한다. 실패가 있으면 가장 작은 근본 원인을 고치고 반복한다.
이 루프를 스스로 페이싱(self-pace)하라. 매 반복 후 체크 명령을 실행하고 출력을 읽어, 종료
조건이 충족되지 않았을 때만 계속한다. 종료 조건이 통과하거나 최대 반복에 도달하면 멈춘다.
매 회차마다 한 줄 상태 업데이트를 남긴다.
팁: npm test는 예시입니다. 프로젝트에 맞게 pytest, go test ./..., cargo test, pnpm test, bun test 등으로 바꾸세요.
팁 / 변형
- 수렴이 멈추면: 같은 실패가 2회 반복되면 가드레일대로 멈추고, 원인 가설과 함께 사람에게 보고하게 하세요.
- 범위 좁히기: 특정 스위트만 고치려면 체크 명령을
npm test -- <패턴>으로 좁히면 더 빠릅니다.
- 연관 루프: 통과 후 정리는
looping:de-sloppify-pass, PR까지 가려면 looping:ship-pr-until-green.
원본 영어 kickoff (loops.elorm.xyz 원문)
Start the "Test Until Green" loop.
Goal: all tests pass
Max iterations: 10
Between iterations run: npm test
Exit when: tests exit 0
Step 1: Run tests. If there are failures, fix the smallest root cause, then repeat.
Self-pace this loop. After each iteration, run the check command, read the output, and only continue if the exit condition is not met. Stop when the exit condition passes or max iterations is reached. Give a short status update each pass.
출처: https://loops.elorm.xyz/loops/test-until-green
