Auto continue loop

Chronos (크로노스)

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

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

---

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

2026년 5월 Claude Code와 Codex에 네이티브 /goal("Set a goal Claude checks before stopping")이 들어왔습니다. 이건 멈추기 전에 목표 달성을 체크하는 Stop 게이트로, 크로노스의 loop-stop 훅과 같은 레이어입니다. 그래서 둘은 "자동 위임" 관계가 아니라 역할을 나누는 관계입니다.

레이어	담당	제공 주체
지속성 (끝까지 돌리기, Stop마다 목표 체크)	목표가 충족될 때까지 세션을 살림	네이티브 /goal (폴백: 훅·notify)
검증 게이트 (무엇으로 멈출지)	자가 판단이 아니라 실제 테스트 명령 실행 + <promise> 매칭	크로노스
구조 (어떤 순서로 돌지)	FIND→FIX→VERIFY + 우선순위 + 한 사이클 한 이슈 + 최소 변경 + 막힌 이슈 주차	크로노스
흔적 (무엇을 했는지)	docs/chronos/chronos-log.md 감사 로그 — 매 사이클 재독(재진입 규약)의 기준점	크로노스
흐름 검증 (제대로 됐는지)	flow-verifier로 구현 흐름 대조 (선택)	크로노스

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

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

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

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

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

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

크로노스가 생성하는 goal 목표문은 양쪽 CLI에서 동일하게 작동하도록 아래 5가지를 반드시 포함합니다. 특히 Claude /goal의 평가자는 명령을 실행하지 않고 Claude의 대화 출력만 보고 완료를 판정합니다. 따라서 "검증 결과를 대화에 출력"이 빠지면 평가자가 PASS를 인식하지 못합니다(Codex는 직접 실행하므로 무관하지만, 양쪽 호환을 위해 항상 포함).

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계층 폴백)

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

우선순위	엔진	조건	크로노스의 연동 방식
1순위	네이티브 /goal	Claude/Codex에 /goal 존재 + 사용자가 목표문 설정	goal 목표문 생성·제시 → 사용자가 /goal 설정
1.5순위	네이티브 /loop 심장박동 (Claude 전용)	--heartbeat 지정, 또는 사용자가 /goal 설정을 원치 않음	크로노스가 Skill 도구로 /loop를 직접 호출 (인터벌 재진입 — 사용자 입력 불필요)
2순위	Stop 훅 / notify 재개	/goal·/loop 없음 + 훅 인프라 설치됨	setup-loop로 상태 파일 생성 → 훅이 재투입
3순위	직접 루프	위 모두 불가 (Gemini, 폴백)	메인 컨텍스트에서 직접 사이클 반복

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순위)를 쓰세요 — 이쪽은 크로노스가 직접 겁니다.

---

동작 원리

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/Gemini에는 네이티브 /loop가 없으므로 이 엔진은 Claude 전용 — 다른 CLI는 2·3순위로 폴백.
• /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
→ 4. <promise>조건</promise> 출력 → 훅이 매칭 → 상태 파일 삭제 → 종료

3순위 — 직접 루프 폴백

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

---

사용법

# 기본 — 자동 스코프 감지, 엔진 자동 판별
/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/Gemini에서도 동일하게 제거.

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

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

옵션

옵션	설명	기본값	엔진별 적용
--max-iterations <N>	최대 반복 횟수	50	훅/직접: 강제 종료 / goal: budget 힌트 / heartbeat: 재진입 횟수 상한
--completion-promise '<조건>'	검증 게이트 (<promise> 태그로 매칭)	없음 (작업 소진 시 자동 종료)	모든 엔진 공통 (goal 목표문·heartbeat 재진입 프롬프트에도 주입)
--heartbeat [interval]	네이티브 /loop 인터벌 재진입을 엔진으로 (Claude 전용, /goal 설정 불필요)	off (지정 시 기본 10m)	1.5순위 엔진 강제
--flow-verify	flow-verifier 연동 — 루프 시작 전 프로세스 도면 생성(Phase 0.5), 완료 선언 전 도면 대 실제 코드 흐름 대조. 불일치는 다음 사이클 수정 대상으로 승격	off	모든 엔진 공통 (상세: skills/flow-verifier/SKILL.md의 "Chronos 통합")

