Auto Continue Loop

Chronos (크로노스)

Chronos(크로노스: 시간의 신) — 끝없이 돌아가는 시간의 수레바퀴. 수레바퀴를 굴리는 힘(지속성)은 네이티브 /goal이 제공하고, 크로노스는 그 위에서 무엇을 검증하고 어떤 순서로 돌지를 규율한다.

주 진입점은 /chronos입니다. 사용자는 대부분 크로노스를 호출하고, 크로노스가 그 안에 /goal을 녹여 씁니다. goal은 지치지 않는 의지(Stop 게이트), 크로노스는 멈출 줄 아는 판단력(검증 규율)입니다.

/goal과 크로노스 — 역할 분리

Claude Code, Codex, Antigravity는 네이티브 /goal을 제공합니다. 이건 멈추기 전에 목표 달성을 체크하는 Stop 게이트로, 크로노스의 loop-stop 훅과 같은 레이어입니다. 그래서 둘은 "자동 위임" 관계가 아니라 역할을 나누는 관계입니다.

/goal 단독과의 결정적 차이: goal은 목표 달성을 모델이 자가 판단하면 멈춥니다. 크로노스는 그 위에 검증 게이트를 두어, 테스트 명령이 실제로 PASS하기 전에는 완료를 선언하지 못하게 합니다 — "다 된 것 같다"와 "검증으로 확인됐다"를 분리합니다.

크로노스는 goal을 자동 호출하지 않습니다 (중요)

스킬은 프롬프트 지시문이고, /goal은 사용자 입력으로 켜지는 네이티브 커맨드입니다. 크로노스가 런타임에 /goal을 프로그램적으로 띄우는 도구는 없습니다. 따라서 통합은 이렇게 동작합니다:

1. 크로노스가 검증·우선순위·완료조건·로그 규칙을 녹인 goal 목표문을 생성해 제시
2. 사용자가 그 목표문을 /goal로 설정 (입력 한 번)
3. 이후 네이티브 goal이 Stop마다 체크하고, 크로노스 규율대로 진행

"크로노스를 호출하면 goal이 자동으로 돌아간다"가 아니라, **"크로노스가 goal을 잘 쓰도록 목표문을 짜주고, 켜는 건 사용자"**입니다.

goal 목표문 필수 요소 (공통)

크로노스가 생성하는 goal 목표문은 지원 런타임에서 동일하게 작동하도록 아래 6가지를 반드시 포함합니다. 특히 Claude /goal의 평가자는 명령을 실행하지 않고 Claude의 대화 출력만 보고 완료를 판정합니다. Antigravity의 내부 판정 방식을 추정하지 않으며, 모든 런타임에서 "검증 결과를 대화에 출력"을 공통 계약으로 둡니다.

1. 측정 가능한 end state — 예: "test/auth 전부 통과 + 커버리지 80% 이상"
2. 검증 방법 명시 — 어떤 명령으로 증명하는지: "npm test가 exit 0"
3. 검증 결과를 대화에 출력 — 평가자가 볼 수 있게 실제 실행 결과를 노출 (자가 판단 금지)
4. 바뀌면 안 되는 제약 — 예: "다른 테스트 파일은 수정 금지"
5. turn/시간 상한 — 무한 루프 방지: "또는 50턴 내 미완료면 중단하고 보고"
6. 주차 규칙 — 막힌 이슈는 사유와 함께 로그에 주차(PARKED)하고 다음 이슈로 진행. 검증 실패 이슈는 사람에게 주차하기 전 능력 1회 상향(추론 effort 또는 더 강한 모델)을 거친다 — 같은 방식 재시도만으로 주차 금지. 남은 이슈가 전부 주차 상태면 주차 이슈별 Owner Decision Brief를 포함한 최종 보고로 완료를 선언할 수 있다 — 이 조항이 없으면 막힌 이슈만 남았을 때 goal 게이트가 영원히 미달 판정을 내려 루프가 데드락에 빠진다

지속성 엔진 선택 (4계층 폴백)

크로노스 규율(검증 게이트·구조·로그)은 어떤 엔진을 쓰든 동일하게 적용됩니다. 다른 건 "무엇이 세션을 끝까지 살리느냐"뿐입니다.

goal·heartbeat·훅은 모두 같은 지속성 레이어라 동시에 켜면 중복됩니다. 1순위(goal)와 1.5순위(heartbeat) 진입 시 setup-loop --goal-mode가 3곳(.claude/.codex/.chronos)의 기존 loop-state.md를 모두 제거하고 새로 만들지 않으므로, 훅이 재투입할 대상이 코드 레벨에서 사라집니다(하드 가드 — 규율이 아니라 코드로 충돌 가능성 0). goal과 heartbeat도 동시 사용 금지 — 항상 하나의 엔진만 게이트를 담당합니다.

1순위의 함정(중요): /goal은 네이티브 커맨드라 크로노스가 대신 켤 수 없습니다. 목표문을 제시받고 사용자가 /goal로 설정하지 않으면 지속성 엔진이 없는 상태(사실상 3순위)로 돌게 되어 루프가 중간에 멈춥니다. 설정이 번거로우면 --heartbeat(1.5순위)를 쓰세요 — 이쪽은 크로노스가 직접 겁니다.

Antigravity /schedule 경계: 일정 시각 실행, cron, "매 N분 확인" 같은 반복 모니터링은 네이티브 /schedule이 소유합니다. 크로노스는 하나의 유한 작업을 FIND→FIX→VERIFY하며 검증 통과까지 이어가는 완료 계약을 소유합니다. /schedule을 1.5순위 심장박동이나 /goal 대체물로 자동 선택하지 않습니다.

