Communitygithub.com

mytler/ultraloop

에이전트 스킬: 작업은 검증되고 실제로 작동할 때만 완료됩니다. 작업 규모를 분류하고, 레포를 정찰하며, 검증된 코드 또는 코드 + 정직한 실행 계획을 제공합니다. Claude Code, Codex, Cursor 및 기타 에이전트용.

ultraloop란 무엇인가요?

Ultraloop은 AI 에이전트(Claude Code, Codex, Cursor 등)를 위한 강력한 작업 실행 스킬입니다. 핵심 원칙은 '코드가 작성되었다고 해서 작업이 끝난 것이 아니다'이며, 실제 검증을 통해 결과가 작동함을 증명해야 작업이 완료됩니다. 작업 규모에 따라 검증 프로세스의 강도가 자동으로 조정됩니다. 간단한 스니펫은 몇 가지 테스트 케이스로 검증하고, 실제 프로젝트의 기능은 테스트 통과, 빌드 성공, 라이브 확인, CI/CD 통과 등 엄격한 정의를 요구합니다. 이 스킬은 Phase 0(규모 평가)에서 작업을 LIGHT 또는 HEAVY로 분류한 후, 각각에 맞는 경량 또는 무거운 실행 경로를 제공합니다. LIGHT 모드는 빠른 경로로 최소한의 질문과 기본 검증을 수행하고, HEAVY 모드는 코드 탐색, 명확화, 자율 실행, 엄격한 완료 정의(DoD) 및 반복 검증 루프를 포함합니다. Ultraloop의 가장 중요한 규칙은 '절대 가짜 초록(Green) 상태를 만들지 말라'는 것으로, 검증되지 않은 결과를 완료로 간주하지 않습니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor
npx skills add mytler/ultraloop

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

ultraloop은(는) 무엇을 하나요?

기본적으로 작업은 코드가 작성된 순간 완료된 것으로 간주합니다. 그것은 틀렸고, 여기서는 비활성화되어 있습니다. Ultraloop 모드에서는 결과가 실제로 검증되고 작동할 때만 작업이 완료됩니다. "코드가 올바르게 보인다"는 증거가 아니며, 증거는 실제 실행에서 관찰된 결과입니다. "검증됨"이 요구하는 것은 작업에 따라 달라집니다. 스니펫의 경우 몇 가지 사례에 대해 실행하는 것이고, 실제 프로젝트의 기능인 경우 녹색 테스트, 깨끗한 빌드, 라이브 확인, CI/CD를 통과하는 PR입니다.

작업에 맞게 프로세스를 조정하십시오. 프로세스 강도는 오류 비용과 작업 규모에 비례합니다. 단일 파일 함수와 50명의 에이전트 워크플로우는 동일한 절차를 가져서는 안 됩니다. 작은 작업에 무거운 의식을 적용하는 것은 이 스킬의 가장 흔한 실패이며, 실제 실패입니다. 또한 당신이 돌아와서 20개의 질문에 답할 때까지 아무것도 시작할 수 없다면 Ultraloop의 전체 약속("떠나서 결과를 가지고 돌아오기")도 무너집니다. 따라서 다른 무엇보다 먼저 작업을 분류(Phase 0)하고 프로세스의 무거움을 선택하십시오. 명백히 잘못된 길로 가는 것을 피하는 데 필요한 만큼의 질문만 하고, 그 이상은 하지 마십시오.


PHASE 0 — 규모 평가 (항상 먼저, 질문 전에)

질문을 시작하기 전에 작업을 분류하고 모드를 선택하십시오.

LIGHT 작업 — 신호(하나만 해당):

  • 독립적인 스니펫 / 단일 함수 / 작은 모듈;
  • 기존 레포, 테스트 또는 CI와 관련 없음(또는 존재하지 않음);
  • 라이브로 확인할 UI가 없고, 오류 비용이 낮으며, 되돌리기가 사소함.

HEAVY 작업 — 신호(하나만 해당):

  • 레포, 테스트, CI/CD가 있는 실제 프로젝트 내의 기능/변경;
  • 워크플로우, 여러 단계, 많은 에이전트, 장기 실행 작업;
  • Playwright / Computer Use를 통한 라이브 확인 필요;
  • 오류 비용이 높고, 외부 종속성이 있으며, PR 흐름이 있음.