점수형 완료 조건 (예: "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, Gemini는 .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

---

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이 있으면 그것을 우선. 주차된 이슈는 다시 선택하지 않는다.
   • memory/gotchas/·memory/learned/가 있으면 FIND에서 참조 — 같은 실수 반복 방지 + 성공 패턴 재사용 (chronos-worker와 동일)
   • 드라이("할 게 없음") 판정도 도구로: 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/Gemini)가 동일 버전을 변경 없이 승인할 때까지 bounded 반복(기본 N=2라운드).
• 한 라운드에서 수정이 생기면 양쪽이 새 버전을 다시 본다. 옛 버전의 깨끗한 리뷰를 새 버전 승인으로 간주하지 않는다.
• 반복 불일치(oscillation)·라운드 한도 도달·한쪽 패밀리 부재는 합의가 아니라 stall로 보고하고, 해당 이슈를 주차(PARK)한다.
• 한 패밀리만 가용하면 single-model review로 라벨하고 consensus를 주장하지 않는다.

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

우선순위

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

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

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

단계	행동	목적
1. 재시도	같은 접근으로 사이클 내 3회 재실행	일시적/플레이키 실패 거르기
2. 능력 상향 (이슈당 1회)	아래 중 가능한 것 하나로 같은 이슈 재시도: ① reasoning effort 상향 ② 더 강한 모델로 전환 ③ 둘 다 불가하면 focused review pass(실패한 검증 출력을 증거로 접근 1회 재설계)	같은 방식의 반복이 아닌 능력의 상향
3. 그래도 실패	검증 실패 사유로 주차	모델 능력으로 못 푼 것만 사람에게

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

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

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

주차 사유	예
검증 실패	3회 재시도 + 능력 1회 상향(에스컬레이션 사다리)까지 실패
권한 경계	부여받지 않은 권한 필요 — 푸시/머지/배포/파괴적 변경/scope 밖 수정
외부 접근 부재	자격증명, 실계정, 외부 서비스, 수동 조작 필요
제품 결정	코드만으로 정해지지 않는 방향 선택 — 합리적인 사람이 다르게 고를 수 있는 문제

주차 규칙:

• 주차 전에 갈 수 있는 데까지 간다. 재현, 원인 분석, 권한 안에서 가능한 수정과 테스트까지 끝내고, 정확히 무엇이 막혔는지를 남긴다. 날것의 이슈를 그대로 주차하는 것은 금지.
• 주차는 로그에 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를 출력하지 않는다.
• AskUserQuestion 호출 금지 — 결정이 필요한 이슈는 질문 대신 주차하고, 최종 보고의 Brief로 넘긴다
• 사유(주차 표의 4가지) 명시 없는 "막힘" 선언 금지 — 회피로 간주
• 전체 이슈 목록 나열 금지
• 한 번에 여러 이슈 동시 수정 금지
• 관련 없는 리팩토링 금지
• scope 밖 파일 수정 금지
• 사이클 사이에 멈추거나 대기 금지
• "다음으로는 X를 추천합니다" 같은 문장으로 마무리 금지
• docs/chronos/ 외의 상태/로그 파일 조작 금지

---

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

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

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

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

사이클마다 — 4상태 채점

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

상태	의미
proved	합격 증거가 현재 버전에서 재현됨
weak	증거가 있으나 불충분/오래됨 — 재확인 필요
missing	아직 증거 없음
contradicted	증거가 오히려 요구사항을 반증함 (최우선 FIND 대상)

완료 판정

