looping-skills

변경된 라우트/페이지에 axe·pa11y·eslint-plugin-jsx-a11y 같은 접근성(a11y) 자동 검사를 돌려서 라벨·색 대비·포커스 순서·ARIA 역할 같은 위반을 고치고, 감사가 깨끗해질 때(위반 0, 종료 코드 0)까지 자동으로 반복하는 닫힌 루프입니다. 사용자가 "접근성 검사 통과할 때까지 돌려줘", "a11y 위반 다 고쳐줘", "접근성 감사 깨끗해질 때까지", "axe/pa11y 위반 잡아줘", "스크린리더·키보드 접근성 고쳐줘", "run a11y audit until clean", "fix accessibility violations", "A11y Audit Until Clean"처럼 요청하거나, 변경한 UI의 접근성 위반을 반복적으로 잡아 없애고 싶을 때 사용하세요. (구분: 시각적 픽셀 회귀는 looping:visual-regression-until-match, lint·타입 에러 정리는 looping:lint-typecheck-fix, E2E UI 통합 테스트는 looping:e2e-until-green)

OpenAPI나 JSON Schema 같은 API 계약(contract)에 맞춰 계약 테스트를 돌리고, 응답이 스펙과 어긋나면(드리프트) 핸들러 구현이나 스펙을 가장 작은 단위로 고쳐서 계약 테스트가 전부 통과(종료 코드 0)할 때까지 자동으로 반복하는 닫힌 루프입니다. 사용자가 "API가 스펙대로 응답하는지 계약 테스트 돌려줘", "OpenAPI 계약이랑 구현 안 맞는 거 맞춰줘", "API 응답이 스키마랑 일치할 때까지 고쳐줘", "문서랑 구현 드리프트 잡아줘", "contract test until match", "make the API match the OpenAPI/JSON Schema contract", "API Contract Until Match"처럼 요청하거나, 문서와 실제 구현 사이의 계약 불일치를 반복적으로 맞추고 싶을 때 사용하세요. (구분: openapi.yaml 자체를 lint하고 라우트 핸들러와 동기화하는 건 looping:openapi-sync-until-valid, README·API 레퍼런스 등 문서를 코드에 맞추는 건 looping:docs-sync-after-edits, spec.md 체크리스트대로 신규 기능을 구현하는 건 looping:spec-first-ship, 전체 테스트 스위트를 green까지 돌리는 건 looping:test-until-green)

실패하는 테스트를 먼저 쓰고 → 통과시킬 최소한의 코드를 구현하고 → 리팩터하는 red-green-refactor TDD 사이클을, 대상 동작이 테스트로 완전히 덮이고 전체 스위트가 통과할 때까지 자동으로 반복하는 닫힌 루프입니다. 사용자가 "TDD로 만들어줘", "테스트 먼저 쓰고 구현해줘", "red-green-refactor로 돌려줘", "실패 테스트부터 작성해서 기능 추가해줘", "테스트 주도로 이 기능 구현해줘", "Autoloop TDD", "test-first loop", "write a failing test then implement", "TDD this feature"처럼 테스트를 먼저 작성해 새 기능을 구현하고 싶을 때 사용하세요. (구분: 이미 깨진 기존 테스트를 통과시키는 건 looping:test-until-green, 커버리지 %를 채우려고 테스트만 추가하는 건 looping:coverage-until-threshold, spec.md 체크리스트로 요구사항을 하나씩 구현하는 건 looping:spec-first-ship, E2E 스위트를 green으로 만드는 건 looping:e2e-until-green)

프로덕션 빌드를 실제로 돌려 컴파일·타입·번들링 에러를 한 번에 하나씩 고치고, 빌드가 종료 코드 0으로 성공할 때까지 자동으로 반복하는 닫힌 루프입니다. 사용자가 "빌드 통과할 때까지 돌려줘", "빌드 에러 다 고쳐줘", "빌드 깨진 거 green 될 때까지", "프로덕션 빌드 성공시켜줘", "npm run build 통과하게", "build until green", "fix build errors until it compiles", "make the production build pass"처럼 요청하거나, 빌드가 깨진 걸 반복적으로 고쳐 성공시키고 싶을 때 사용하세요. (구분: 테스트 스위트 실패를 고치는 건 looping:test-until-green, lint·타입체크 에러 정리는 looping:lint-typecheck-fix, 원격 CI 빌드 실패 감시는 looping:ci-failure-watcher, 번들 사이즈 예산 초과는 looping:bundle-size-budget)

프로덕션 빌드를 돌려 클라이언트 번들 크기를 측정하고, 설정한 size-limit 예산을 넘으면 무거운 모듈 dynamic import·미사용 의존성 제거·라우트 분할로 다이어트한 뒤 size-limit이 종료 코드 0으로 통과할 때까지 자동으로 반복하는 닫힌 루프입니다. 사용자가 "번들 크기 줄여줘", "번들 예산 안 넘게 해줘", "size-limit 통과시켜줘", "번들 다이어트해줘", "client bundle 가볍게 유지해줘", "bundle size budget", "keep the client bundle under budget", "loop until size-limit passes"처럼 클라이언트 번들을 예산 이하로 끌어내리고 싶을 때 사용하세요. (구분: 빌드 자체를 성공시키는 건 looping:build-until-green, 죽은 export·미사용 파일·고아 의존성 정리는 looping:knip-until-clean, 의존성을 하나씩 안전하게 업그레이드하는 건 looping:dependency-upgrade-one-by-one)