동작 원리

1순위 — goal 목표문 생성 + 연동

/chronos 버그 다 고쳐줘 --completion-promise '모든 테스트 통과'

→ 1. 스코프 감지 + 검증 게이트(테스트 명령) 감지 + 로그 초기화
     + setup-loop --goal-mode 실행 → 기존 loop-state.md 전부 제거 (하드 가드, 훅 충돌 방지)
→ 2. 크로노스가 goal 목표문을 생성해 제시:
     ┌─────────────────────────────────────────────────────────┐
     │ /goal 아래 규율로 진행하고, 충족되면 멈춰라:              │
     │  - src/ 안에서 한 번에 한 이슈씩 FIND→FIX→VERIFY          │
     │  - 우선순위 Critical>High>Medium>Low                      │
     │  - 막힌 이슈는 사유를 적어 로그에 주차(PARKED)하고        │
     │    다음 이슈로 — 이슈 하나가 루프를 멈추지 못한다         │
     │  - 검증 실패는 능력 1회 상향(추론/모델) 뒤에만 주차       │
     │  - 매 수정 후 `npm test`를 실행하고 결과를 대화에 출력    │
     │    (Claude 평가자는 출력만 봄 — 자가 판단 금지)           │
     │  - 각 사이클을 docs/chronos/chronos-log.md에 기록         │
     │  - 50턴 내 미완료면 중단하고 보고 (무한 루프 방지)        │
     │  - 테스트 PASS 출력 확인 시 <promise>모든 테스트 통과</promise> 출력 │
     │  - 남은 이슈가 전부 주차면 주차 이슈별 Brief를 포함한     │
     │    "Chronos Complete" 보고로 종료 (거짓 promise 출력 금지) │
     └─────────────────────────────────────────────────────────┘
→ 3. 사용자가 이 목표문을 /goal로 설정 (입력 한 번)
→ 4. 네이티브 goal이 Stop마다 "목표 충족?" 체크 → 미충족이면 다음 턴 계속
→ 5. 매 턴 크로노스 규율 적용: 한 사이클 한 이슈, 우선순위 순, 검증 실행, 로그 append
→ 6. 검증 PASS + <promise> 출력 → goal 게이트 통과 → 정지

1.5순위 — 네이티브 /loop 심장박동 (Claude 전용)

/goal은 사용자 입력으로만 켜지지만, 네이티브 /loop는 스킬이라 크로노스가 Skill 도구로 직접 호출할 수 있습니다. 사용자가 목표문 설정을 건너뛰길 원하거나 --heartbeat를 지정하면 이 엔진으로 기계 심장박동을 만듭니다.

→ 1. setup-loop --goal-mode 실행 → 기존 loop-state.md 전부 제거 (하드 가드 공유 — Stop 훅 이중 재투입 차단)
→ 2. 크로노스가 Skill 도구로 네이티브 /loop를 인터벌 모드로 호출: /loop 10m {재진입 프롬프트}
     재진입 프롬프트 (고정형 — 멱등하게 작성):
     ┌─────────────────────────────────────────────────────────┐
     │ docs/chronos/chronos-log.md를 읽고(READ 재진입 규약)      │
     │ 크로노스 루프를 이어가라.                                  │
     │  - 완료 계약이 전부 proved이거나 남은 이슈가 전부 주차면:  │
     │    최종 보고(Chronos Complete) 출력 후 이 /loop를 중지     │
     │  - 아니면: FIND→FIX→VERIFY→LOG 사이클을 계속 수행          │
     │  - 우선순위/주차/검증 규칙은 chronos-log 상단의 규율 참조  │
     └─────────────────────────────────────────────────────────┘
→ 3. 하네스가 인터벌마다 재투입 — 모델이 중간에 멈춰도 다음 발화가 로그에서 이어받는다 (의지가 아니라 기계)
→ 4. 완료 시 재진입 프롬프트의 지시대로 /loop 중지 (검증 게이트 PASS 확인 후의 중지는 엔진 수순의 일부 — 허용)

• 인터벌 모드가 기본 (기본 10m): 자가 페이싱(dynamic) 모드는 매 턴 모델이 다음 웨이크업을 예약해야 해서 "의지" 문제가 재발합니다. 인터벌은 하네스가 무조건 재투입합니다.
• 재진입은 멱등: 매 발화가 로그·완료 계약을 먼저 확인하고, 이미 완료 상태면 일하지 않고 루프만 중지합니다.
• 규율(검증 게이트·주차·완료 계약)은 로그 상단에 기록해 두므로, 재진입 발화가 컨텍스트 없이 시작해도 복원됩니다.
• Codex/Antigravity에는 Claude식 네이티브 /loop가 없으므로 이 엔진은 Claude 전용 — 다른 CLI는 2·3순위로 폴백. Antigravity /schedule은 시간 기반 예약이며 이 완료 게이트와 같지 않습니다.
• /goal과 동시 사용 금지 (같은 지속성 레이어 중복 — 하나만).

2순위 — Stop 훅 / notify 폴백 (goal 미지원·미설정 환경)

→ 1. setup-loop.sh가 CLI별 상태 파일 생성 (.claude/ · .codex/ · .chronos/loop-state.md)
→ 2. AI가 크로노스 사이클 수행 (FIND→FIX→VERIFY)
→ 3. turn 종료/세션 종료 시도 → 훅 체인이 상태 파일 재검증해 재투입:
     - Claude: loop-stop.sh(Stop 훅)가 block + 같은 프롬프트 재투입
     - Codex: save-turn notify → continue-loop → codex exec resume --last
     - Antigravity: `antigravity-hook.js chronos` Stop 훅이 `.chronos/loop-state.md` 검사