• 모든 요구사항이 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개 필드를 채운다:

필드	내용
무엇	파일/이슈 위치 + 쉬운 말 설명 — 무엇이 바뀌고 누가 영향을 받는지
왜 지금	이 결정이 지금 필요한 이유
증거	어디까지 끌고 갔는지 — 재현 결과, 시도한 수정, 실제 테스트 출력. 검증 실패 주차면 에스컬레이션 사다리에서 무엇을 올렸고(추론/모델/review) 결과가 어땠는지 포함
트레이드오프	선택지별 득실과 남은 리스크
추천	크로노스의 추천과 근거. 추천은 의무다 — 기술 분석을 사용자에게 떠넘기지 않는다
선택지	사용자가 할 수 있는 정확한 행동 — 예: 권한 부여, 추천대로 진행 승인, 이슈 폐기

사용자의 일은 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 (크로노스 규율)	FIND→FIX→VERIFY 사이클, 검증 게이트 실행, goal 목표문 생성, 로그 기록, (heartbeat 엔진) /loop 호출·완료 시 중지	loop-state.md 읽기/수정/삭제, /goal 자동 호출
지속성 엔진	Stop 게이트 판정, 재투입, loop-state.md 관리(폴백)	코드 수정, 테스트 실행
사용자	/goal 설정/해제, cancel-loop 스크립트로 수동 중단	-

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에서 크로노스가 규율을 녹인 목표문을 제시하고, 사용자가 /goal로 켭니다. 크로노스는 /goal을 자동 호출하지 않습니다(슬래시 커맨드 호출 도구 부재). 목표문 생성·제시까지가 크로노스의 역할입니다.

진입 문법(/goal <목표>)은 양쪽이 같지만, 활성화·판정·관리가 다릅니다. 크로노스는 목표문을 자연어로 짜므로 이 차이를 우회하지만, 사용자 안내 시 참고하세요.

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

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

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

항목	Codex /goal	Claude /goal
활성화	features.goals 필요할 수 있음 (codex features enable goals)	v2.1.139+면 기본
완료 판정	Codex가 직접 명령 실행해 확인	별도 평가 모델이 대화 출력만 보고 판정 (명령 실행 안 함)
진행 확인	TUI 상태	/goal (인자 없이) → 턴/토큰/마지막 사유
중단/관리	/goal pause · /goal resume · /goal clear	/goal clear (별칭 stop/off/reset/cancel)

판정 차이가 핵심: 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에 로그가 남습니다.

---

Related Files

파일	역할
hooks/loop-stop.sh	Stop 훅 — 세션 종료 가로채기, 2순위 폴백 (Linux/Mac)
hooks/loop-stop.ps1	Stop 훅 — 세션 종료 가로채기, 2순위 폴백 (Windows)
skills/auto-continue-loop/scripts/setup-loop.sh	폴백 루프 시작 스크립트 (Linux/Mac)
skills/auto-continue-loop/scripts/setup-loop.ps1	폴백 루프 시작 스크립트 (Windows)
skills/auto-continue-loop/scripts/continue-loop.sh	Codex notify → background resume (Linux/Mac)
skills/auto-continue-loop/scripts/continue-loop.ps1	Codex notify → background resume (Windows)
skills/codex-mnemo/hooks/save-turn.sh	Codex notify 오케스트레이터 + Chronos 체인
skills/codex-mnemo/hooks/save-turn.ps1	Codex notify 오케스트레이터 + Chronos 체인
skills/auto-continue-loop/agents/chronos-worker.md	Gemini용 서브에이전트 정의 (3순위 직접 루프)
skills/flow-verifier/SKILL.md	구현 흐름 검증 통합 (선택 레이어)
skills/code-reviewer/SKILL.md	코드 리뷰 기준 참조
skills/systematic-debugging/SKILL.md	디버깅 방법론 참조
agents/security-reviewer.md	보안 이슈 기준 참조