기능을 출시(ship)한 직후, 마지막 태그 이후의 커밋을 훑어 CHANGELOG.md의 [Unreleased] 섹션에 사용자 관점 항목을 채우고 conventional commits를 반영할 때까지 반복하는 수동 루프입니다. 사용자가 "체인지로그 업데이트해줘", "방금 출시한 거 CHANGELOG에 반영해줘", "릴리스 노트 정리해줘", "CHANGELOG 동기화", "changelog sync after ship", "update the changelog for this release", "sync CHANGELOG after shipping"처럼 출시·머지 직후 변경 이력을 사용자 친화적으로 정리하고 싶을 때 사용하세요. (구분: README·API 레퍼런스·주석 등 일반 문서 동기화는 looping:docs-sync-after-edits, openapi.yaml 스펙 동기화는 looping:openapi-sync-until-valid, API 응답이 계약과 맞는지 검증은 looping:api-contract-until-match, 작성한 spec.md 체크리스트대로 구현은 looping:spec-first-ship)

원격 CI를 일정 간격(기본 5분)마다 폴링해서, 체크가 빨개지면(red) 실패를 조사하고, green이 될 때까지 수정을 push 하는 인터벌 루프입니다. 사용자가 "CI 빨간불 뜨면 자동으로 고쳐줘", "CI 5분마다 감시하다 깨지면 수정", "CI 초록 될 때까지 지켜봐", "gh run 폴링해서 실패 추적·수정", "watch CI", "CI failure watcher", "poll CI until green", "investigate CI failures and push fixes"처럼 원격 CI 상태를 주기적으로 감시하다가 실패를 자동으로 추적·수정하고 싶을 때 사용하세요. (구분: 사람이 직접 한 번 돌리는 CI 수정은 looping:fix-ci-until-green, 여러 PR을 주기적으로 돌보는 건 looping:pr-babysitter, 배포 후 헬스·스모크 엔드포인트 감시는 looping:deploy-verification-loop, 로컬 프로덕션 빌드 통과는 looping:build-until-green)

테스트를 추가해 코드 커버리지(coverage)를 목표 임계치(예: 80%)까지 끌어올리는 닫힌 루프입니다. 프로덕션 동작은 불필요하게 바꾸지 않고, 커버되지 않은 분기에만 집중 테스트를 더해 "임계치 충족 + 전체 테스트 통과(종료 코드 0)"에 수렴시킵니다. 사용자가 "커버리지 80%까지 올려줘", "테스트 커버리지 끌어올려줘", "커버리지 임계치 채워줘", "안 덮인 코드에 테스트 추가해줘", "coverage until threshold", "raise test coverage to 80%", "add tests until coverage passes"처럼 커버리지 목표를 채우고 싶을 때 사용하세요. (구분: 그냥 깨진 테스트를 통과시키는 건 looping:test-until-green, 실패 테스트를 먼저 쓰는 TDD 사이클은 looping:autoloop-tdd, 불안정·간헐 실패 분류는 looping:flaky-test-triage, e2e 스위트 통과는 looping:e2e-until-green)

구현이 끝난 직후 "정리 패스"를 한 번 돌려, 디버그 로그·죽은 분기·주석 처리된 코드·TODO 땜질·들쭉날쭉한 네이밍을 걷어내고 프로젝트 컨벤션에 맞춰 다듬는 닫힌 루프입니다. 매 회차 lint와 테스트로 동작이 깨지지 않았는지 확인합니다. 사용자가 "구현 끝났으니 정리 한 번 돌려줘", "방금 짠 코드 슬롭 정리해줘", "디버그 코드랑 죽은 코드 싹 치워줘", "네이밍 다듬고 컨벤션 맞춰줘", "AI가 짠 지저분한 코드 정리", "de-sloppify", "de-sloppify pass", "cleanup pass after implementation", "remove debug code", "tighten naming", "delete dead branches", "align with project conventions"처럼 요청할 때 사용하세요. (구분: 시니어 관점으로 자기 diff를 검토하는 자기 리뷰는 looping:pr-self-review, 사용되지 않는 export·파일·고아 의존성 제거는 looping:knip-until-clean, 포매터로 스타일만 맞추는 건 looping:format-until-clean, lint·typecheck 오류만 잡는 건 looping:lint-typecheck-fix)

매주 한 번 오래된(outdated) 의존성을 훑어 패치·마이너·메이저로 분류하고, 깨질 위험이 낮은 것부터 안전한 업그레이드 계획을 요약으로 내놓는 인터벌 루프입니다. 코드를 바꾸지 않고 "이번 주에 뭘 올릴지"만 제안합니다. 사용자가 "주간 의존성 점검", "매주 outdated 패키지 확인하고 업그레이드 제안해줘", "의존성 업데이트 요약 주간으로 돌려줘", "dependency audit weekly", "weekly dependency audit", "check outdated deps and propose safe upgrades"처럼 정기적으로 의존성 현황을 점검하고 안전한 업그레이드안을 받고 싶을 때 사용하세요. (구분: 실제로 한 번에 하나씩 올리고 깨진 걸 고치는 건 looping:dependency-upgrade-one-by-one, 보안 취약점을 주간 스캔하는 건 looping:security-audit-weekly, npm audit 고·심각 취약점을 하나씩 고치는 건 looping:npm-audit-fix-loop, 미사용 의존성 제거는 looping:knip-until-clean)