→ 4. <promise>조건</promise> 출력 → 훅이 매칭 → 상태 파일 삭제 → 종료

3순위 — 직접 루프 폴백

지속성 엔진이 없으면 메인 컨텍스트에서 사이클을 순차 반복합니다. --max-iterations까지 또는 검증 게이트 통과까지 진행하되, 컨텍스트 한도에 유의합니다.

chronos-worker라는 커스텀 에이전트 이름은 지속성 엔진이 아니며 기본 등록하지 않습니다. 한 사이클을 격리할 이점이 있을 때만 general-write 역할(Claude general-purpose, Codex worker, Antigravity 메인 또는 쓰기 도구를 명시한 사용자 정의 서브에이전트, Grok general-purpose)에 고유 파일 범위·검증 게이트·현재 로그·주차 목록을 함께 넘깁니다. 큐, 공유 로그, 재시도, 완료 판정과 다음 사이클은 메인 Chronos 하네스가 계속 소유합니다.

사용법

# 기본 — 자동 스코프 감지, 엔진 자동 판별
/chronos

# 특정 작업 지시
/chronos 버그 다 고쳐줘

# 특정 디렉토리 대상
/chronos src/backend/

# 최대 반복 제한 (훅/직접 루프에서 강제, goal에서는 budget 힌트)
/chronos 인증 버그 고쳐줘 --max-iterations 10

# 완료 조건 지정 (검증 게이트 — 모든 엔진 공통)
/chronos E2E 테스트 전부 통과시켜줘 --completion-promise '모든 테스트 통과'

# 점수형 게이트 — 품질 점수를 완료 조건으로 (promise에 넣지 않으면 점수는 무시됨)
/chronos UI 품질 개선 --completion-promise 'ui-ux-auditor 총점 90 이상'

# /goal 설정 없이 자동 심장박동으로 (Claude 전용 — 크로노스가 네이티브 /loop를 직접 걺)
/chronos 버그 다 고쳐줘 --heartbeat 10m --completion-promise '모든 테스트 통과'

# 정해진 할일만 순서대로 (체크리스트형)
/chronos 아래만 순서대로 완료하고 종료, 이 외 작업 금지: 1) ... 2) ... 3) ... --completion-promise '3개 완료'

# 중단
#  - goal 사용 중: 세션에서 /goal 해제 (esc 또는 /goal stop)
#  - heartbeat 사용 중: /loop 중지 지시 (네이티브 /loop의 중지 절차)
#  - 훅 폴백: cancel-loop 스크립트
bash  skills/auto-continue-loop/scripts/cancel-loop.sh
pwsh -File skills/auto-continue-loop/scripts/cancel-loop.ps1

공식 호출명: /chronos (별칭: 크로노스)

구 별칭 /loop 폐기 (2026-06-11): Claude Code에 네이티브 /loop(주기 반복 실행기)가 들어오면서 이름이 충돌해 크로노스 별칭에서 제거했습니다. 크로스-CLI 호출명 통일 정책에 따라 Codex/Antigravity에서도 동일하게 제거.

언제 무엇을 쓰나 (네이티브 3종과의 구분):

도구	본질	쓰는 상황
네이티브 /goal	Stop 게이트 (멈춤 방지)	"끝까지 돌리기"만 필요할 때 — 단독으로 충분
네이티브 /loop	반복 실행기 (인터벌/자가 페이싱 재투입)	폴링·정기 작업: "5분마다 배포 확인", "주기적으로 X 실행". 완료 기준·검증 게이트 없음. 크로노스가 1.5순위 심장박동 엔진으로 차용(--heartbeat)
/chronos	루프 규율 (검증 게이트 + 우선순위 + 감사 로그)	"검증으로 멈추고, 우선순위대로, 흔적을 남기며" 돌릴 때 — goal을 그 규율에 맞게 녹여줌

옵션

Source-only internal module resolution (mandatory)

flow-verifier, code-reviewer, ui-ux-auditor는 특정 옵션·스코프·완료 조건이 선택했을 때만 Chronos가 읽는 source-only 내부 모듈입니다. 등록된 스킬이나 slash command로 호출하지 않습니다.

각 선택된 모듈을 다음 순서로 해석하고 처음 확인된 exact SKILL.md 파일 하나를 읽습니다.

1. 현재 프로젝트의 skills/{name}/SKILL.md가 실제로 있으면 그 exact 파일.
2. 없으면 현재 런타임 active root의 exact 파일: Claude/Grok은 ~/.claude/skills/{name}/SKILL.md, Codex는 ~/.codex/skills/{name}/SKILL.md, Antigravity는 ~/.gemini/antigravity-cli/skills/{name}/SKILL.md (명시 opt-in 설치 지원).
3. 둘 다 없으면 현재 런타임 전역 카탈로그(Claude/Grok ~/.claude/SKILLS-CATALOG.md, Codex ~/.codex/SKILLS-CATALOG.md, Antigravity ~/.gemini/antigravity-cli/SKILLS-CATALOG.md)에서 정확한 모듈명 행을 찾습니다. 행이 하나일 때만 읽을 경로의 절대 SKILL.md를 읽고, 누락·중복 행은 fail-closed입니다. 기본 경로가 .olympus/source-skills 아래여도 조합하거나 추측하지 않습니다.
4. module_root는 읽은 SKILL.md의 부모입니다. 해당 모듈의 references/, scripts/, commands/는 그 루트에서만 해석합니다.
5. --flow-verify일 때만 flow_verifier_root, 리뷰/보안 gate를 실제 선택했을 때만 code_reviewer_root, completion promise가 UI 감사 점수를 요구할 때만 ui_ux_auditor_root를 만듭니다. 기본 루프 시작 시 세 모듈을 선로딩하지 않습니다.

