Loop It

Loop It은(는) 무엇을 하나요?

열린 코딩 목표를 경계가 명확하고 검증 가능한 루프로 전환합니다. Loop It은 루프 라이브러리이기도 합니다: 적절한 시작 루프를 선택하고, 사용자 컨텍스트에 맞게 조정하며, 다음 루프가 명확해지도록 진행 상황을 추적합니다.

결정

먼저 사용자에게 필요한 모드를 결정합니다:

• 라이브러리에서 찾기: 사용자의 목표에 맞는 번들 루프를 선택합니다.
• 진행 상황에서 다음 단계: .loop-it/progress.json 또는 .loop-it/LOOP.md를 검사하고 다음에 반복할 내용을 추천합니다.
• 설계만: 재사용 가능한 루프 프롬프트 또는 프로젝트 로컬 루프 파일을 생성합니다.
• 지금 실행: 한 번에 하나의 경계가 정해진 반복을 실행하고, 검증한 후 다른 반복이 정당한지 결정합니다.
• 내보내기/설치: Codex, Claude Code, Cursor 또는 다른 SKILL.md 호환 에이전트를 위해 동일한 루프를 조정합니다.

작업이 모호한 경우, 광범위한 발견 질문을 하지 마십시오. 먼저 가장 적합한 라이브러리 루프를 추천하고 가정을 명시합니다. 목표, 성공 확인, 저장소 범위 또는 승인 경계가 진정으로 차단되는 경우에만 최대 세 가지의 대상 질문을 합니다.

계약

실행 전에 모든 루프에는 다음 필드가 필요합니다:

• 목표: 주제가 아닌 구체적인 결과물.
• 범위: 저장소, 파일, 기능 영역, 데이터 소스 또는 환경.
• 성공 확인: 명령, 벤치마크, 수동 검사, 검토 기준 또는 측정 가능한 임계값.
• 반복 횟수 제한: 최대 패스 또는 시간 예산.
• 중단 조건: 성공, 의미 있는 개선 없음, 반복 실패, 접근 차단, 안전하지 않은 작업 또는 승인 필요.
• 증거: 각 패스 후 기록할 내용.
• 승인 게이트: 프로덕션 쓰기, 외부 메시지, 결제, 파괴적 git 작업, 자격 증명, 배포 또는 되돌릴 수 없는 데이터 변경.

요청된 루프가 확인 없이 "계속 개선"하는 것일 때는 반대하십시오. 대신 명확한 확인이 있는 더 작은 루프를 제공하십시오.

루프 선택

처음부터 루프를 만드는 것보다 번들 라이브러리를 선호합니다.

가능하면 선택기 스크립트를 사용하십시오:

node <skill-dir>/scripts/select-loop.mjs list
node <skill-dir>/scripts/select-loop.mjs search "failing ci"
node <skill-dir>/scripts/select-loop.mjs recommend --goal "실패한 체크아웃 테스트 수정"
node <skill-dir>/scripts/select-loop.mjs next --cwd <project>

<skill-dir>을 이 스킬의 폴더로 확인합니다. Claude Code에서는 ${CLAUDE_SKILL_DIR}을 사용할 수 있습니다. 다른 에이전트에서는 이 SKILL.md가 포함된 디렉토리를 찾습니다.

선택 시:

1. 사용자가 다음에 반복할 것을 물을 때 먼저 .loop-it/progress.json을 확인합니다.
2. 진행 상황이 없으면 references/library/loops.json에 대해 사용자의 목표를 매칭합니다.
3. 하나의 루프를 추천하고, 최대 두 개의 대안을 추가로 제시합니다.
4. 한 문장으로 매칭을 설명합니다.
5. 필요한 경우에만 루프의 주요 질문을 합니다.
6. 라이브러리 루프가 맞지 않으면 사용자 정의 루프를 설계하고, 유용함이 입증된 후 라이브러리에 추가하는 것을 고려해야 한다고 말합니다.

선택기 스크립트를 사용할 수 없거나 수동 검사가 필요한 경우에만 references/library/loops.json을 읽습니다. 작업에 일반적인 내구성 있는 상태 형식이 필요한 경우 references/loop-template.md를 읽습니다.

현재 라이브러리 카테고리는 다음과 같습니다:

• 티켓에서 검증된 수정으로: 재현, 진단, 패치, 회귀 테스트 추가, 검증.
• 실패한 CI 수리: 실패한 출력 검사, 재현, 패치, 실패한 검사 재실행.
• 문서 정리: 문서를 구현과 비교, 오래된 문서 업데이트, 예제 또는 링크 검증.
• 제품 평가: 시나리오 및 기준 정의, 테스트, 누락된 부분 수정, 영향을 받는 검사 및 전체 검사 재실행.
• 성능 루프: 기준 측정, 하나의 집중된 변경 수행, 재측정, 입증된 개선만 유지.
• 검토 수리 루프: diff 검토, 차단 발견 사항 수정, 검사 재실행, 허용된 위험만 남을 때까지 반복.
• 새 설정 루프: 깨끗한 환경에서 시작, 문서화된 설정 따르기, 숨겨진 가정 수정, 깨끗하게 재시도.
• 릴리스 준비: 게시 전에 패키지, 배포 또는 공개 설치 경로 확인.
• UX 개선, 종속성 업그레이드, 보안 강화, 리팩터링 격리 및 테스트 범위 격차 루프.

루프 초안 작성

루프 프롬프트 및 상태 파일에 다음 구조를 사용하십시오:

1. 목표 및 비목표를 명시합니다.
2. 하나의 타이트한 사이클로 반복 작업을 정의합니다: 검사, 실행, 검증, 기록, 결정.
3. 정확한 검증 명령 또는 수동 검사를 지정합니다.
4. 반복 횟수 제한 및 중단 조건을 정의합니다.
5. 최종 보고서에 포함되어야 하는 내용을 정의합니다.

버전 1을 좁게 유지하십시오: 하나의 저장소, 하나의 주요 역할, 하나의 주요 성공 확인. 수동 루프가 유용함이 입증될 때까지 일정 관리, 대시보드, 다중 에이전트 오케스트레이션 및 프로덕션 자동화를 연기하십시오.

내구성 있는 상태 파일이 유용한 경우, references/loop-template.md에서 .loop-it/LOOP.md를 생성하거나 다음을 실행하십시오:

node <skill-dir>/scripts/create-loop.mjs --name "루프 이름" --objective "구체적인 결과물" --check "검증 명령 또는 기준"
node <skill-dir>/scripts/create-loop.mjs --from failing-ci-repair

라이브러리 기반 루프 파일은 --no-progress가 전달되지 않는 한 .loop-it/progress.json도 생성합니다.

루프 실행

각 반복에 대해:

1. 목표, 성공 확인, 제한 및 승인 게이트를 다시 읽습니다.
2. 다음 경계가 정해진 작업에 필요한 컨텍스트만 검사합니다.
3. 가장 작은 신뢰할 수 있는 변경을 수행합니다.
4. 먼저 가장 좁은 관련 검증을 실행하고, 필요한 경우에만 더 넓은 검사를 실행합니다.
5. 상태 파일이 있으면 .loop-it/LOOP.md에 증거를 기록하고, .loop-it/progress.json이 있으면 업데이트합니다.
6. 결정: 중단, 계속, 승인 요청 또는 차단 보고.

계속하기 위해 안전, 자격 증명, 프로덕션 데이터, 청구, 사용자 메시징, 파괴적 git 작업 또는 배포 승인에 대한 숨겨진 가정이 필요한 경우 즉시 중단하십시오.

소진되었거나, 차단되었거나, 부분적으로 검증된 루프를 완료되었다고 설명하지 마십시오. 어떤 조건이 중단시켰고 어떤 증거가 있는지 정확히 말하십시오.

내보내기

호출 방식만 다르고 동일한 루프 텍스트를 도구 간에 사용하십시오:

• Codex: .agents/skills/loop-it/ 아래에 설치하거나 Codex 플러그인으로 설치한 후 $loop-it로 호출합니다.
• Claude Code: .claude/skills/loop-it/ 아래에 설치한 후 /loop-it로 호출합니다.
• Cursor: .cursor/skills/loop-it/ 아래에 설치한 후 Agent 채팅에서 /loop-it 또는 루프 요청으로 호출합니다. 항상 켜져 있는 프로젝트 규칙에는 Cursor 규칙을 사용하고, 이 절차적 루프에는 사용하지 마십시오.

내보낼 때 하나의 표준 루프 본문을 유지하고, 해당 도구에서 요구하지 않는 한 도구별 구문을 피하십시오.