SUPERLOOPY
GitHub112

Codex와 Claude Code를 위한 증거 우선 루프 하네스

끝났다는 건 증명됐다는 뜻.

Superloopy는 프롬프트 하나를 범위가 정해진 루프로 바꿔요. 기준을 먼저 적은 뒤 기준마다 실제 명령으로 증명해요. 영수증이 생기기 전에는 일을 끝났다고 하지 않아요.

설치
codex plugin marketplace add https://github.com/beefiker/superloopy
codex plugin add superloopy@beefiker

터미널에서 실행한 뒤 Codex를 다시 열고 훅을 승인하세요.

그다음 아무 작업 앞에 loopy를 붙이면 돼요.

실제 루프 보기GitHub에서 별 주기

01 · 작동 방식

프롬프트 하나, 루프 하나. 모든 단계가 나중에 열어 볼 수 있는 파일을 남겨요.

  1. 01

    기준

    loop begin 코드를 건드리기 전에 요청을 목표와 구체적인 통과 기준으로 바꿔요.

  2. 02

    증명

    loop prove -- <cmd> 검사를 실행하고 통과든 실패든 전체 출력을 증거로 남겨요.

  3. 03

    게이트

    loop check · loop finish 기준마다 유효한 증거가 있는지 확인해요. finish는 완료 전에 증명을 다시 돌려요.

  4. 04

    영수증

    보고서와 게이트 파일, 모든 캡처가 코드 옆 .superloopy/evidence에 남아요.

$ superloopy loop begin --brief "Fix cart total" --mode light
superloopy began: G001 Fix cart total

$ superloopy loop prove -- npm test
superloopy prove: G001/C001 -> fail (.superloopy/evidence/G001-C001-capture.txt)
# 수정: 끼어든 “+ 1” 삭제
$ superloopy loop prove -- npm test
superloopy prove: G001/C001 -> pass (.superloopy/evidence/G001-C001-capture.txt)
$ superloopy loop prove -- node --test total.test.js
superloopy prove: G001/C002 -> pass (.superloopy/evidence/G001-C002-capture.txt)

$ superloopy loop check
superloopy check: ok
Evidence summary: 2 artifact-backed criteria, 0 unresolved, 0 invalid

$ superloopy loop finish
superloopy finish: complete
Superloopy 0.22.3으로 장바구니 버그 한 줄을 고친 실제 출력이에요.

02 · 크루

역할은 여섯, 일은 하나씩. loopy team으로 일을 나눠 맡겨요. 영수증 없이 돌아온 일꾼의 결과는 인정하지 않아요.

백엔드 안내서에서 크루 보기

03 · 스킬

하는 일에 맞춘 레인. 어느 레인이든 증명 규칙은 같아요.

  1. 01superloopy-loop증거 루프: 기준, 증명, 게이트.loopy <task>
  2. 02superloopy-backend계약 먼저, 이웃 코드의 관례, 안전장치가 있는 마이그레이션.loopy <backend task>
  3. 03superloopy-frontend화면 UI를 만들고 시각 QA를 증거로 남겨요.$superloopy:superloopy-frontend
  4. 04superloopy-cloneURL 하나로 페이지를 다시 만들고 스펙과 스크린샷으로 비교해요.loopy clone <url>
  5. 05superloopy-slidesHTML 발표 자료와 PPTX를 눈으로 확인해요.loopy slides <topic>
  6. 06superloopy-research실제로 읽은 자료를 인용하는 리서치.loopy <research question>
  7. 07superloopy-doctor설치, 훅, 호스트 연결 상태를 진단해요.superloopy doctor
  8. 08humanize-korean사실은 그대로 두고 한국어 문장을 사람답게 다듬어요.$superloopy:humanize-korean
  9. 09say-it-straight뜻은 지키면서 짧고 곧게 써요.$superloopy:say-it-straight
  10. 10i-have-adhd요청할 때만, 행동부터 보여 주는 출력.$superloopy:i-have-adhd

스킬은 이렇게 불러요 $superloopy:<skill> (Codex) · /superloopy:<skill> (Claude Code)

04 · FAQ

자주 묻는 질문, 영수증과 함께 답해요.

꼼꼼한 프롬프트와 뭐가 다른가요?

프롬프트는 꼼꼼해 달라고 부탁하지만 Superloopy는 꼼꼼했는지 확인해요. 일을 시작하기 전에 기준을 적어요. 기준마다 명령으로 만든 증거가 있어야 하고 finish는 완료 전에 증명을 다시 돌려요.

증거는 어디에 남나요?

프로젝트 안 .superloopy/evidence에 명령 캡처, 게이트 파일, 마크다운 보고서가 남아요. 폴더는 .gitignore에 넣어 두거나 보고서를 PR에 첨부하세요.

루프가 끝나지 못하면요?

끝나지 못했다고 말해요. 보고서에 막힌 이유를 적고 그때까지 찾은 증거는 그대로 둬요. Stop 훅을 켜 두면 멈춘 루프는 완료가 아니라 막힘으로 표시돼요.

Claude Code에서도 되나요?

네. Codex와 Claude Code 모두 루프, 크루, 스킬을 그대로 써요. 호스트마다 한 번씩 설치하면 돼요.

에이전트는 빠르게 움직여요. Superloopy는 완료를 증명으로 바꿔요.

Superloopy 설치문서 읽기