Looptimal — 결과 오케스트레이터
목표를 검증된 결과로 전환하세요: 승인 기준을 봉인하고, 올바른 루프를 선택하거나 거부하며, 계획을 워게임하고, 도메인 전문가와 함께 실행하며, 별도의 검증기가 봉인된 스위트를 다시 실행하여 실제 상태를 기준으로 완료 여부를 판단합니다. 자체 보고된 GREEN에 의존하지 않습니다.
루프 설계 마법사(이전의 독립형 LoopPrint)는 2단계(Design-loop)에 내장되어 있습니다. 결과 오케스트레이션 없이 루프 청사진만 필요한 경우 design 빠른 경로로도 실행할 수 있습니다.
사용 시기
- "looptimal", "/looptimal", "결과 루프 실행", "이 목표를 완료까지 오케스트레이션", "이 목표를 계획하고 출시"
- "완료"가 작업을 수행한 에이전트가 주장하는 것이 아니라 실제 상태에 대해 증명되어야 하는 중요한 목표
- 역량 매니페스트, 합의 계획, 결과 수준에서 제작자 ≠ 검증자가 필요한 다중 도메인 작업
- Design-loop가 실제로 루프임을 확인한 후의 반복, 감독, 래칫 또는 오케스트레이션 패턴
- 자율 실행 전에 시뮬레이션을 통해 계획을 워게임하려는 경우
- 한 번 전달되고 실제 상태에 대해 증명되어야 하는 단일의 중요한 목표. 제한된 반복이 필요하면 미션/목표 실행으로 라우팅하고, 한 번의 신중한 패스로 충분하면 단일 패스 모드를 사용하세요(아래 모드 포크 참조).
디자인 빠른 경로 사용 시기
- "루프 설계", "루프 구축", "새 루프", "루프 마법사", 또는 모호한 반복 작업 자동화
- 결과 오케스트레이션 없이 루프 청사진(명세 + 아티팩트)만 필요한 경우
- 2단계(의사 결정 게이트 → 마법사 → 아티팩트 생성)로 바로 이동한 후 중단
사용하지 말아야 할 경우
- 사소한 일회성 답변, 빠른 편집, 대화형 질문 → 도구 없이 한 번 잘 수행하세요. (단, 실질적인 일회성 목표는 여전히 증명이 필요합니다. 사소하지는 않지만 반복되지 않는 경우 아래 미션/목표 실행 또는 단일 패스로 라우팅되며, Looptimal을 완전히 건너뛰는 이유가 아닙니다.)
- 전달 의무가 없는 분석 → 직접 답변하거나 esat을 사용하세요.
- 되돌릴 수 없고 판단이 중요한 작업으로, GO 게이트를 담당할 사람이 없는 경우 → 인간 게이트 프로세스를 권장합니다.
- 메타 루프("Looptimal을 실행하여 Looptimal을 검증", "Looptimal이 GREEN이라고 말할 때 자동 병합") → Design-loop는 반드시 REJECT해야 합니다.
- 행동 결과 오라클 없이 증상 기반의 성공 지표만 있는 경우 → 재구성(Frame)하거나 REJECT하세요.
운영 규칙 (먼저 읽으세요)
- 이는 스킬이며, 페르소나나 모드가 아닙니다. 하나의 활성화 라인으로 시작한 후 작업을 수행하세요.
- 체크포인트 게이트: Frame → Analyze → Design-loop / Route → Plan → Simulate 각 단계에서 간단한 상태를 보고합니다. Simulate 이후 명시적인 인간 GO가 없으면 Execute는 절대 시작하지 않습니다. 또는 단일 패스 모드에서는 Analyze/Design-loop/Plan/Simulate 체크포인트를 대체하는 간단한 사전 검토(아래 모드 포크 참조) 후에 시작됩니다.
- 돌이킬 수 없는 작업을 자동 실행하지 마세요: 프로덕션 배포, 전송, 결제, 자격 증명 교체, 데이터 삭제 — 작업 전 인간 게이트만 허용됩니다.
- 하네스 분리:
./.looptimal/profile.yaml→~/.looptimal/profile.yaml→scripts/looptimal-detect.py→ 일반 기본값 순서로 바인딩을 확인하세요. 계약:references/agent-foundry.md
활성화 라인 예시:
- 전체 파이프라인: "Looptimal — 이 목표를 봉인된 결과 루프로 프레이밍합니다."
- 디자인 빠른 경로: "Looptimal — 이 루프의 청사진을 생성합니다."
- 단일 패스: "Looptimal — 루프 없이 한 번의 검증된 패스입니다."
- 빈 상태로 호출된 경우 (목표 없음): 정확히 하나의 질문을 하세요 — "완료되었을 때 어떤 결과가 참이어야 합니까?" — 그런 다음 아래 모드 포크를 따르세요.
- 목표가 이미 주어진 경우: 한 줄로 확인한 후 아래 모드 포크를 따르세요.
모드 포크 (Frame 이전 — 한 번, 저렴하게 질문)
Looptimal의 루프 가치 판단은 의사 결정 게이트(아래 마법사의 1단계)이지만, 현재는 Frame과 Analyze가 이미 실행된 후인 2단계 깊숙이에서만 실행됩니다. 대신 이러한 작업이 시작되기 전에 형태를 결정하세요.
- 문구가 이미 명확한 경우 — 질문 생략:
- 디자인 빠른 경로 트리거 단어("루프 설계", "루프 구축", "청사진", "루프 마법사") → 2단계로 직접 이동.
- 명시적인 일회성 언어이면서 유용한 재시도를 배제하는 경우("단일 패스", "한 번의 신중한 패스", "재시도 루프 불필요") → 단일 패스로 직접 이동.
- 가능한 검증기/재시도 작업이 있는 명시적인 일회성 전달 언어("일회성", "X를 한 번만 수행", "이것을 한 번 빌드/수정/출시") → 의사 결정 게이트가 미션/목표 실행과 단일 패스 중에서 선택할 수 있도록 전체 파이프라인으로 이동.
- 명시적인 반복/주기 언어("야간", "모든 PR마다", "이것을 계속 업데이트", "지속적") → 전체 파이프라인으로 직접 이동.
- 그 외의 경우 — 0단계에 도달하기 전에 구조화된 세 가지 옵션 질문을 하나 하세요:
- 한 번 완료하고 증명 — 유용한 재시도 루프가 없는 단일 검증 결과 → 단일 패스.
- 미션 실행 또는 루프 구축 — 제한된(게이트까지 반복하는 미션/목표 실행 — 버그 수정, 사양 준수, 일회성 빌드) 또는 반복(일정/트리거에 따라 무기한 실행) → 전체 파이프라인(0단계 → 1단계 → 2단계; 의사 결정 게이트가 경로/아키타입을 선택 — 작업 / 반복 / 감독 / 지속적 래칫 / 오케스트레이션, 미션/목표 실행, 또는 하드 리젝트).
- 루프 청사진만 생성 → 디자인 빠른 경로(2단계만).
이렇게 하면 의사 결정 게이트가 이미 수행하는 동일한 루프 가치 판단을 사용자 자신의 판단으로, Analyze, Design-loop, Plan이 잘못된 형태에 소비된 후에만 도달할 수 있는 대신, upfront하고 저렴하게 표면화합니다(선택한 모드에 관계없이 Frame은 실행되므로 낭비되지 않습니다). 0/1단계의 증거가 선택한 모드와 나중에 모순되는 경우 — "단일 패스" 목표가 명확히 반복되거나 게이트까지 반복이 필요한 것으로 밝혀지거나, "반복 시스템"이 의사 결정 게이트에서 살아남지 못하는 경우 — 이를 분명히 말하고 사용자가 방향을 바꾸도록 하세요. 절대 사용자의 선택을 조용히 재정의하지 마세요. 증거가 지원하지 않는 모드를 조용히 준수하지 마세요.
바인딩 확인 (0단계 서문)
python3 scripts/looptimal-detect.py # 마커 검사; 프로필 제안
# 또는 ./.looptimal/profile.yaml → ~/.looptimal/profile.yaml 읽기
state_dir, dispatch.maker, dispatch.checker, verifier.default, 선택적 banner를 제공합니다. 일반 기본값: loops/<slug>/, 셸 검증기.
8단계 파이프라인
| 단계 | 이름 | 작업 | 참조 |
|---|---|---|---|
| 0 | Frame | 목표를 해시 고정된 봉인된 승인 스위트로 전환합니다. 모든 기준은 결과(증상이 아님)를 주장하고 도메인 결과 오라클을 바인딩합니다. 입력은 제작자가 쓸 수 없습니다. acceptance-suite.yaml + acceptance-suite.sha256을 출력합니다. | references/pipeline.md |
| 1 | Analyze | 역량 매니페스트 및 로컬 역량 준비 인벤토리를 생성합니다: 도메인, 통합 맵, 위험, 종속성, 사용 가능한 스킬/플러그인/커넥터/MCP/에이전트/데이터. 삼중 모델 스트레스 테스트가 필요할 경우 esat에 심층 정의 작업을 위임합니다. | references/pipeline.md |
| 2 | Design-loop / Route | 루프 설계 마법사를 실행하거나 목표를 라우팅합니다. 아키타입 선택 — 작업(제한된 전달), 반복(예정된 신선도 유지), 감독(가드레일 내 자율), 지속적 래칫(각 패스가 결과 메트릭을 엄격히 개선), 오케스트레이션(다중 에이전트/다중 저장소), 미션/목표 실행, 단일 패스 — 또는 하드 노-검증기/메타-루프/증상 전용 케이스에 대해서만 REJECT. | references/pipeline.md |
| 3 | Plan | 합의 작업 그래프를 구축합니다: 노드, 종속성, 봉인된 스위트에 연결된 작업별 승인 훅, 블래스트 반경 태그, 롤백 노트. | references/pipeline.md |
| 4 | Simulate | 루프를 N단계 앞으로 롤링합니다; 사전 검토 실패 모드(보상 해킹, 암묵적 실패, 부분 완료, 환경 드리프트); 계획을 강화합니다. 봉인된 스위트에 대한 결과 및 변경 사항을 제시합니다(재해시 + 사용자 확인). | references/pipeline.md |
| — | Human GO | 실행에 대한 명시적 승인. 최상위 위험, 돌이킬 수 없는 작업, 미해결 종속성을 표면화합니다. GO 없음 → Execute 없음. | references/pipeline.md |
| 5 | Execute | 바인딩 프로필에 따라 동적 도메인 전문가 하위 에이전트를 생성합니다. 반복 게이트에서 제작자 ≠ 검증자. 재개 가능하고 멱등적인 단계; 부분 실패를 위한 롤백 경로. 돌이킬 수 없는 작업에 대한 작업 전 게이트. | references/pipeline.md |
| 6 | Verify-outcome | 별도의 검증자가 봉인된 스위트를 실제 상태에 대해 다시 실행합니다. 루프 자체 보고 GREEN은 무시합니다. 증거 번들로 게이트합니다. | references/pipeline.md |
| 7 | Persist | 내구성 있는 상태 기록: 목표 해시, 스위트 해시, 성공/실패한 항목, 오라클 결과, 수정 클래스, 재개 포인터, 다음 실행을 위한 교훈. | references/pipeline.md |
단계 전환 (기본값)
- 0 → 1: 봉인된 스위트가 존재하고, 모든 기준에 오라클이 있으며, 해시가 기록됨.
- 1 → 2: 역량 매니페스트가 모든 중요한 도메인, 통합 에지 및 로컬 역량 준비 상태를 포함함.
- 2 → 3: 아키타입 또는 미션 경로가 선택됨(또는 정직한 대안과 함께 하드 REJECT 발행됨).
- 3 → 4: 작업 그래프가 비순환적이며, 모든 노드가 스위트 기준에 연결되고, 안전 제한이 설정됨.
- 4 → GO: 시뮬레이션 보고서가 전달됨; 계획이 강화됨; 돌이킬 수 없는 작업에 태그 지정됨.
- GO → 5: 명시적 인간 승인이 상태에 기록됨.
- 5 → 6: 제작자가 반복 완료를 선언함 — 정보 제공용; 검증자가 진실을 소유함.
- 6 → 7: 증거 번들이 GREEN임; 그렇지 않으면 수정 클래스 및 재개 포인터와 함께 FAIL.
재개
state_dir 아래에 이전 실행이 존재하고 목표 해시가 일치하면, 마지막 미완료 단계부터 재개합니다. 목표가 실질적으로 변경된 경우, 재프레임(새 스위트 해시). 하드 REJECT 후에는 새로운 Design-loop / Route 없이 재개하지 마십시오.
2단계 — Design-loop / Route 마법사
마법사는 네 가지 원자 단위를 강제하고, 경로 의사 결정 게이트를 실행한 다음 분기합니다. 재사용 가능한 루프 경로는 전체 LoopPrint 아티팩트 패키지를 생성합니다. 미션/목표 실행 경로는 route.md + 미션 패키지(3단계 후 mission.yaml)를 출력하고 재사용 가능한 루프 스캐폴딩 없이 3단계 Plan으로 계속 진행합니다. 단일 패스 경로는 route.md와 간단한 사전 검토를 출력하고 단일 패스 저하 경로를 따릅니다. 전체 파이프라인의 2단계에 위치하며, design 빠른 경로로 독립 실행도 가능합니다.
마법사 진입
- 전체 파이프라인(2단계에서 호출): 목표는 0단계의 결과입니다. 0.5단계로 건너뜁니다.
- 디자인 빠른 경로(직접 호출): 하나의 활성화 라인으로 시작합니다. 목표가 주어지지 않은 경우, 먼저 하나의 질문을 합니다.
0.5단계 — 바인딩 확인
scripts/loopprint-detect.py를 실행하거나(또는 ./.loopprint/profile.yaml → ~/.loopprint/profile.yaml 읽기) state_dir, verifier.default, dispatch, marker_path, runner, banner를 가져옵니다. 일반 기본값: loops/<slug>/, verify.sh. 계약: references/profiles.md. 하네스 규칙을 하드코딩하지 마십시오.
1단계 — 의사 결정 게이트 (+ 경로)
references/decision-gate.md의 Tier-0 테스트를 실행합니다: 4가지 조건 + 30초 체크리스트. 조건당 한 줄의 추론과 함께 경로를 보고합니다. 반복은 전체 오케스트레이션 게이트가 아닌 재사용 가능한 루프 상각 테스트로 유지됩니다: 비반복적이지만 검증기가 지원하는 작업은 미션/목표 실행 또는 단일 패스로 라우팅될 수 있습니다. 외부 검증기/인간 체크포인트가 없거나, 목표가 자기 참조적/메타 루프이거나, 성공이 행동 앵커 없이 증상 기반인 경우 하드 REJECT가 필수입니다.
선택한 경로에 따라 즉시 분기합니다:
- 재사용 가능한 루프 경로: 2-6단계를 계속 진행하고, 루프 아키타입/프로필을 고정하고,
loops/<slug>/를 생성하고,loopprint-lint를 실행합니다. - 미션 / 목표 실행 경로: 루프 프로필 또는 아티팩트 생성을 계속하지 않습니다. 드라이버, 상태 아티팩트, 검증기, 중지/예산, 자율성 수준, 준비 격차 및 재사용 가능한 루프 청사진이 생성되지 않는 이유와 함께
route.md를 출력합니다; 그런 다음 3단계 Plan으로 계속 진행하며, 이 단계에서mission.yaml,task-graph.yaml,execute-scope.yaml및looptimal-lint.txt를 출력합니다. - 단일 검증 패스 경로: 루프 프로필 또는 아티팩트 생성을 계속하지 않습니다. 검증기, 상태 아티팩트, 중지, 준비 격차 및 3가지 시나리오의 간단한 사전 검토와 함께
route.md를 출력합니다; 그런 다음 3/4단계 대신단일 패스저하 경로를 따릅니다. - 인간 게이트 워크플로 경로: 인간 체크포인트 및 외부 검증기와 함께
route.md를 출력합니다; 그런 다음 해당 게이트와 일치하는 감독 경로를 통해서만 계속 진행합니다. - 하드 REJECT: 검증 불가능/안전하지 않은 이유 및 정직한 대안과 함께
reject.md를 출력합니다; 사용자가 목표를 재구성하지 않으면 중지합니다.
2단계 — 재사용 가능한 루프 목표 개선
3~5개의 타겟 질문(그 이상 아님)을 합니다:
- 날카로워진 목표 — 한 문장, 테스트 가능.
- 반복 / 빈도 — 재사용 가능한 루프가 상각됨을 확인.
- 검증 방법 — 어떤 외부 신호가 반복이 성공했음을 나타내는가?
- 돌이킬 수 없는 위험 — 무엇이 되돌릴 수 없는가? (→ 인간 체크포인트)
- 자율성 수준 — 완전 자율, 체크포인트 게이트, 또는 드라이 런?
3단계 — 재사용 가능한 루프 원자 단위 강제
각 원자에 대해 구체적인 값을 강제합니다. 모호한 상태로 진행하지 마십시오:
- 목표 — 2단계의 한 문장 목표.
- 상태 — 바인딩의
state_dir에서의 내구성 있는 아티팩트 경로; 기록 내용: 시도 로그, 실패한 항목, 현재 가설, 컨텍스트. - 검증기 — 정확한 외부 명령어 또는 지명된 검토자. 제안된 유일한 검사가 동일한 에이전트의 자체 평가인 경우, 거부하고 실제 게이트를 찾으십시오. 제작자 ≠ 검증자.
- 중지 — 성공 기준 및 안전 제한(최대 반복 횟수, 토큰/시간 예산, 명시적 중단). 안전 제한 없이 루프가 출시되지 않습니다.
4단계 — 재사용 가능한 루프 프로필 선택
아키타입의 전체 프로필을 고정합니다 — 작업 패턴(references/patterns.md에서) 및 검증기/중지 형태:
- MORTY — 특정 버그; 검증기 = 재현 테스트; 재무/시간 예산에 도달 시 중지.
- FRIDAY — 데이터 신선도; 검증기 = 스냅샷 차이 또는 만료 검사; 누락된 업데이트 또는 고정 예산 초과 시 중지.
- RACHEL — 자율 정찰/감사; 검증기 = 인간 검토 또는 증거 패키지; 위험 임계값 초과 시 중지.
- GROOT — 다중 도메인 오케스트레이션; 검증기 = 엔드-투-엔드 승인 스위트; 서브 에이전트 타임아웃 또는 예산 초과 시 중지.
- TONY STARK — 지속적 개선 래칫; 검증기 = 이전 실행과의 차이로 측정된 래칫 메트릭 엄격 개선; 회귀 또는 정체 현황 시 중지.
5단계 — 재사용 가능한 루프 아티팩트 생성
loops/<slug>/ 아래에 패키지 생성:
loops/<slug>/
├── loop.yaml # 목표, 상태, 검증기, 중지, 프로필, 일정
├── acceptance-suite.yaml # 0단계에서 복사 + 조정됨
├── verify.sh # 교체 가능 — 기본값은 봉인된 스위트 실행
├── dispatch.yaml # 제작자 바인딩(하네스 바인딩 재정의 가능)
├── runner.sh # 드라이버: 루프 실행 → 중지 확인 → 재시도
├── iterations/ # 시도 로그 (자동)
└── profile.lock.yaml # 해결된 바인딩 스냅샷
6단계 — Lint (loopprint-lint)
scripts/loopprint-lint.py를 실행하여 구조, 일관성, 네 가지 원자 단위 적용 여부를 확인합니다. 수정 또는 REJECT. 경고는 허용되지만 Lint 실패는 게이트를 유지합니다.
단일 패스 저하 경로 (루프 없음)
단일 패스는 파이프라인 축소 + 검증된 전달입니다. Frame은 0단계로 유지됩니다. 승인 스위트가 존재하며 여전히 봉인됩니다. 그러나 Analyze, Design-loop, Plan, Simulate, Human GO 단계는 경량 사전 검토로 대체됩니다:
- Frame (0단계) — 평소대로 실행하고 해시 고정.
- Light pre-mortem — 3가지 실패 시나리오(환경 스냅샷 오류, 부분 완료, 승인 스위트 불일치)를 적고 완화 조치를 기록합니다. 봉인된 스위트에 대한 변경 사항이 있으면 프레이머에게 되돌립니다.
- Execute — 제작자가 봉인된 스위트에 대해 작업합니다. 상태를 스트리밍하고, 모든 작업 후 승인 훅을 호출하며, 실패 시 멱등성 재시도를 허용합니다. 돌이킬 수 없는 작업을 표시합니다.
- Verify-outcome (6단계) — 평소대로 실행(별도 검증자, 라이브 상태에 대한 봉인된 스위트). 녹색/빨강 및 증거 번들.
- Persist (7단계) — 평소대로 실행.
단일 패스가 실패하면(Verify-outcome이 FAIL을 반환), 사용자에게 실패 진단(스위트 기준 불일치, 예상치 못한 환경 상태, 부분 완료)을 제시하고 재시도, 미션/목표 실행으로 에스컬레이션, 또는 수동 개입을 선택하도록 합니다. 자동 재시도는 없습니다. 루프가 없습니다.
참조
| 문서 | 내용 |
|---|---|
references/pipeline.md | 8단계 파이프라인 상세, 단계 전환 규칙, 재개 프로토콜 |
references/decision-gate.md | Tier-0 의사 결정 테스트(4 조건 + 체크리스트), 경로 선택, REJECT 조건 |
references/patterns.md | 루프 아키타입 전체 설명(MORTY, FRIDAY, RACHEL, GROOT, TONY STARK) |
references/profiles.md | 바인딩 프로필 계약: 검색 순서, 키, 기본값 |
references/agent-foundry.md | 에이전트 파운드리 통합 계약 및 하네스 계약 |
기술 스택 참고 사항
- **Python 3.9+**가 필요합니다(
scripts/아래의 감지 및 린트 스크립트용). - 상태는 로컬 파일 시스템(
state_dir)에 기록됩니다 — 외부 상태 저장소는 없습니다. - 검증기 프로토콜: 종료 코드 0 = GREEN, 0이 아닌 경우 = FAIL. STDOUT/STDERR은 증거 번들의 일부입니다.
- 마커 감지는 모든 루트에서
LOOPTIMAL_MARKER파일을 찾습니다(기본값:.looptimal/marker).
라이선스
Apache 2.0 — 라이선스를 참조하세요.
작성자
Renn Labs — https://renn-labs.com