오래된(outdated) 의존성을 한 번에 하나씩만 업그레이드하고, 그 패키지가 일으킨 타입 에러·API 변경·테스트 실패를 고친 뒤 커밋하는 닫힌 루프입니다. bulk `npm update`로 한꺼번에 올리는 것보다 안전하게, 패키지마다 따로 검증하며 의존성을 최신화합니다. 사용자가 "의존성 하나씩 업그레이드해줘", "패키지 하나씩 올리고 깨진 거 고쳐줘", "오래된 dependency 안전하게 업데이트", "npm outdated 하나씩 정리해줘", "dependency upgrade one by one", "upgrade dependencies one at a time", "bump packages one by one and fix breakages"처럼 의존성을 점진적으로·안전하게 올리고 싶을 때 사용하세요. (구분: 주간 의존성 점검·요약만 하는 건 looping:dependency-audit-weekly, npm audit 보안 취약점을 하나씩 고치는 건 looping:npm-audit-fix-loop, 주간 보안 스캔은 looping:security-audit-weekly, 안 쓰는 의존성·죽은 코드를 제거하는 건 looping:knip-until-clean)

배포 직후 일정 간격(예 15분)마다 health·smoke 엔드포인트를 curl로 찔러보고, 실패하면 배포 로그·환경변수·마이그레이션을 점검해 가장 작은 수정을 적용한 뒤, 설정한 모든 엔드포인트가 성공 응답을 줄 때까지 반복하는 인터벌 루프입니다. 사용자가 "배포 후 헬스체크 돌려줘", "배포 검증 루프", "deploy 끝나고 health/smoke 엔드포인트 다 통과할 때까지 15분마다 체크", "배포하고 나서 헬스 엔드포인트 주기적으로 찔러줘", "배포 잘 떴는지 확인 루프", "deploy verification loop", "hit health and smoke endpoints after a deploy", "verify deploy until healthy", "post-deploy health check loop"처럼 배포가 정상인지 주기적으로 검증하고 싶을 때 사용하세요. (구분: 배포 후 한 번 수동으로 고정 스모크 체크리스트를 도는 건 looping:staging-smoke-test, 원격 CI 실행을 주기적으로 감시하는 건 looping:ci-failure-watcher, DB 마이그레이션을 깨끗이 적용시키는 건 looping:migration-until-applied, 열린 PR을 주기적으로 돌보는 건 looping:pr-babysitter)

코드를 바꾼 뒤 그 변경에 영향받은 문서를 찾아 README·API 레퍼런스·인라인 주석을 코드와 일치하게 맞추는 닫힌 루프입니다. 사용자가 "코드 바꿨으니 문서도 맞춰줘", "README랑 주석 코드에 맞게 업데이트", "변경된 부분 문서 동기화", "이번 diff에 맞춰 docs 갱신", "API 레퍼런스 최신화", "sync docs after edits", "update README to match the code", "docs sync after edits"처럼 코드 변경 이후 뒤처진 문서를 코드에 다시 맞추고 싶을 때 사용하세요. (구분: 출시 후 CHANGELOG 항목 채우기는 looping:changelog-sync-after-ship, API 응답이 OpenAPI/JSON Schema 계약과 맞는지 검증은 looping:api-contract-until-match, openapi.yaml 스펙 자체를 라우트와 동기화는 looping:openapi-sync-until-valid, 구현 후 코드 정리 패스는 looping:de-sloppify-pass)

E2E(엔드투엔드) 테스트 스위트를 실행해 UI·통합 단계 실패를 고치고, 모든 spec이 통과(종료 코드 0)할 때까지 자동으로 반복하는 닫힌 루프입니다. 사용자가 "E2E 통과할 때까지 돌려줘", "엔드투엔드 테스트 green 만들어줘", "E2E 깨진 거 다 고쳐줘", "Playwright/Cypress E2E 통과시켜줘", "UI랑 통합 테스트 실패 고쳐줘", "e2e until green", "run end-to-end tests until they pass", "fix e2e failures and loop until the suite passes"처럼 요청하거나, 깨진 E2E 시나리오를 반복적으로 고쳐 전부 통과시키고 싶을 때 사용하세요. (구분: 유닛·전체 테스트 스위트는 looping:test-until-green, Playwright/Percy 스크린샷 픽셀 비교는 looping:visual-regression-until-match, 프로덕션 빌드 컴파일 에러는 looping:build-until-green, 배포 후 스테이징 스모크 점검은 looping:staging-smoke-test)

