로드 시점 / 건너뛰는 시점
- 로드: 개방형 작업, 기존 기준 없음; 결과를 생성한 주체가 아닌 다른 주체의 검증 필요; 다양한 도구를 가진 서브 에이전트 크루가 필요한 경우.
- 건너뛰기: 고정된 승인 기준이 명확히 정의된 작업(단순 실행); 사소한 작업; 시간 압박 상황 (크런치) — 목표를 추가하면 위험만 증가하며, '시간 압박 시 약속이 무너진다'는 가설은 아직 입증되지 않음.
- 이 문서는 트리거 패턴, Fast path, 상태 머신 상수 컨텍스트만 포함합니다. 나머지는 상태 머신 노드별로 로드됩니다(ADR-1/ADR-12).
Fast path (3분 버전)
- 첫 번째 동작 = 목표 컴파일러. 요청을 세 가지 구성 요소로 변환합니다 (자세한 내용은 chapters/01-goal-compiler.md 참조):
- 불변량: 작업(task)이 아닌 결과(outcome) (예: '충돌 수정' → '앱이 충돌 없이 실행되도록 유지');
- 검증기: CMD 형식의 반증 가능 명령어(명령어 + 예상 출력). 설명 텍스트나 자체 제작 검증기는 허용되지 않음. 누락된 항목은 명시적으로 표시하고 출처를 기재해야 함;
- 환경 명세: 원격 측정 액세스/버전 비교/재현 환경.
- 모든 하향 조정 결과(학습 목표 포함)는 반드시 이 컴파일러를 통해 재처리되어야 함 (ADR-2/ADR-7).
- 판사(Judge)의 최소 계층은 새로운 컨텍스트의 서브 에이전트 블라인드 리뷰입니다: 결과물만 보고, 수행자의 논리는 보지 않습니다. 핵심 인용문:
"I implore you to insist on outside validation. Ideally that's a tool the model can run to get feedback immediately." (번역: 외부 검증을 고수할 것을 간곡히 요청합니다. 이상적으로는 모델이 실행하여 즉시 피드백을 받을 수 있는 도구여야 합니다. — Felix Rieseberg, How to be more ambitious; research/ledger-a.md에서 확인됨)
- 두 개의 인간 체크포인트는 생략할 수 없습니다: 목표 확인, 최종 승인 (references/decision-checkpoints.md). 대리 조항: 수행자가 서브 에이전트이거나 인간이 루프에 없는 경우, 체크포인트는 지정 체인의 상위(지정자)가 대신 서명해야 하며, 주장 기록에 대리 서명자를 명시해야 합니다. 대리 서명자가 없으면 UNVERIFIED + 세 줄(QUERY/WHERE/RESULT)을 기록하고, 조용히 승인된 것으로 간주하지 않습니다.
- 플래그는 세 개뿐입니다 (O-1):
--quick(전체 프로세스 생략, 검증기 필드는 여전히 필수);--no-crew(크루 노드 건너뛰기);--judge=ctx-agent|tests|domain|human(판사 계층 지정). 조합 규칙: 세 플래그는 자유롭게 조합 가능합니다.--quick×--judge=: --quick은 프로세스 노드만 축소하고 --judge 지정 계층은 낮추지 않습니다. 지정 계층은 남은 노드에서 정상 실행되며, 실행할 수 없는 경우 관련 주장은 UNVERIFIED + 세 줄로 기록됩니다. 어떤 조합에서든 검증기 필드(CMD 형식)는 필수입니다.--no-crew는 비범위(non-range) 작업에서는 효과가 없습니다(no-op), 오류가 아닙니다.
상태 머신
프로세스: 컴파일 → 가정 검토 → 실행 → 판단 → 실패? 협약 → 완료 판정 → 크루(범위 작업 한정). 어떤 노드든 실패하면 먼저 chapters/06-failure-modes.md를 확인하세요.
| 노드 | 규칙 (앵커) | 노드별 로드 파일 |
|---|---|---|
| 컴파일 | 세 가지 구성 요소; 먼저 어려운 목표를 고정하고, '새로운 도메인이며 검증된 전략이 없음'이라는 질문이 참인 경우에만 학습 목표로 전환 (ADR-7) | chapters/01-goal-compiler.md; references/goal-setting-rules.md, references/prompt-compiler.md |
| 가정 검토 | 최대 3개의 가정, 각 가정마다 가장 저렴한 반증 방법; 전체 스토리 수준의 증거 | chapters/01-goal-compiler.md; references/assumption-audit.md |
| 실행 어조 | ADR-10 계층: 프로세스/승인 계층은 비계(scaffolding) 사용, 실행 스토리 계층은 공백; 단계 계층 수 제한 가능 (기본값 5, 경험적 값) | chapters/03-execution-voice.md; references/inner-game-voice.md |
| 사례 지원 | 장르별로 1-2개의 예제 검색; 선례 효과는 연료이지 방법이 아님; 검증 필드가 없으면 저장소에 추가할 수 없음 | chapters/05-evidence-cases.md; references/exemplars.md, references/story-calibration.md |
| 판사 | 4계층 사다리; 작업 유형 → 최소 계층 매핑 테이블; 판사 통과 기준과 수행자 완료 조건은 별도 단락으로 분리 (O-2); 픽스처(fixture) 우선 (ADR-11) | chapters/02-judge-ladder.md; references/claim-format.md, references/judge-tools.md, references/worked-example.md |
| 실패? 협약 | 귀인 재훈련 + 마이크로 성공 하위 단계, 둘 다 필수; 하위 단계 규모 설정 가능 (기본값 15분 상당, 경험적 값; ADR-8) | chapters/03-execution-voice.md; references/self-efficacy-sources.md |
| 완료 판정 | 소모 기반: 각 주장이 닫힐 때 (PASS/FAIL) 또는 명시적 UNVERIFIED + 세 줄 기록; 수량 임계값 없음 (ADR-5) | scripts/check_claims.py; references/claim-format.md |
| 인간 체크포인트 | 두 개는 생략 불가: ① 목표 확인 (컴파일 후, 실행 전) ② 최종 승인 (완료 후); 서브 에이전트는 대리 조항(Fast path 4)에 따름 | references/decision-checkpoints.md |
| 크루 | 범위 작업만 해당: 서브 에이전트 정의 파일에 세 가지 필수 항목 (도구/데이터/승인) + 예산, 재시도, 아티팩트 공유 계층; 역할극 방지 4단계 — "don't write like a short seller, do what a short seller does" (번역: 공매도처럼 글을 쓰지 말고, 공매도가 하는 일을 하라. — Rieseberg; research/ledger-a.md에서 확인됨) | chapters/04-range-crew.md; references/subagent-templates.md |
| 인용 규율 | 모든 SOURCE-URL은 원전으로 추적 가능해야 함; 인용은 원문 + 번역 + 출처를 모두 포함해야 함 | references/sources.md |
자체 점검
- Q 모든 목표가 <불변량 + CMD 형식 검증기 + 환경 명세> 세 가지 구성 요소로 컴파일되었는가? 검증기는 반증 가능한 명령어이지 설명 텍스트가 아닌가?
- Q 모든 판사 통과 기준이 별도 단락에 작성되었고, 수행자의 완료 주장을 참조하지 않으며, 매핑 테이블이 최소 계층을 할당했는가?
- Q 모든 주장이 5개 필드 기록(CLAIM, SOURCE, EVIDENCE, VERDICT, TRACE)을 가지고 있으며, VERDICT는 세 가지 값(PASS/FAIL/UNVERIFIED) 중 하나이며, 완료 시 닫히지 않은 항목이 없는가?
- Q 실패 후 귀인 재훈련과 원래 목표를 서비스하는 검증 가능한 마이크로 성공 하위 단계가 모두 완료되었는가 (둘 다 필수)?
- Q 모든 서브 에이전트 정의 파일에 도구, 데이터 소스, 승인 방식 세 가지 필수 항목이 있고, 예산 필드와 아티팩트 공유 상태 계층이 설정되었는가?
- Q 모든 인용 사례가 세 가지 구성 요소, 유효성, 세 가지 값 판정 필드를 가지고 있으며, 전설적인 수준의 사례는 보정 주석이 포함되어 있는가?