이 exact 파일 읽기는 내부 모듈 로드입니다. 런타임 Skill 목록/레지스트리를 근거로 호출하거나 모듈 이름을 slash command로 실행하지 않습니다.

선택된 모듈의 행·경로·필수 reference를 읽지 못하면 로그와 완료 계약에 NOT RUN: source module unavailable을 기록합니다. flow/UI처럼 사용자가 명시한 gate는 missing 상태를 유지하고 <promise>를 출력하지 않습니다. code-reviewer만 현재 CLI의 네이티브 review가 있으면 1회 bounded fallback을 허용하며 native fallback; policy module NOT RUN 으로 표기합니다. 어느 fallback도 source module PASS로 둔갑시키지 않습니다.

점수형 완료 조건 (예: "90점 이상") — 반드시 promise로

품질 점수(ui-ux-auditor 총점, argos 판정, skill-judge 점수 등)는 검증 게이트 자동 감지(0-2)에 잡히지 않습니다. promise에 넣지 않으면 종료 조건 1("할 게 없으면 종료")이 도구 신호(테스트/린트/타입체크) 초록 기준으로 발동해, 점수가 목표 미달이어도 정당하게 종료합니다 — "루프가 중간에 멈췄다"의 흔한 원인입니다.

점수 게이트는 3요소를 갖춰야 유효합니다 (goal 목표문·heartbeat 재진입 프롬프트에 그대로 주입):

1. 측정 가능한 임계값 — "ui-ux-auditor 총점 90 이상"
2. 측정 방법 — 어떤 내부 모듈/명령이 점수를 내는지: "매 사이클 종료 시 ui-ux-auditor 계약 수행"
3. 결과를 대화에 출력 — Claude /goal 평가자는 명령을 실행하지 않고 대화 출력만 봅니다. 점수를 출력하지 않으면 판정 불가

등록된 점수 게이트는 완료 계약의 요구사항이 되어, 점수 미달은 missing/weak로 남아 "할 게 없음" 종료를 막고 다음 사이클 FIND("점수 갭 원인")로 승격됩니다.

Auto-Continuation Contract

• 다음 작업 추천, 우선순위, 남은 작업 같은 응답을 만들려는 순간, 가장 위의 actionable item을 즉시 다음 사이클로 승격합니다.
• 현재 scope 안에 있고 외부 승인/비밀값/수동 조작 없이 진행 가능하면 사용자에게 묻지 않고 계속 진행합니다.
• 사용자에게 넘기는 경우는 3가지뿐:
  • 더 이상 실행 가능한 in-scope 작업이 없음
  • 남은 작업이 전부 blocked / out-of-scope / manual-only
  • 사용자가 우선순위 범위를 제한함 (예: "보안만", "High까지만")

Phase 0: 스코프 + 엔진 + 목표문

루프 시작 전 스코프를 확정하고, 엔진을 판별하고, (1순위면) goal 목표문을 짭니다.

0-1. 스코프 결정

$ARGUMENTS가 있으면 해당 경로를 스코프로 사용합니다.

없으면 아래 순서로 자동 감지:

1. 현재 세션에서 이미 작업 중인 디렉토리/파일 패턴
2. git diff --name-only로 최근 변경된 파일 영역
3. 프로젝트 루트 전체

0-2. 검증 게이트(테스트 프레임워크) 감지

package.json → npm test / npx jest / npx vitest
pytest.ini / pyproject.toml → pytest
pom.xml → mvn test
*.csproj → dotnet test
tsconfig.json → npx tsc --noEmit
없음 → "수동 확인 필요" 모드

감지된 명령이 곧 검증 게이트입니다. 매 사이클 이 명령을 실행해 PASS를 확인해야 완료가 허용됩니다(자가 판단 금지).

0-3. 엔진 판별 + (1순위) 목표문 제시 / (폴백) 상태 초기화

지속성 엔진 선택에 따라 엔진을 정합니다.

• 1순위(goal 가용): 동작 원리 1순위의 형식으로 goal 목표문을 생성해 제시하고, 사용자가 /goal로 설정하도록 안내합니다. 진입 시 setup-loop --goal-mode를 실행해 기존 loop-state.md를 모두 제거합니다 — 폴백 상태 파일을 만들지 않으므로 Stop 훅이 발동할 대상이 코드 레벨에서 사라져 이중 재투입 충돌이 불가능합니다(하드 가드). 로그(docs/chronos/)만 초기화합니다.
• 1.5순위(--heartbeat 또는 사용자가 goal 설정 생략 의사): setup-loop --goal-mode로 상태 파일을 제거(하드 가드 공유)한 뒤, Skill 도구로 네이티브 /loop <interval> {재진입 프롬프트}를 직접 호출합니다. 규율(검증 게이트·완료 계약·우선순위)을 로그 상단에 기록해 재진입 발화가 컨텍스트 없이도 복원하게 합니다.
• 2·3순위(폴백): setup-loop.sh(또는 .ps1)로 공유 상태 파일을 생성합니다. Claude는 .claude/loop-state.md, Codex는 .codex/loop-state.md, Antigravity는 --runtime antigravity와 .chronos/loop-state.md를 사용합니다.