이 브랜치의 가장 최근 실패한 CI 실행을 gh로 가져와 로그를 읽고, 로컬에서 똑같이 재현한 뒤 근본 원인을 최소 diff로 고치고 push해서, 체크가 다시 green이 될 때까지 반복하는 닫힌 루프입니다. 사용자가 "CI 빨간불 고쳐줘", "CI 통과할 때까지 고쳐줘", "깨진 CI 초록불 만들어줘", "CI 실패 원인 찾아서 고쳐줘", "GitHub Actions 실패 고쳐", "fix CI until green", "fix the failing CI", "make CI pass", "get the build green"처럼 원격 CI가 빨갛게 떠 있어 그걸 직접 고쳐 통과시키고 싶을 때 사용하세요. (구분: 주기적으로 CI를 폴링하며 감시·자동 수정하는 건 looping:ci-failure-watcher, 구현부터 PR을 열고 머지 가능 상태까지 끌고 가는 건 looping:ship-pr-until-green, 원격이 아니라 로컬 테스트 스위트를 green까지 돌리는 건 looping:test-until-green, 프로덕션 빌드 컴파일 에러를 고치는 건 looping:build-until-green)

실패하는 테스트를 여러 번 반복 실행해 각 실패를 불안정(flaky)인지 진짜 회귀(real)인지 분류하고, 확인된 진짜 회귀만 고치는 닫힌 루프입니다. 사용자가 "이 테스트 flaky인지 진짜 깨진 건지 가려줘", "간헐적으로 깨지는 테스트 분류해줘", "테스트 여러 번 돌려서 불안정한 거 골라줘", "flaky 테스트 트리아지", "flaky test triage", "classify flaky vs real failures", "run failing tests repeatedly and fix only real regressions"처럼 간헐 실패와 진짜 실패를 구분하고 싶을 때 사용하세요. (구분: 전체 스위트를 무조건 green까지 고치는 건 looping:test-until-green, 버그 하나를 재현 스크립트로 파고드는 건 looping:investigation-script-loop, 실패할 때마다 회고 메모를 남기며 재시도하는 건 looping:reflexion-debug-loop, 원격 CI 실패 감시는 looping:ci-failure-watcher)

프로젝트 포맷터(prettier, biome 등)를 돌리고, 포맷터가 자동으로 못 고친 스타일 문제를 손보고, 코드베이스가 diff 하나 없이 깨끗하게 포맷될 때까지 반복하는 수동 루프입니다. 사용자가 "포맷 깔끔하게 정리해줘", "prettier 돌려서 diff 없을 때까지", "포맷팅 통일해줘", "코드 스타일 다 맞춰줘", "포맷 깨끗해질 때까지 돌려줘", "format until clean", "run prettier/biome until clean", "fix formatting until no diff"처럼 포맷을 끝까지 깨끗하게 맞추고 싶을 때 사용하세요. (구분: 린트·타입 에러까지 잡는 건 looping:lint-typecheck-fix, 네이밍·죽은 코드·디버그 잔재 정리는 looping:de-sloppify-pass, 미사용 export·고아 파일 제거는 looping:knip-until-clean, 접근성 검사 클린업은 looping:a11y-audit-until-clean)

같은 체크가 같은 방식으로 두 번 실패하면 그 실패를 `.ralph/guardrails.md`에 '가드레일 사인'으로 적어 두고, 다음 반복부터는 똑같은 실수를 되풀이하지 않게 만드는 학습형 자동화 루프입니다. 매 반복마다 가드레일을 먼저 읽고 → 체크(`npm test && npm run lint`)를 돌리고 → 실패가 반복되면 사인을 추가하고 → 그 사인을 지키며 고칩니다. 사용자가 "같은 실패 반복하지 말고 기록하면서 고쳐줘", "가드레일에 적어가며 학습하는 루프", "실패 패턴 메모하고 피해가게", "두 번 깨진 건 다시 안 깨지게", "guardrails learning loop", "append a guardrail sign", "learn from repeated failures and stop repeating them"처럼 요청하거나, 반복되는 실패를 디스크에 남겨 다음 회차가 피하도록 하고 싶을 때 사용하세요. (구분: 디버깅 회고를 디스크에 적어 같은 오답을 피하는 건 looping:reflexion-debug-loop, prd.json 스토리를 .ralph 상태로 하나씩 실행하는 건 looping:ralph-story-executor, 그냥 테스트만 green까지 돌리는 건 looping:test-until-green, lint+typecheck만 정리하는 건 looping:lint-typecheck-fix)

구현이 "다 됐다"고 선언했을 때, 구현자의 근거나 변명에는 접근하지 않은 별도의 검증 패스가 빌드·린트·테스트를 직접 다시 돌려 정말 통과하는지 확인하고, 실패가 없을 때까지 반복하는 닫힌 루프입니다. 사용자가 "구현 끝났다는데 진짜 통과하는지 독립적으로 검증해줘", "구현자 말 믿지 말고 빌드·린트·테스트 다시 돌려서 확인", "독립 검증 패스 돌려줘", "머지 전 최종 게이트로 검증만 따로", "independent verifier pass", "verify the implementation independently", "run build lint tests as a separate verifier"처럼 구현 주장과 별개로 명령 출력만 신뢰해 검증하고 싶을 때 사용하세요. (구분: 테스트만 green까지 돌리는 건 looping:test-until-green, 프로덕션 빌드만 고치는 건 looping:build-until-green, 린트·타입체크만 고치는 건 looping:lint-typecheck-fix, 자기 diff를 리뷰어처럼 점검하는 건 looping:pr-self-review)

