워크플로 루프
Lumie의 실행 모델은 loop 기반입니다. Plan Mode는 계획과 사용자 승인을 소유합니다. plan이 승인된 뒤에는 loop contract가 제한된 실행, 검증 수 정, 리뷰 수정, 유지보수 정리를 소유합니다.
정본 loop source는 .codex/routing/loops/loop-contract.md입니다.
Loop 모델
Loop는 slash-command 단계가 아닙니다. 작업, 검사 출력, 리뷰 출력, 유지보수 신호를 관찰하고 승인된 범위 안에서 허용된 다음 행동을 결정하는 제어 루프입니다.
모든 loop는 같은 필드를 정의합니다.
| Field | 의미 |
|---|---|
trigger | loop가 시작되는 시점 |
input | 승인된 plan, diff, failure, finding, audit signal |
owner | 현재 step의 main agent, specialist, checker, hook, human owner |
observe | loop가 결정 전에 읽는 신호 |
decide | pass, fail, fix, escalate, defer, stop 기준 |
act | 승인된 범위 안에서 허용된 다음 행동 |
stop | loop를 종료하는 조건 |
evidence | Report, Review, Verify, commit readiness에 필요한 출력 |
max_iterations | 무제한 retry를 막는 guardrail |
escalation | Plan Mode로 돌아가거나 사용자에게 질문해야 하는 시점 |
End-To-End Flow
Work Loop
Work Loop는 승인된 Plan Mode plan 이후의 일반 실행과 Plan Mode가 필요 없는 명확하고 제한된 편집에 사용합니다.
Work Loop는 결과를 정리하고, repo scope와 owner surface를 해결하고, 필요할 때 specialist를 라우팅하고, 승인된 범위 안에서 편집하고, 영향을 받은 check를 실행하고, review matrix에서 리뷰 적용 범위를 라우팅하고, 증거를 보고합니다.
제품 문서의 경우 Work Loop는 .codex/routing/repos/document.md를 통해 라우팅하고
공개 문서, 개발자 문서, 라우팅 문서, 워크플로 정책, 문서 구조가
바뀌면 Docs Sync 점검 지점을 적용합니다.
Verify-Fix Loop
Verify-Fix Loop는 승인된 Work Loop 범위 안에서 영향을 받은 check, lint, test, hook, checker가 실패하거나 실행할 수 없을 때 사용합니다.
이 loop는 정확한 실패 명령, assertion, hook message, checker finding, 실행 불가 사유, 마지막 pass 이후 변경 파일을 읽습니다. 가장 작은 관련 fix를 적용하고, 같은 실패 check를 다시 실행하며, 그 fix가 invalidated한 필수 check도 다시 실행합니다.
같은 실패 signature에 대해 두 번 시도한 뒤에는 escalate합니다. fix가 범위, 위험, 소유 영역, 필수 check를 바꾸는 경우에는 더 일찍 escalate합니다.
Review-Fix Loop
Review-Fix Loop는 human owner, 리뷰어 에이전트, 체커 에이전트, required review evidence가 승인된 Work Loop 범위 안에서 finding을 보고할 때 사용합니다.
이 loop는 finding, affected file, review-matrix row, fix diff, 오래된 승인,
후속 review scope를 기록합니다. 리뷰어 에이전트와 체커 에이전트는 필요한
evidence를 제공할 수 있지만 mandatory human-owner:* coverage를 충족할 수
없습니다.
Maintenance Loop
Maintenance Loop는 .codex 감사, SSOT 정리, 오래된 참고 문서 정리, 규칙 가지치기,
반복되는 workflow failure 학습에 사용합니다.
이 loop는 중복 권한, 오래된 참고 문서, 누락된 Tier 0 enforcement, 죽은 호출 경로, 과도하게 큰 문서, 깨진 agent registry 상태를 찾습니다. 가지치기, 병합, reroute, Tier 0 후보 승격, owner와 함께 defer, Plan Mode escalation을 할 수 있습니다.
Stop Rules
- 다음 action이 승인된 plan을 넘어서면 멈춥니다.
- human-owner 승인이 필요하지만 사용할 수 없으면 멈춥니다.
- fix가 accepted plan 밖의 새 repo, owner surface, security-sensitive path, migration, public API, generated artifact, architecture decision을 건드리면 Plan Mode로 돌아갑니다.
- 사용자가 명시적으로 다른 iteration을 승인하지 않는 한 같은 check failure 또는 review finding을 두 번 고치지 못하면 멈춥니다.
- evidence가 오래되었거나, 모순되거나, 범위가 맞지 않거나, 누락되면 필수 게이트에서 멈춥니다.
검증
loop 동작은 이 소스 파일로 검증합니다.
sed -n '1,220p' .codex/routing/loops/loop-contract.md
sed -n '1,160p' .codex/routing/loops/work-loop.md
sed -n '1,160p' .codex/routing/loops/verify-fix-loop.md
sed -n '1,160p' .codex/routing/loops/review-fix-loop.md
sed -n '1,160p' .codex/routing/loops/maintenance-loop.md
예상 성공 신호: 파일은 이 문서에서 설명한 표준 loop 필드, 활성 loop 집합, 중지 규칙, 증거 요구사항을 보여줍니다.