크로노스(Chronos) 시작
엔진: {네이티브 /goal | Stop 훅·notify | 직접 루프}
스코프: {디렉토리/파일 목록}
검증 게이트: {감지된 테스트 명령}
반복: 최대 {N}회 (또는 무제한)
완료 조건: {조건} (또는 없음)
로그: docs/chronos/chronos-log.md

{1순위면} → 아래 목표문을 /goal로 설정하세요:
{생성된 goal 목표문}
주의: 목표문을 /goal로 설정하지 않으면 지속성 엔진이 없어 루프가 중간에 멈춥니다.
      설정을 원치 않으면 --heartbeat로 다시 호출하세요 (크로노스가 직접 겁니다).
{1.5순위면} → 네이티브 /loop 심장박동 가동 (인터벌 {N}m) — 중단은 /loop 중지로
{폴백이면} → 중단: bash skills/auto-continue-loop/scripts/cancel-loop.sh

0-4. 조건부 source module gate

• --flow-verify이면 flow-verifier 모듈을 위 resolver로 읽고 ${flow_verifier_root}/SKILL.md의 Chronos 통합 계약을 적용합니다.
• completion promise에 ui-ux-auditor 점수/임계값이 있으면 해당 모듈을 읽고, 모듈이 요구하는 reference와 script를 ui_ux_auditor_root에서 해석해 매 사이클 종료 시 측정합니다.
• 사용자가 코드 리뷰·보안 감사를 스코프나 gate로 명시했을 때만 code-reviewer를 읽습니다. 보안 reference가 필요하면 ${code_reviewer_root}/references/security-audit.md를 사용합니다.
• 모듈 상태(LOADED, NOT RUN, native fallback)를 docs/chronos/chronos-log.md 머리에 기록하고, 재진입 때도 같은 정확한 경로를 복원합니다.

Phase 0.5: flow-verifier plan (옵션)

--flow-verify가 있고 모듈을 성공적으로 읽었을 때만 로드한 plan 계약으로 docs/flow-diagrams/{feature}.mmd를 생성합니다. 완료 선언 직전에는 같은 모듈의 verify 계약으로 현재 코드 흐름을 대조하고, 불일치는 다음 FIND 이슈로 승격합니다. 모듈이 없으면 다이어그램이나 PASS stub을 만들지 않고 NOT RUN과 Owner Decision Brief를 남깁니다. flow gate가 완료 조건에 포함된 경우 그 상태에서는 promise를 출력할 수 없습니다.

Phase 1: 루프 실행

사이클 규칙 (엔진 공통 — 크로노스 규율)

지속성 엔진이 무엇이든, 매 사이클 5단계를 수행합니다:

0. READ (재진입 규약): docs/chronos/chronos-log.md를 다시 읽어 마지막 사이클 번호, 남은 스코프, 주차(PARKED) 목록을 복원한다. 컨텍스트 기억과 로그가 어긋나면 로그가 맞다. 새 세션에서 이어받을 때는 검증 게이트를 1회 실행해 현재 상태를 확인한 뒤 FIND로 들어간다 — 루프의 상태는 모델의 기억이 아니라 로그에 있다. 이 덕분에 세션이 죽어도 /chronos 재실행만으로 루프가 이어진다.
1. FIND: 도구 신호에서 시작한다(외부 근거 우선) — 모델 직관으로 이슈를 떠올리기 전에 가용한 정적 신호를 먼저 모은다: 검증 게이트(테스트, VERIFY에서 이미 실행) + tsc --noEmit/타입체크 + lint + 빌드 에러(값싼 것은 매 사이클, 보안 스캔 등 무거운 것은 보안 스코프이거나 첫 사이클 1회). 수집된 구체적 실패 중 우선순위 최상위 1개를 고른다. 도구 신호가 0건일 때만 모델 판단으로 찾는다(도구가 못 잡는 설계 결함·누락 기능). 직전 사이클에서 승격된 next-action이 있으면 그것을 우선. 주차된 이슈는 다시 선택하지 않는다.
   • 리뷰/보안 스코프이면 위에서 로드한 code-reviewer 계약을 적용합니다. 모듈이 없으면 네이티브 review 1회로만 축소하고 policy module NOT RUN을 로그에 남기며, 네이티브 도구도 없으면 해당 감사 gate를 NOT RUN으로 유지합니다.
   • memory/gotchas/·memory/learned/가 있으면 FIND에서 참조 — 같은 실수 반복 방지 + 성공 패턴 재사용 (Chronos 사이클 공통 계약)
   • 드라이("할 게 없음") 판정도 도구로: lint/typecheck/테스트가 빨간 상태면 "할 게 없음"을 선언하지 않는다 — 정적 신호가 모두 초록일 때만 in-scope 작업 0건이 성립한다(모델 기억이 아니라 도구 출력 기준).
2. FIX: 최소 변경 원칙 — 이슈 해결에 필요한 최소한의 코드만 수정
3. VERIFY: 검증 게이트 명령 실행. 수정이 통합 경계를 건드렸으면 게이트 전에 경계면 교차비교를 1회(웹: API 응답 shape↔훅 타입·경로↔href·엔드포인트↔훅 1:1 / 비웹: 해당 경계 / 없으면 skip) — "빌드/테스트 통과 ≠ 정상"(TS 제네릭이 런타임 mismatch를 숨김), 양쪽 파일을 동시에 읽어 계약을 대조한다. 실패 시 같은 사이클 내 최대 3회 재시도. 3회 실패 → 에스컬레이션 사다리(능력 1회 상향) → 그래도 실패 → 주차(PARK)
4. LOG: docs/chronos/chronos-log.md에 append