버그를 재현하는 작은 일회용(throwaway) 스크립트를 직접 짜서 실행하고, 출력을 읽고, 근본 원인이 증명될 때까지 스크립트와 가설을 다듬는 디버깅 루프입니다. 사용자가 "버그 원인 끝까지 파줘", "재현 스크립트 짜서 원인 찾아줘", "왜 이러는지 스크립트로 증명해줘", "추측 말고 출력으로 확인해줘", "throwaway repro로 디버깅", "investigation script loop", "write a repro script to find the root cause", "prove the root cause with a probe script"처럼 추측 대신 실제 출력으로 근본 원인을 규명하고 싶을 때 사용하세요. (구분: 실패한 재현마다 디스크에 reflection을 남겨 같은 오답을 피하는 건 looping:reflexion-debug-loop, 테스트를 전부 통과(green)시키는 건 looping:test-until-green, 간헐 실패를 flaky/real로 분류하는 건 looping:flaky-test-triage, CI 실패를 로컬에서 재현해 고치는 건 looping:fix-ci-until-green)

knip을 돌려 죽은 export, 안 쓰는 파일, 고아(orphan) 의존성을 찾아 제거하고, knip이 깨끗(종료 코드 0)하다고 할 때까지 자동으로 반복하는 닫힌 루프입니다. 사용자가 "안 쓰는 코드 다 지워줘", "데드 코드 정리해줘", "쓰지 않는 export·파일·의존성 제거", "knip 깨끗해질 때까지 돌려줘", "사용 안 하는 deps 털어줘", "knip until clean", "remove dead exports and unused files", "find orphan dependencies"처럼 knip(또는 depcheck) 기반으로 미사용 코드·의존성을 반복 제거해 깨끗하게 만들고 싶을 때 사용하세요. (구분: 일반적인 구현 후 청소(디버그 코드·죽은 분기 제거)는 looping:de-sloppify-pass, 린트·타입체크 위반 정리는 looping:lint-typecheck-fix, 패키지를 한 번에 하나씩 업그레이드하는 건 looping:dependency-upgrade-one-by-one, 보안 취약점 의존성 패치는 looping:npm-audit-fix-loop)

lint와 typecheck를 실행해 보고된 경고·에러를 최소 변경으로 고치고, 두 명령이 모두 깨끗해질(종료 코드 0) 때까지 자동으로 반복하는 닫힌 루프입니다. 사용자가 "린트 에러 다 고쳐줘", "타입 에러 깨끗해질 때까지 돌려줘", "lint랑 typecheck 통과시켜줘", "eslint 경고 정리하고 tsc 통과", "타입체크 클린하게", "lint and typecheck fix", "fix all lint and type errors", "run lint and tsc until clean"처럼 정적 검사(lint/typecheck)를 통과시키고 싶을 때 사용하세요. (구분: 프로덕션 빌드/컴파일 에러는 looping:build-until-green, 포매터 스타일 정리는 looping:format-until-clean, 테스트 스위트 통과는 looping:test-until-green, 죽은 export·미사용 파일 제거는 looping:knip-until-clean)

타깃 브랜치(보통 main)를 rebase 또는 merge 하고, 머지 충돌을 파일 하나씩 양쪽 의도를 살려 해결한 뒤, 브랜치가 최신이 되고 테스트가 통과(종료 코드 0)할 때까지 반복하는 수동 시작 루프입니다. 사용자가 "이 브랜치 main 위로 rebase 하고 충돌 다 풀어줘", "머지 충돌 해결해줘", "conflict 난 거 하나씩 정리하고 테스트까지 통과시켜줘", "브랜치 최신화하고 충돌 풀어줘", "merge conflict resolver", "rebase on main and resolve conflicts", "resolve merge conflicts until tests pass"처럼 충돌이 난 브랜치를 최신화하면서 conflict를 끝까지 풀고 싶을 때 사용하세요. (구분: 머지/rebase 직후 스모크 회귀 감시는 looping:post-merge-regression-guard, 단일 PR을 만들어 CI green·머지 가능까지 끌고 가는 건 looping:ship-pr-until-green, rebase 없이 깨진 테스트만 통과시키는 건 looping:test-until-green, 여러 PR을 주기적으로 rebase·관리하는 건 looping:pr-babysitter)

데이터베이스 마이그레이션을 적용하고, 실패하면 스키마나 SQL을 고쳐서, dev 환경에서 마이그레이션이 깔끔하게 적용될 때까지 자동으로 반복하는 닫힌 루프입니다. 사용자가 "마이그레이션 적용될 때까지 돌려줘", "DB 마이그레이션 통과할 때까지 고쳐줘", "prisma migrate 에러 고쳐줘", "스키마 에러 고치고 마이그레이션 깔끔하게 적용해줘", "migrate dev 실패하는 거 고쳐줘", "run database migrations until they apply cleanly", "migration until applied", "fix migration errors and retry"처럼 마이그레이션을 끝까지 적용하고 싶을 때 사용하세요. (구분: API 응답이 스키마 계약과 맞는지는 looping:api-contract-until-match, openapi.yaml 동기화는 looping:openapi-sync-until-valid, 패키지 업그레이드는 looping:dependency-upgrade-one-by-one, 빌드 컴파일 에러는 looping:build-until-green)