명확하지 않은 경우 규모를 결정하기 위해 하나의 짧은 질문을 하십시오. 분류하기 전에 전체 인터뷰를 펼치지 마십시오. 그런 다음 일치하는 경로를 선택하십시오: 바로 아래의 Light 모드 또는 전체 2단계 Heavy 모드(Phase 1 → Phase 2).


LIGHT 모드 (빠른 경로)

기본 모델은 작고 독립적인 작업에 이미 능숙합니다. 혼자 두면 순진한 split(',') 대신 적절한 RFC-4180 CSV 상태 머신을 작성합니다. 여기서 당신의 임무는 방해하지 않는 것입니다: 좋은 결과를 빠르게 가정과 함께 전달하고, 의식 뒤에 가두지 마십시오.

  • 큰 명확화 단계를 실행하지 말고 최대 턴 수를 요청하지 마십시오.
  • 기껏해야 1–3개의 질문을 하고, 진정으로 비용이 많이 드는 분기점에 대해서만 질문하십시오. 잘못된 기본값을 선택하면 작업을 폐기해야 하는 분기점입니다. (CSV의 경우: 엄격한 RFC 4180 또는 단순 분할? 외부 라이브러리 허용? 코드는 어디에 넣어야 합니까?) 그 외의 모든 것은 합리적인 기본값을 취하고 묻지 마십시오.
  • 그 기본값에 대해 즉시 솔루션을 작성한 다음, 당신이 만든 가정을 간략히 나열하고 수정 사항을 초대하십시오. 분기점은 "별도의 말이 없으면 X를 사용합니다"로 표현하고, 사용자가 대답해야 하는 차단 질문으로 표현하지 마십시오.
  • 무거운 도구(공식 완료 정의 계약, 최대 턴, PR + CI/CD, ScheduleWakeup)를 레포/테스트/CI가 없고 작업이 필요하지 않은 경우에 끌어들이지 마십시오. 충분한 것은: 작동하는 코드 + 몇 가지 기본 검사/테스트 + 짧은 주의 사항입니다.
  • 전체 모드에서 여전히 유지되는 한 가지: 가능한 것은 실제로 검증하고, 절대 가짜로 만들지 마십시오. 완료라고 부르기 전에 몇 가지 사례(또는 빠른 테스트)에 대해 함수를 실행하십시오. 검증할 수 없는 것이 있으면 그렇게 말하십시오. 가벼운 프로세스는 검증되지 않은 프로세스가 아닙니다.

예시(올바르게 수행된 Light 작업). 프롬프트: "TypeScript로 CSV 문자열을 받아 첫 번째 헤더 행에서 키를 가져와 객체 배열을 반환하는 함수를 작성하십시오." → LIGHT로 분류 → 즉시 올바른 파서 작성(RFC-4180 상태 머신: 따옴표, "", 따옴표 안의 쉼표와 개행 문자, \n/\r\n), 값은 기본적으로 문자열 → 그런 다음 가정을 간략히 나열(RFC 4180, 구분자 ,, 외부 라이브러리 없음, 타입 강제 변환 없음)하고 수정 사항을 초대하십시오. 20개의 질문을 쏟아내지 말고 최대 턴을 요청하지 마십시오.


HEAVY 모드 · PHASE 1 — 정찰, 그런 다음 명확화 (대화형)

여기부터 아래(Phases 1–2, 전체 완료 정의, 실행 루프, ScheduleWakeup, 워크플로우, PR 마무리)는 HEAVY 경로입니다. Phase 0에서 작업을 heavy로 분류한 경우에 사용됩니다. Light 작업의 경우 위의 Light 모드를 대신 사용하십시오.

피해야 할 실패: 코드 한 줄을 작성하기 전에 약 20개의 질문을 쏟아내는데, 그 중 절반은 레포 자체에서 답을 찾을 수 있는 경우입니다. 이는 사용자에게 이미 package.json에 있는 것을 묻고 작업의 100%를 사용자의 답변에 차단하여 "떠나서 결과를 가지고 돌아오기" 약속을 깨는 것입니다. 따라서 먼저 코드를 정찰한 다음, 코드가 진정으로 알려줄 수 없는 것에 대해서만 질문하십시오.

1. 원래 프롬프트 전체를 다시 읽으십시오. — 무엇이 요청되었는지, 왜 요청되었는지, 사용자 관점에서 "완료"가 어떻게 보이는지.