검증 게이트가 없는 산출물 — 교차모델 수렴 (034, 선별적)

대부분의 사이클은 검증 게이트(테스트 명령)가 결정론적으로 PASS/FAIL을 가른다 — 이 경우 다른 모델을 부르지 않는다(느리고 새 신호가 없다). 그러나 산출물이 스펙·설계·문서처럼 실행 테스트로 판정할 수 없는 경우에 한해, VERIFY를 Loop Library 034(multi-LLM convergence)로 대체한다:

• 서로 다른 두 모델 패밀리(예: Claude + Codex 또는 Antigravity의 Gemini 모델)가 동일 버전을 변경 없이 승인할 때까지 bounded 반복(기본 N=2라운드).
• 한 라운드에서 수정이 생기면 양쪽이 새 버전을 다시 본다. 옛 버전의 깨끗한 리뷰를 새 버전 승인으로 간주하지 않는다.
• 반복 불일치(oscillation)·라운드 한도 도달·한쪽 패밀리 부재는 합의가 아니라 stall로 보고하고, 해당 이슈를 주차(PARK)한다.
• 한 패밀리만 가용하면 single-model review로 라벨하고 consensus를 주장하지 않는다.

비용 규율: 교차모델은 테스트 불가 산출물에만, 사이클 종료 직전 1회만 적용한다. 코드+테스트가 있는 사이클의 구현 게이트(VERIFY)에는 적용하지 않는다 — 그 자리는 테스트 명령이 결정론적으로 판정한다.

우선순위

Critical(보안) > High(버그/데이터 무결성) > Medium(구조/스코프) > Low(스타일)

에스컬레이션 사다리 — 사람에게 주차하기 전 능력을 한 칸 올린다

검증 실패를 사람에게 주차하기 전에 반드시 능력 상향을 1회 거친다. "같은 방식 3회 재시도"는 능력을 올리지 않으므로, 그것만으로 주차하는 것은 무효다. 사람에게 결정을 떠넘기기 전에 모델 능력으로 풀 수 있는 길을 먼저 소진한다.

• 능력 상향은 이슈당 1회만 — 무한 에스컬레이션 금지.
• 환경이 이미 최상위 능력(상향 불가)이면 3번 focused review로 갈음한다.
• 무엇을 올렸고(추론/모델/review) 결과가 어땠는지를 Owner Decision Brief 증거란에 기록한다.

주차(PARK) — 막힌 이슈는 루프를 멈추지 못한다

이슈 하나가 막혔다고 루프 전체가 서면 안 된다. 아래 사유에 해당하면 그 이슈를 주차하고 즉시 다음 이슈로 넘어간다:

주차 규칙:

• 주차 전에 갈 수 있는 데까지 간다. 재현, 원인 분석, 권한 안에서 가능한 수정과 테스트까지 끝내고, 정확히 무엇이 막혔는지를 남긴다. 날것의 이슈를 그대로 주차하는 것은 금지.
• 주차는 로그에 Parked: 항목으로 기록하고, 이후 FIND는 주차된 이슈를 다시 선택하지 않는다.
• "막혔다"는 선언은 위 표의 사유 중 하나를 명시해야 유효하다. 사유 없는 주차는 회피로 간주한다.
• 검증 실패 주차는 에스컬레이션 사다리(능력 1회 상향)를 거쳐야 유효하다. 같은 방식 3회 재시도만으로 주차하는 것은 무효.
• 남은 이슈가 전부 주차 상태면 루프를 끝낼 수 있다 — 단, 최종 보고에서 주차 이슈마다 Owner Decision Brief를 작성해야 한다.

로그 기록

# 첫 사이클 전 초기화 (Gate/Promise까지 기록 — heartbeat 재진입 발화가 컨텍스트 없이 복원하는 기준)
mkdir -p docs/chronos
echo '# Chronos Log' > docs/chronos/chronos-log.md
echo "Started: $(date -Iseconds)" >> docs/chronos/chronos-log.md
echo 'Engine: {네이티브 /goal | /loop 심장박동 | 훅·notify | 직접}' >> docs/chronos/chronos-log.md
echo 'Scope: {스코프}' >> docs/chronos/chronos-log.md
echo 'Gate: {검증 게이트 명령}' >> docs/chronos/chronos-log.md
echo 'Promise: {완료 조건 — 없으면 "작업 소진 시 종료"}' >> docs/chronos/chronos-log.md

# 매 사이클
echo '── Cycle N ──────────────────────────' >> docs/chronos/chronos-log.md
echo 'Issue: ...' >> docs/chronos/chronos-log.md
echo 'Fix:   ...' >> docs/chronos/chronos-log.md
echo 'Verify: ... → PASS' >> docs/chronos/chronos-log.md
echo '────────────────────────────────────────' >> docs/chronos/chronos-log.md

# 주차 발생 시 (사유는 주차 표의 4가지 중 하나)
echo 'Parked: {이슈} — 사유: {검증 실패|권한 경계|외부 접근 부재|제품 결정} — 진행 상태: {어디까지 갔는지}' >> docs/chronos/chronos-log.md

종료 조건 (검증 게이트)

AI가 루프를 끝내는 방법은 딱 2가지:

1. 할 게 없으면 (실행 가능한 in-scope 이슈가 0건 — 남은 것이 전부 주차 상태인 경우 포함) → 주차 이슈별 Owner Decision Brief를 담은 최종 보고(Chronos Complete) 출력. 주차만 남았을 때 <promise>를 출력하는 것은 거짓 완료 선언이므로 금지.
2. 완료 조건 달성 → 검증 게이트 PASS 확인 후 <promise>조건</promise> 출력