high/critical npm audit 취약점을 한 번에 하나씩, 매번 테스트로 검증하며 고치는 닫힌 루프입니다. 무지성 `npm audit fix --force`로 한꺼번에 밀어붙이지 않습니다. 사용자가 "npm audit 취약점 고쳐줘", "high/critical 취약점 하나씩 안전하게 패치", "audit fix 테스트 확인하면서 돌려줘", "보안 취약점 다 잡아줘", "npm audit fix loop", "fix npm audit high/critical with test verification"처럼 npm 의존성 취약점을 안전하게 0건으로 만들고 싶을 때 사용하세요. (구분: 주간 npm audit 스캔·심각도별 트리아지는 looping:security-audit-weekly, 취약점이 아니라 outdated 패키지를 하나씩 올리는 건 looping:dependency-upgrade-one-by-one, 주간 outdated 의존성 점검·요약은 looping:dependency-audit-weekly)

openapi.yaml을 redocly·spectral·swagger-cli로 lint하고, 문서에 적힌 path·schema·status code가 실제 라우트 핸들러와 어긋난 부분(drift)을 매 회차마다 고쳐 lint가 0 에러로 통과할 때까지 자동 반복하는 닫힌 루프입니다. 사용자가 "openapi.yaml lint 통과할 때까지 고쳐줘", "OpenAPI 스펙 핸들러랑 동기화해줘", "스펙이랑 라우트 안 맞는 거 맞춰줘", "OpenAPI drift 고쳐줘", "API 명세 깨끗해질 때까지 돌려줘", "keep openapi.yaml valid and in sync", "lint the spec and fix drift", "sync openapi until valid"처럼 OpenAPI 명세를 검증하고 구현과 맞추고 싶을 때 사용하세요. (구분: 런타임 API 응답이 계약과 일치하는지 테스트로 검증하는 건 looping:api-contract-until-match, 코드 자체의 lint·타입체크는 looping:lint-typecheck-fix, 코드 변경 후 README·문서를 맞추는 건 looping:docs-sync-after-edits)

파일을 편집할 때마다 그 파일과 연관된 테스트만 자동으로 돌려서 회귀(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)

git merge나 rebase가 끝나는 순간 스모크 테스트를 자동으로 돌려, 브랜치를 합치면서 생긴 통합 회귀(integration regression)를 새 작업으로 넘어가기 전에 즉시 잡아내는 훅(hook) 기반 루프입니다. 사용자가 "머지하고 나면 스모크 테스트 자동으로 돌려줘", "rebase 직후 회귀 검사", "브랜치 합친 다음 깨진 데 없는지 바로 확인", "머지 후 통합 회귀 가드", "post-merge regression guard", "run smoke tests after every merge", "catch integration regressions after rebase"처럼 머지·rebase 직후 회귀 가드를 걸고 싶을 때 사용하세요. 이벤트 기반이라 Claude Code에서는 hooks 설정이 필요합니다. (구분: 파일 편집 직후 연관 테스트는 looping:post-edit-test-guard, 커밋 직전 차단은 looping:pre-commit-guard, 머지 중 충돌을 파일별로 푸는 건 looping:merge-conflict-resolver, 배포된 스테이징에 스모크를 돌리는 건 looping:staging-smoke-test)

일정 간격(예 15분)마다 watch 라벨이 붙은 열린 PR들을 점검해서 — 리뷰어를 넛지하고, CI를 고치고, main보다 뒤처졌으면 rebase 하는 인터벌 루프입니다. 사용자가 "열린 PR들 주기적으로 돌봐줘", "PR babysitter", "PR 상태 15분마다 체크해서 CI 고치고 rebase 해줘", "watch 라벨 PR 관리", "babysit my PRs", "keep PRs green on a schedule"처럼 여러 PR을 주기적으로 건강하게 유지하고 싶을 때 사용하세요. (구분: 단일 PR을 머지 가능 상태까지 끌고 가는 건 looping:ship-pr-until-green, 원격 CI 한 건만 감시하는 건 looping:ci-failure-watcher, 머지된 PR 알림 감시는 looping:pr-watch-loop)

PR을 열기 전에 자신이 작성한 diff를 시니어 리뷰어의 눈으로 직접 리뷰하고 — 버그·엣지케이스·네이밍·누락된 테스트를 찾아 고치고 — 같은 작업을 3회 반복하는 수동 루프입니다. 사용자가 "PR 올리기 전에 내 diff 셀프 리뷰해줘", "PR 열기 전 자체 리뷰 세 번 돌려줘", "내가 짠 코드 시니어처럼 리뷰하고 고쳐줘", "diff 셀프 리뷰", "self-review my diff before the PR", "PR self-review", "review my own diff like a senior"처럼 PR 제출 직전에 스스로 코드 리뷰를 돌리고 싶을 때 사용하세요. (구분: 구현 후 디버그 코드·데드코드·네이밍 정리 패스는 looping:de-sloppify-pass, 별도 검증자가 build·lint·test를 독립 실행하는 건 looping:independent-verifier-pass, 실제로 PR을 열고 CI를 green까지 끌고 가는 건 looping:ship-pr-until-green, 이미 떠 있는 여러 PR을 주기적으로 돌보는 건 looping:pr-babysitter)