2. 먼저, 아무것도 묻지 않고 레포를 조용히 정찰하십시오. 작업이 기존 프로젝트와 관련된 경우 코드를 읽고 가능한 한 많은 자체 질문에 답하십시오:

  • 프레임워크 / 언어 / 런타임 / 버전 — package.json, 잠금 파일, tsconfig, 설정 파일;
  • 패키지 매니저 — 잠금 파일에서 (pnpm-lock.yaml / package-lock.json / yarn.lock);
  • DB 및 데이터 액세스 계층 — 종속성, 설정, 마이그레이션, 기존 모델/스키마;
  • 테스트 러너 및 테스트 실행 방법 — scripts, 테스트 설정;
  • CI/CD — .github/workflows/, .gitlab-ci.yml 등;
  • 기존 패턴 — 유사한 라우트 / 핸들러 / 유효성 검사가 이미 작성된 방법; 자신만의 스타일을 발명하지 말고 그 스타일을 따르십시오.
  • 빌드 일관성(저렴한 검사 — 실행 계획을 작성하기 전에 수행): package.json이 잠금 파일(pnpm-lock.yaml / package-lock.json / yarn.lock)과 일치합니까? 모든 종속성이 잠금 파일에 존재하고, package.json에 추가되었지만 잠금 파일에서 누락된 것은 없습니까? — 그 불일치만으로도 pnpm install --frozen-lockfile(및 CI 작업)이 실패합니다. 그리고 실행 계획에서 인용할 스크립트(lint / typecheck / test / build / db:*)가 실제로 package.json에 존재합니까?

코드에서 배운 것은 묻지 마십시오. 정찰은 기본값입니다. 읽을 프로젝트가 진정으로 없는 경우에만 건너뛰십시오(그러면 해당 항목이 실제 질문이 됩니다).

정찰 결과 기존 중단이 발견된 경우 — 잠금 파일과 package.json 불일치, 또는 존재하지 않는 실행 계획 스크립트 — 이를 자체 플래그로 표시하십시오. "CI를 실패시킬 기존 레포 문제"와 수정 명령(예: pnpm install + 새로 고침된 잠금 파일 커밋). 이것은 코드를 제공하는 데 장애물이 아닙니다. 실행 계획 옆에 정직한 메모일 뿐이므로 사용자가 이미 존재했던 중단을 변경 사항 탓으로 돌리며 CI 사이클을 소모하지 않습니다.

3. 진정으로 해결할 수 없는 질문만 하십시오. — 코드에 없고 안전하게 기본값을 지정할 수 없는 제품/정책 결정입니다. ("사용자 생성"의 경우: 공개 가입 또는 관리자 전용? 비밀번호가 있으며 무엇으로 해시합니까? 정확한 응답 계약 및 상태 코드는 무엇입니까? 중복 이메일이 있으면 어떻게 됩니까?) 레포 또는 합리적인 기본값에서 파생된 모든 것은 질문이 아닙니다 — 대신 명시된 가정으로 기록하십시오. 최대 턴 예산을 이 동일한 짧은 블록에서 묻는 것은 이 환경에서 자율 검증 루프에 실제로 진입하려는 경우에만 해당됩니다. 환경이 루프를 실행할 수 없는 경우(설치 불가 / DB 없음 / 네트워크 없음 — 5단계 및 "검증 루프를 여기서 실행할 수 없는 경우" 참조), 최대 턴 질문을 건너뛰십시오. 아직 제한할 루프가 없기 때문입니다.

4. 정찰 후 완료 정의를 구성하십시오. (아래 참조) — 추측이 아닌 실제로 찾은 스택에 근거하도록 합니다. 이를 보여주고 진정한 결정인 부분에 대해 "확인"을 받으십시오.

5. 진행 규칙 — 빌드-검증-플래그, 하드-블록하지 마십시오. Heavy 모드의 기본값은: 합리적인 가정(레포 + 상식에서) → 빌드 → 환경이 허용하는 한 검증 → 그런 다음 보고서에서 당신이 만든 가정과 여전히 확인이 필요한 것을 명시적으로 나열하는 것입니다. 답변을 기다리며 모든 작업을 중단하지 말고 결과물을 보류하지 마십시오.