그 외에는 AI가 종료를 판단하지 않는다. 지속성 엔진이 알아서 계속시킨다:

• 네이티브 /goal: 검증 게이트 미충족 시 goal이 Stop에서 "목표 미달"로 판정 → 다음 턴 계속
• 네이티브 /loop 심장박동: 하네스가 인터벌마다 재진입 프롬프트 재투입 — 재진입 발화가 로그·완료 계약을 확인해 완료면 루프 중지, 아니면 사이클 계속 (완료 확인 후의 /loop 중지는 엔진 수순의 일부로 허용)
• 훅 폴백: 위 패턴 미감지 → Claude Stop 훅이 block + 같은 프롬프트 재투입
• --max-iterations 도달 (기본 50회) → 폴백 엔진이 강제 종료
• stale 2시간 초과 → 훅이 자동 종료

AI가 절대 하지 않는 것:

• "루프를 종료할까요?" 질문 ❌
• 검증 게이트를 건너뛰고 <promise> 출력 ❌ (테스트 PASS 없이 완료 선언 금지)
• loop-state.md 삭제 시도 ❌
• "이만 마치겠습니다" 같은 임의 종료 ❌ (할 게 남았으면 계속)

금지 사항

• loop-state.md 절대 접근 금지 (훅 폴백 사용 시) — .claude/, .codex/, .chronos/ 아래 상태 파일은 읽기/수정/삭제 모두 금지. 훅/notify 체인만 관리한다.
• 루프 종료를 직접 시도 금지 — 종료는 검증 게이트 통과 시 엔진이 처리하거나, 사용자가 중단(/goal 해제 또는 cancel-loop)으로 수행한다. 예외 하나: heartbeat 엔진에서 검증 게이트 PASS(또는 전부 주차) 확인 후의 /loop 중지는 엔진 수순의 일부다 — 검증 없는 중지는 여전히 금지.
• 검증 없는 완료 선언 금지 — 검증 게이트가 정의돼 있으면 PASS를 실제로 확인하기 전에 <promise>/Chronos Complete를 출력하지 않는다.
• 대화형 질문 도구 호출 금지 — 결정이 필요한 이슈는 질문 대신 주차하고, 최종 보고의 Brief로 넘긴다
• 사유(주차 표의 4가지) 명시 없는 "막힘" 선언 금지 — 회피로 간주
• 전체 이슈 목록 나열 금지
• 한 번에 여러 이슈 동시 수정 금지
• 관련 없는 리팩토링 금지
• scope 밖 파일 수정 금지
• 사이클 사이에 멈추거나 대기 금지
• "다음으로는 X를 추천합니다" 같은 문장으로 마무리 금지
• docs/chronos/ 외의 상태/로그 파일 조작 금지

완료 계약 (Completion Contract) — 거짓 완료 방지

Loop Library 028(completion-contract)에서 가져온 규율. --completion-promise가 "무엇으로 멈출지"라면, 완료 계약은 "완료를 어떻게 증명할지"를 착수 전에 고정해 부분 완료가 완료로 둔갑하는 것을 막는다.

착수 시 — 요구사항·증거 등록

루프 시작 시(Phase 0) --completion-promise를 요구사항 목록 + 각각의 합격 증거로 분해해 로그 상단에 등록한다. 각 요구사항에는 그것을 증명할 실행 가능한 증거(테스트 명령·관찰·산출물)를 1:1로 붙인다. 모르는 증거 방법은 발명하지 않고 "증거 방법 미정"으로 두되, 미정 항목이 남아 있으면 완료를 선언할 수 없다.

사이클마다 — 4상태 채점

매 사이클 종료 시 각 요구사항을 4상태 중 하나로 채점해 로그에 갱신한다:

완료 판정

• 모든 요구사항이 proved일 때만 <promise> 출력 / Chronos Complete 선언이 허용된다.
• weak·missing·contradicted가 하나라도 남으면 완료가 아니다 — 해당 항목을 다음 사이클 FIND로 승격하거나, 막혔으면 주차(PARK)한다.
• --max-iterations 소진은 exhausted(미완)로 보고하며 절대 success가 아니다. 예산이 끝나도 미증명 요구사항이 있으면 거짓 promise를 출력하지 않고 최종 보고로 넘긴다.

Phase 2: 최종 보고

══ Chronos Complete ══════════════════
Engine: {네이티브 /goal | 훅·notify | 직접}
Total cycles: {N}
Iterations: {N} (엔진 재투입 횟수)
Fixed: {N}건
Parked: {N}건
Remaining: {N}건

Fixed Issues:
  ✅ {이슈} ({파일})

Parked Issues: (항목마다 아래 Owner Decision Brief 규격으로 작성)
  ⚠️ {이슈} — 사유: {주차 표의 4가지 중 하나}

Remaining:
  ℹ️ {이슈} — 사유: {왜}

Requirement → Evidence (완료 계약 마감):
  {요구사항} — {proved|weak|missing|contradicted} — 증거: {실제 테스트 출력/관찰}
═══════════════════════════════════════

Owner Decision Brief — 주차 이슈 보고 규격

주차된 이슈를 한 줄 사유로 끝내지 않는다. 결정을 요청하려면 먼저 그 일을 결재 가능한 상태까지 끌고 와야 한다. 항목마다 아래 6개 필드를 채운다:

사용자의 일은 4지선다다: 추천대로 승인 / 반려 / 정확히 하나의 접근 권한 부여 / 문서화된 대안 중 택일. 날것의 이슈를 들고 와서 "이거 어떻게 할까요?"라고 묻는 것은 규칙 위반이다.

상태 파일 (.claude/.codex/.chronos loop-state.md) — 훅 폴백 전용, AI 접근 금지

⚠️ 이 파일은 2순위(훅/notify) 폴백 엔진에서만 사용됩니다. AI는 절대 읽거나 수정하거나 삭제하지 않습니다. 훅(loop-stop.sh/ps1)이 자동으로 생성, 업데이트, 삭제합니다. 네이티브 /goal(1순위)은 이 파일을 쓰지 않습니다.

---
active: true
iteration: 3
session_id: abc123
last_turn_id: "turn_123"
max_iterations: 20
completion_promise: "모든 테스트 통과"
started_at: "2026-03-12T10:00:00Z"
---

버그 다 고쳐줘

책임 분리:

AI가 루프를 끝내는 유일한 방법:

• 할 작업이 없으면 Chronos Complete를 포함한 최종 보고를 출력
• 완료 조건이 있으면 검증 게이트 PASS 확인 후 <promise>조건</promise>를 출력
• → 엔진이 이 패턴을 감지하고 루프를 종료 (훅 폴백은 상태 파일을 삭제)

실시간 모니터링

# Linux/Mac
tail -f docs/chronos/chronos-log.md

# Windows PowerShell
Get-Content docs/chronos/chronos-log.md -Wait

엔진 배선

네이티브 /goal (1순위)

별도 설치가 필요 없습니다. /goal이 있는 Claude/Codex/Antigravity에서 크로노스가 규율을 녹인 목표문을 제시하고, 사용자가 /goal로 켭니다. 크로노스는 /goal을 자동 호출하지 않습니다(슬래시 커맨드 호출 도구 부재). 목표문 생성·제시까지가 크로노스의 역할입니다.

세 런타임 모두 /goal 진입점을 제공하지만 활성화·판정·관리 세부는 런타임이 소유합니다. 크로노스는 공통 자연어 목표문과 외부 검증 출력만 요구하며 문서에 없는 세부 명령을 추측하지 않습니다.

네이티브 /loop 심장박동 (1.5순위, Claude 전용)

별도 설치가 필요 없습니다. /goal과 달리 /loop는 스킬이므로 크로노스가 Skill 도구로 직접 호출할 수 있습니다 (사용자 입력 불필요 — "심장박동은 기계에" 원리). 진입 시 setup-loop --goal-mode로 상태 파일을 제거해 Stop 훅과의 이중 재투입을 하드 가드로 차단합니다.

• 중단: 사용자가 /loop 중지를 지시하거나, 완료 시 재진입 프롬프트가 스스로 중지합니다.
• /goal이 이미 설정된 세션에서는 heartbeat를 걸지 않습니다 (같은 레이어 중복 금지).

다음 표는 별도로 확인된 Codex와 Claude의 관리 차이입니다. Antigravity는 공식 /goal 계약까지만 의존합니다.

판정 차이가 핵심: Claude 평가자는 명령을 실행하지 않으므로, 목표문에 "검증 결과를 대화에 출력"이 반드시 있어야 PASS가 인식됩니다(위 goal 목표문 필수 요소 참조).

Claude Code 훅 (2순위 폴백)

hooks/loop-stop.sh (Linux/Mac) 또는 hooks/loop-stop.ps1 (Windows)를 settings.json의 Stop 이벤트에 등록:

{
  "hooks": {
    "Stop": [
      { "type": "command", "command": "bash ~/.claude/hooks/loop-stop.sh" }
    ]
  }
}

/goal을 쓰는 환경에서도 이 훅은 무해합니다 — 크로노스가 1순위로 goal을 쓰면 상태 파일을 만들지 않으므로 훅이 재투입할 대상이 없습니다.

Codex CLI (2순위 폴백)

Codex는 Stop 이벤트가 없으므로 root hooks/loop-stop.*를 직접 쓰지 않습니다. 대신 codex-mnemo의 notify 훅이 save-turn 뒤에서 Chronos를 체인합니다. (/goal 지원 빌드라면 1순위로 목표문 연동)

1. node scripts/sync-codex-assets.js
2. node skills/codex-mnemo/install.js
3. ~/.codex/hooks/save-turn.ps1|sh가 ~/.codex/skills/auto-continue-loop/scripts/continue-loop.ps1|sh를 호출

Codex 재개는 background codex exec resume --last로 수행되며, 현재 프로젝트의 docs/chronos/codex-resume.log에 로그가 남습니다.

Antigravity CLI (goal 미사용 시 2순위 폴백)

sync-antigravity-assets.js가 antigravity-hook.js를 ~/.gemini/config/hooks/에 복사하고, install-hooks-config.js --target antigravity가 ~/.gemini/config/hooks.json의 Stop 이벤트에 Chronos 핸들러를 등록합니다. setup-loop.sh --runtime antigravity 또는 PowerShell 대응 명령이 .chronos/loop-state.md를 만들면 Stop 훅이 Antigravity의 camelCase conversationId와 transcriptPath를 사용해 완료 여부를 검사하고 decision: continue로 다음 턴을 재투입합니다.

• 설치기 계약 테스트와 합성 transcript 검증 전에는 VERIFIED로 보고하지 않습니다. 실제 Antigravity 세션에서 Stop 재투입을 확인할 수 없는 환경에서는 3순위 직접 루프를 사용합니다.

Related Files