codex-watch 라벨이 붙은 열린 PR들을 15분마다 폴링해서 — CI 상태·리뷰 진행·마지막 활동을 요약하고, 회귀(regression)나 멈춘 스레드(stale thread)를 표시하고, watch 대상 PR마다 한 줄 상태 리포트를 남기는 인터벌 감시 루프입니다. 사용자가 "열린 PR들 15분마다 감시해줘", "PR 활동 폴링해서 회귀/멈춘 스레드 표시해줘", "watch 라벨 PR 상태 리포트 돌려줘", "PR 워치 루프", "PR watch loop", "poll watched PRs", "flag stale PR threads", "watch open PRs for regressions"처럼 여러 PR의 상태 변화를 주기적으로 지켜보고 리포트하고 싶을 때 사용하세요. (구분: 리뷰어 넛지·CI 수정·rebase까지 적극적으로 돌보는 건 looping:pr-babysitter, 원격 CI 한 건을 green까지 감시·수정하는 건 looping:ci-failure-watcher, 단일 PR을 머지 가능 상태까지 끌고 가는 건 looping:ship-pr-until-green, 내 diff를 시니어처럼 셀프 리뷰하는 건 looping:pr-self-review)

git commit 명령이 실행되려는 순간을 가로채, 커밋 전에 전체 테스트 스위트를 돌리고 실패하면(스위트가 빨가면) 커밋을 막아 깨진 코드가 히스토리에 들어가지 못하게 하는 훅(hook) 기반 루프입니다. 사용자가 "커밋 전에 테스트 돌려서 실패하면 막아줘", "깨진 채로 커밋 못 하게", "커밋 전 가드 걸어줘", "pre-commit 훅으로 테스트 강제", "pre-commit guard", "block commits when tests fail", "run tests before git commit"처럼 커밋 직전 차단 가드를 걸고 싶을 때 사용하세요. 이벤트 기반이라 Claude Code에서는 hooks 설정이 필요합니다. (구분: 편집할 때마다 연관 테스트는 looping:post-edit-test-guard, 머지·리베이스 직후 스모크는 looping:post-merge-regression-guard, 전체 스위트를 수동으로 green까지 돌리는 건 looping:test-until-green)

prd.json에 적힌 사용자 스토리를 한 번에 딱 하나씩, "매번 새 컨텍스트(fresh-context)"로 골라 구현하고 → test·lint·build 백프레셔(backpressure) 검사를 돌리고 → 커밋하고 → progress.md에 배운 점을 기록한 뒤 다음 스토리로 넘어가는 자동화 루프입니다. 모든 스토리가 passes: true가 될 때까지 반복합니다. 사용자가 "랠프 루프 돌려줘", "prd.json 스토리 하나씩 다 구현해줘", "백로그 스토리 자동으로 끝까지 처리해줘", ".ralph 스토리 실행", "Ralph Story Executor", "run the ralph loop", "implement the prd stories one by one", "execute the backlog until every story passes"처럼 .ralph/ 스캐폴딩에 쌓인 스토리를 무인으로 하나씩 완주시키고 싶을 때 사용하세요. (구분: 체크리스트형 spec.md 요구사항을 하나씩 구현하는 건 looping:spec-first-ship, 실패가 같은 식으로 두 번 반복되면 .ralph/guardrails.md에 사인을 남기는 건 looping:guardrails-learning-loop, 테스트부터 쓰는 TDD 반복은 looping:autoloop-tdd, 브랜치에서 구현→푸시→PR까지 끌고 가는 건 looping:ship-pr-until-green)

디버깅이 같은 잘못된 수정을 빙빙 도는 걸 막아주는 디버깅 루프입니다. 재현(repro)에 실패할 때마다 무엇을 시도했고 왜 실패했는지, 다음엔 뭘 피할지 한 줄 회고를 `.loops/reflexion.md`에 적어 두고, 그 기억을 읽은 뒤 이전과 다른 표적 수정을 시도해 이전에 실패하던 테스트가 통과(종료 코드 0)할 때까지 반복합니다. 사용자가 "이 버그 계속 못 고치겠어 회고 남기면서 디버그해줘", "같은 수정 반복하지 말고 기록하면서 고쳐줘", "리플렉션 디버그", "회고 기반 디버깅 루프", "reflexion debug loop", "debug with reflection memory", "stop repeating the same failed fix"처럼 요청하거나, 디버깅이 제자리걸음일 때 사용하세요. (구분: 버려도 되는 재현 스크립트를 짜서 근본 원인을 증명하는 건 looping:investigation-script-loop, 같은 실패가 두 번 나면 가드레일을 .ralph/guardrails.md에 적는 건 looping:guardrails-learning-loop, 전체 테스트 스위트를 그냥 green까지 돌리는 건 looping:test-until-green, 불안정·간헐 실패를 분류하는 건 looping:flaky-test-triage)