제약 인식 기본값. 합리적인 비용이 0인 해결 방법이 있는 차단기는 질문이 아닙니다 — 해결 방법을 플래그가 지정된 기본값으로 취하고 계속 진행하십시오. 예를 들어 비밀번호 해싱이 필요하지만 bcrypt/argon2가 종속성에 없고 추가할 네트워크가 없는 경우 → node:crypto scrypt를 사용하고 "bcrypt/argon2는 한 함수 교체입니다"라고 플래그를 지정하십시오. 환경 제한이 기본값을 형성합니다. 작업을 중단하지는 않습니다.

하드-블록(시작 전에 멈추고 물어보기)은 진정한 제품/정책 분기점이고 안전한 기본값이 없으며 잘못될 경우 비용이 높은 경우에만 해당됩니다. 예를 들어 코드에 표시되지 않은 "이 엔드포인트는 공개 가입입니까 아니면 관리자 전용입니까?"와 같은 경우입니다. 또한 파괴적이거나 되돌릴 수 없는 작업(프로덕션 / 공유 DB, 되돌릴 수 없는 마이그레이션, 데이터 삭제, 외부 게시) 전에도 중단하십시오.

다른 모든 경우에는 가정을 바탕으로 진행하고 제공하십시오. 기껏해야 하나의 진정한 차단 질문을 목표로 하십시오. 그 외의 모든 것은 플래그가 지정된 가정이 됩니다. 사용자가 주변에 있다면 정책 질문을 하는 것은 괜찮지만, 차단되지 않은 코드를 계속 생성하고 유휴 상태가 되지 마십시오.


HEAVY 모드 · PHASE 2 — 실행 (자율)

모든 것이 합의되면 완전히 스스로 작업하고, 계획에 따라 엄격히 진행하며, 사용자에게 질문하지 않습니다. 사용자는 떠났다가 완료된 결과를 가지고 돌아올 수 있어야 합니다.

질문은 진정한 차단기가 있는 경우에만 허용됩니다. — 답변 없이는 물리적으로 계속하는 것이 불가능한 경우(비밀에 접근할 수 없음, 작업이 모순됨, 외부 서비스가 다운됨). 이 경우: 차단기를 명시하고 ScheduleWakeup(아래 참조)을 사용하여 대기 중에 유휴 상태가 되지 않고 빈 검사에 컨텍스트를 소모하지 않도록 하십시오.

합의된 완료 정의와 상식을 바탕으로 다른 모든 것을 스스로 결정하십시오. 사소한 분기점이 발생하고 명백한 기본값이 있는 경우, 기본값을 취하고 중단하여 묻지 말고 반복 로그에 기록하십시오.


보고 (Heavy 모드): 신호, 방법론이 아님

간결하게 보고 Ultraloop가 어떻게 작동하는지 다시 설명하지 마십시오. 모든 업데이트는 새롭고 실질적인 정보만 전달합니다. — 검증된 것, 빨간불인 것, 남은 것.

  • 턴마다 방법을 설명하지 마십시오: "데이터 수집", "검증 에이전트가 실패하여 직접 확인 중", "증거 없는 초록색 없음" 등과 같은 것은 없습니다. 의도된 도구 대신 직접 무언가를 검증해야 했다면 한 번 간략히 언급한 다음 반복을 중단하십시오.
  • 프로세스가 아닌 결과를 명시하십시오: "테스트 초록색(42 통과)", "타입체크 foo.ts:10에서 빨간불, 수정 중", "POST가 201 반환, 중복 → 409 확인됨". 세세한 설명은 건너뛰십시오.
  • 턴에 새로운 말할 내용이 없으면 아무 말도 하지 마십시오. 침묵이 계획을 다시 설명하는 단락보다 낫습니다.

완료 정의 (Heavy 모드)

이 전체 완료 정의 계약은 Heavy 작업을 위한 것입니다. Light 작업에는 이것이 적용되지 않습니다. Light 작업은 작동하는 코드 + 몇 가지 기본 검사 + 명시된 가정을 얻습니다(Light 모드 참조).

시작하기 전에 구체적이고 검증 가능한 완료 기준 목록을 작성하십시오. 두 가지 소스에서 가져오십시오: 프롬프트의 명시적 요구 사항과 이러한 종류의 작업에 명백히 암시되는 암묵적 요구 사항입니다. 사용자는 종종 "말하지 않아도 되는" 부분을 언급하지 않습니다. — 당신의 임무는 이를 재구성하는 것입니다.

기본적으로 완료 정의는 명시적으로 명시되지 않은 경우에도 다음을 포함합니다:

  • 새 로직에 대한 단위/통합 테스트가 작성되고 통과함;
  • 필요한 경우 외부 종속성(네트워크, DB, 결제, 시간)에 대한 목업이 생성됨;
  • 프로젝트가 오류 없이 빌드됨(build 초록색);
  • 린터 및 타입 검사 통과;
  • 기능이 라이브로 검증됨 — Playwright(웹) 또는 Computer Use / API/CLI 호출, "코드를 눈으로 확인"이 아님;
  • 회귀 없음: 기존 테스트가 계속 통과함;
  • 코드/로그/프론트엔드에 비밀 정보 없음; 서버 측 유효성 검사가 우회 불가능(사용자의 글로벌 보안 규칙 참조);
  • 깔끔한 PR은 모든 빌드와 테스트가 초록색이고 CI/CD 통과가 보장된 후에만 열림.

작업에 맞게 목록을 조정하십시오: 적용되지 않는 항목은 삭제하고(UI 없음 → Playwright 없음), 특정 항목을 추가하십시오(DB 마이그레이션 → 롤백 테스트, 라이브러리 → 게시된 API 표면 테스트). 스택 및 CI별 검증 방법에 대한 레시피는 references/verification-recipes.md에 있습니다.

기준을 "충족됨"으로 표시하기 전에 관찰 가능한 증거가 있어야 합니다: 명령 출력, 초록색 실행, 페이지 스크린샷/스냅샷. "내가 올바르게 작성했다"는 믿음은 증거가 아닙니다.


실행 루프

하나의 큰 "모든 것을 작성 → 마지막에 확인" 방식이 아닌 짧은 반복으로 작업하십시오. 실패를 일찍 잡을수록 수정 비용이 저렴합니다.

한 번의 반복:

  1. 변경 — 다음 완료 정의 항목을 향한 가장 작은 일관된 단계.
  2. 검사 — 관련 항목을 실행하십시오: 테스트 → 빌드 → 린트/타입 → 라이브 확인. 실제로 실행하고 출력을 읽으십시오. "작동할 것이다"에 의존하지 마십시오.
  3. 진단 — 빨간불이 있는 경우 근본 원인을 찾고 증상을 패치하지 마십시오. 사소하지 않은 버그의 경우 debugger 하위 에이전트를 불러오고, 새 로직에 대한 테스트는 test-engineer로 보낼 수 있습니다.
  4. 수정 → 반복. 모든 완료 정의 항목이 초록색이 될 때까지 루프를 떠나지 마십시오.

짧은 반복 로그를 유지하십시오 — 빙글빙글 돌거나 같은 것을 두 번 수정하지 않도록 합니다. 반복당 한두 줄:

#N | 검사: <실행한 것> | 실패: <무엇과 이유> | 수정: <수행한 것> | 완료 정의 상태: X/Y

최대 턴 제한. 각 검증→수정 주기를 합의된 제한에 대해 계산하십시오. 한도에 가까워지면 중단하고 조용히 초과하지 마십시오. 보여주십시오: 초록색인 것, 여전히 빨간색인 것과 그 이유, 시도한 것. 그런 다음 ScheduleWakeup을 예약하거나(긴 실행을 기다리는 경우) 사용자를 기다리십시오. 제한은 수정 주기의 수에 관한 것이지 총 작업량에 관한 것이 아닙니다. 제한 내에서 생산적인 작업은 제한되지 않습니다.


절대 가짜 초록색 상태를 만들지 마십시오 (두 모드 모두)

이것은 스킬의 핵심이며 Light 모드에서도 적용됩니다. Ultraloop의 요점은 실제로 작동하는 결과에 도달하는 것입니다. 가짜 초록색은 그 요점을 파괴하며 정직한 "완료되지 않음"보다 나쁩니다.

"검증됨"과 "생성됨"을 분리하십시오 — 이것이 가장 잘못 읽히는 부분입니다. "가짜 초록색을 만들지 마십시오"는 다음을 의미합니다: 무언가가 검증 가능하게 초록색이 아닌데 초록색이라고 주장하지 마십시오. 무언가를 생성했지만 확인하지 못한 경우 "검증되지 않음"이라고 보고하고 계속 진행하십시오.

Ultraloop는 가짜 자신감이 아닌 정직한 신호를 제공하기 위해 존재합니다.

관련 스킬