매주 npm audit로 의존성 취약점을 스캔하고, 심각도(critical/high/moderate)별로 트리아지한 뒤, 안전한 패치를 제안하거나 적용하고, 우선순위가 매겨진 수정안이 담긴 주간 요약 리포트를 내놓는 인터벌 루프입니다. 사용자가 "주간 보안 감사 돌려줘", "매주 npm audit 자동으로 돌려줘", "취약점 정기 점검", "보안 취약점 주간 리포트 만들어줘", "7일마다 보안 스캔", "Security Audit Weekly", "run npm audit weekly", "weekly security scan", "triage vulnerabilities by severity"처럼 보안 취약점을 정기적으로 점검·정리하고 싶을 때 사용하세요. (구분: 오래된(outdated) 의존성을 주간으로 점검·업그레이드 제안하는 건 looping:dependency-audit-weekly, high/critical 취약점을 테스트 검증하며 하나씩 실제로 고치는 건 looping:npm-audit-fix-loop, 패키지를 한 번에 하나씩 올리며 깨짐을 고치는 건 looping:dependency-upgrade-one-by-one)

브랜치에서 변경을 구현하고 → 로컬 테스트 → 커밋·push → PR 열기 → CI 대기 순으로, 모든 체크가 통과해 PR이 머지 가능해질 때까지 자동으로 반복하는 닫힌 루프입니다. 사용자가 "PR 초록불 될 때까지 밀어줘", "구현하고 PR까지 올려서 CI green 만들어줘", "이 변경 PR 머지 가능하게 끝까지 가줘", "PR 열고 CI 통과시킬 때까지 반복", "ship this PR until green", "open a PR and fix CI until it passes", "implement, push, and get the PR merge-ready"처럼 하나의 변경을 PR 머지 직전까지 완주시키고 싶을 때 사용하세요. (구분: 이미 실패한 CI 한 건만 고치는 건 looping:fix-ci-until-green, 원격 CI를 주기적으로 폴링·감시하는 건 looping:ci-failure-watcher, 여러 PR을 정해진 간격마다 돌보는 건 looping:pr-babysitter, PR 열기 전 자체 리뷰만 도는 건 looping:pr-self-review)

spec.md에 적어 둔 요구사항 체크리스트를 따라, 매 반복마다 미체크 항목 하나를 검증까지 끝내고 [x]로 마킹하는 기획(Planning) 루프입니다. 사용자가 "spec.md 체크리스트대로 하나씩 구현해줘", "명세 따라 요구사항 하나씩 검증하면서 ship", "스펙 먼저 적고 그 순서대로 만들어줘", "체크리스트 다 체크될 때까지 구현", "spec-first ship", "implement from spec.md one requirement at a time", "spec-driven implementation loop"처럼 미리 적어 둔 명세/체크리스트를 기준으로 한 항목씩 완성해 나가고 싶을 때 사용하세요. (구분: prd.json 스토리를 fresh-context로 하나씩 구현·커밋하는 건 looping:ralph-story-executor, 실패 테스트 먼저 쓰고 최소 구현하는 TDD 루프는 looping:autoloop-tdd, 브랜치에서 구현해 PR 올리고 CI green까지 가는 건 looping:ship-pr-until-green, 명세 없이 깨진 테스트만 전부 통과시키는 건 looping:test-until-green)

배포 직후 스테이징 환경에 고정된 스모크 체크리스트(로그인/인증, 핵심 플로우, 웹훅, 에러 버짓)를 돌려서, 실패하면 가장 작은 문제부터 고치고 전부 통과(종료 코드 0)할 때까지 반복하는 닫힌 루프입니다. 사용자가 "스테이징 스모크 테스트 돌려줘", "배포 후 스모크 체크리스트 확인해줘", "staging에서 로그인/핵심 플로우/웹훅 점검해줘", "스모크 통과할 때까지 고쳐줘", "run staging smoke checklist", "post-deploy smoke check", "Staging Smoke Test"처럼 스테이징 배포 검증을 요청할 때 사용하세요. (구분: 배포 후 health·smoke 엔드포인트를 일정 간격으로 핑하는 건 looping:deploy-verification-loop, 머지·리베이스 직후 자동 스모크는 looping:post-merge-regression-guard, E2E 스위트 전체를 green까지 돌리는 건 looping:e2e-until-green, 로컬 유닛 테스트 통과는 looping:test-until-green)

테스트 스위트를 실행해 실패가 나오면 가장 작은 근본 원인을 고치고, 모든 테스트가 통과(종료 코드 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)

UI 변경에 Playwright나 Percy 비주얼 스냅샷을 돌려서, 의도치 않은 시각적 diff는 고치고 의도된 변경만 베이스라인에 반영해 스냅샷이 깔끔히 일치(종료 코드 0)할 때까지 자동으로 반복하는 닫힌 루프입니다. 사용자가 "비주얼 회귀 테스트 돌려줘", "UI 바뀐 거 스크린샷 diff 잡아줘", "Playwright 비주얼 스냅샷 맞을 때까지", "의도 안 한 시각 변화 고쳐줘", "Percy/Chromatic 베이스라인 일치시켜줘", "visual regression until match", "run visual snapshot tests", "fix unintended visual diffs until baselines match"처럼 요청하거나, 디자인 변경 후 픽셀 단위 회귀를 반복적으로 고쳐 베이스라인에 수렴시키고 싶을 때 사용하세요. (구분: 전체 E2E 사용자 흐름 검증은 looping:e2e-until-green, 접근성 위반 점검은 looping:a11y-audit-until-clean, 일반 단위·통합 테스트 스위트를 green까지는 looping:test-until-green)