CARGO / 검토 문서

공개 정제 전문 / 원문 기준 2026-11-16 / 플랫폼 미구현

이 문서는 당시 기획 검토 기록입니다. 문서의 ‘웹 제작 승인 전·공개 금지’ 상태는 이번 임시 검토 웹에 한해 후속 승인으로 대체됐습니다. 사업·실제 플랫폼·유료 생성·발행은 미승인/미검증 상태를 유지합니다. 원문 캡처·내부 위치·협업/계정 식별자와 실행 예시는 공개하지 않습니다.

← 검토 허브통합 검토본10분야·근거
이 문서 목차

Lane 05 — 콘텐츠 제작 하네스 아키텍처 독립 감사

결론

현재 산출물은 콘텐츠 제작 공정의 설계안과 브라우저 내 정적 시연이며, production control plane/runner 구현이 아니다. 설계 방향(제작자·비평자 분리, 인간 승인, 파일 계약, 생성 API와 에이전트 분리, 피드백의 사람 승인 승격)은 타당하다. 그러나 실제 운영 전에 임대 만료 후 Git 쓰기 차단, 버전 고정 승인, Git·DB·에셋 간 확정 프로토콜, 외부 유료 호출의 불명확 결과 복구가 먼저 정해져야 한다.

가장 중요한 판정:

  1. complete에서 만료 lease를 409로 거절해도, 러너가 그 전에 이미 job 브랜치에 push하므로 오래된 실행의 오염을 막지 못한다.
  2. approve = merge에는 승인 대상 버전·내용 해시·입력 묶음·정확한 브랜치 head가 없다. 다른 사람이 수정한 새 버전이나 승인하지 않은 파일이 병합될 수 있다.
  3. job 브랜치 수정 → main feedback 추가 → DB 갱신 → 다음 태스크는 하나의 트랜잭션이 아니다. 기존 검수의 ‘반영’은 문구 보강이지 이 원자성의 해결이 아니다.
  4. ‘DB는 색인이고 성과만 원본’이라는 설명과 lease/큐/attempt/비용·시간의 내구성 요구가 맞지 않는다. 콘텐츠 원본과 운영 상태 원본을 구분해야 한다.
  5. 모든 단계 최소 두 에이전트 원칙은 유지할 수 있다. 비용 절감은 이를 없애는 대신 직렬 maker→critic, 제한된 병렬 후보 생성, 한 후보당 제한된 재생성, 차등 입력·검수 범위, 재사용 가능한 고정 컨텍스트로 한다.

1. 감사 범위·증거 수준

2. 콘텐츠 제작 하네스 ≠ 개발 에이전트 하네스

구분 콘텐츠 제작 하네스 — Cargo 운영 제품 개발 에이전트 하네스 — Cargo를 만드는 도구
목적 글감→근거→비트→컷→이미지→영상→편집본→발행의 품질·비용·권리·승인 관리 API·웹·runner·schema를 구현하고 테스트·리뷰·릴리스
작업 단위 콘텐츠 job, stage, 후보, 시도, 산출물 버전, 승인 묶음 기능/이슈, 코드 diff, 테스트, PR
완료 증거 검증된 매체·출처·편집명세·승인·발행 영수증 테스트 통과와 코드 리뷰, 배포 검증
Git 의미 canon/wiki/harness 정의와 승인된 콘텐츠의 불변 근거 소스 변경 및 개발 세션 인수인계
에이전트 권한 자료 읽기와 제한된 제안 파일 출력. canonical 쓰기·결제·발행 권한 없음 별도 개발 환경에서만 코드 수정·테스트 명령 가능
핵심 실패 중복 과금, stale 승인, 오래된 캐릭터 시트, 중복 발행, 누락된 수정 사유 미완성 기능, 테스트 약화, 세션 단절, 빌드 회귀

Claude/Codex 같은 같은 CLI를 사용한다고 두 하네스가 같은 것은 아니다. 특히 콘텐츠의 Codex가 조립을 맡는다(B1224–1230)는 것을 ‘매 job에서 새 프로그램을 만들어 실행해도 된다’로 해석하면 안 된다. 최소 운영형은 에이전트가 검증 가능한 편집명세를 제안하고, runner가 고정된 렌더러·도구 allowlist로 실행하는 형태다. 콘텐츠 job에서 생성한 shell/코드/plugin을 자동 실행하지 않는다.

공식 자료에서 빌려올 것은 장기 실행의 명시적 진행 상태, 고정 완료 기준, 세션 간 인수인계와 실제 검증이지, 개발용 initializer/coding-agent 구조 자체를 제작 공정으로 복제하는 것이 아니다. Anthropic의 long-running 문헌은 웹앱 개발에 최적화된 예이며 다른 분야로의 일반화는 향후 방향으로 구분한다.[W1] workflow/agent 문헌은 미리 정한 코드 경로의 workflow와 LLM이 동적으로 도구·과정을 결정하는 agent를 구분한다. Cargo의 유료 호출·승인·발행은 전자여야 한다.[W2]

3. 핵심 발견 — 우선순위별

H01 — 높음: lease는 completion만 막고 Git side effect는 막지 못한다

H02 — 높음: 승인과 수정에 stale-version 방어가 없다

H03 — 높음: Git·피드백·DB·큐 갱신이 원자적이지 않다

H04 — 높음: ‘DB는 재생 가능한 색인’으로 queue·lease·실행 원본까지 설명할 수 없다

H05 — 높음: provider 재시도는 at-least-once이며 중복 과금을 만든다

H06 — 높음: runner raw output을 canonical 신뢰 경계로 승격하는 검증이 부족하다

H07 — 중간~높음: ‘한 job에 한 task’와 fanout, 웹 수정의 동시성 모델이 불명확하다

H08 — 중간~높음: ‘단계 승인’과 A1~A3 묶음 승인 정책이 충돌한다

H09 — 중간: 재현성은 경로·CLI 버전·commit trailer만으로 확보되지 않는다

H10 — 중간: feedback→wiki 루프는 범위·충돌·오염 방어가 더 필요하다

H11 — 중간~높음: 발행은 산출물 제작과 다른 비가역 외부 side effect다

H12 — 중간: 취소·보류·에셋·백업 수명주기가 빠져 있다

4. 최소 계약 — 구현 전에 고정할 것

아래는 제안 계약이며 현재 파일에 구현돼 있다고 주장하지 않는다. lease 비밀을 공개 artifact나 Git에 저장하지 않는다.

계약 최소 필드 반드시 지킬 불변식
Job job_id, ip_id, brief/hypothesis, revision, pinned_harness_commit, input_bundle_digest, state, stage, budget_policy_id, created_by 승인·산출물·task가 같은 job/revision에 속함. 입력 변경은 새 revision.
Task task_id, job_id, stage, step, role, dependencies, expected_revision, input_refs+digest, output_contract, max_attempts, timeout 모델 텍스트가 아니라 서버 설정에서 역할·허용 경로·다음 전이를 결정. 동일 dependency set의 다음 task는 중복 생성 금지.
Attempt attempt_id, task_id, attempt_no, runner_id, fencing_epoch, lease_expires_at, status, started/ended, adapter/model versions, input_digest, output_digest, error_class, usage_ref heartbeat/assets/fail/complete 모두 같은 attempt/runner/epoch 확인. 한 task의 채택 결과는 하나. 실패/만료 이력은 덮어쓰지 않음.
ArtifactVersion artifact_id, version, job_id, kind, content_digest, immutable_uri, schema_version, producing_attempt/edited_by, input_digest, provenance, validation_state 검증된 immutable bytes만 참조. 버전 변경은 append-only. runner 제안과 채택 산출물을 분리.
Approval approval_id, gate, generation, job_revision, exact artifact version/digest set, selected_candidates, critique_refs, base_tree, policy_version, status, decided_by, decision_reason, operation_id approve는 정확히 본 bundle에만 유효. 바뀌면 superseded. 같은 세대에 terminal decision 하나. pending merge를 approved처럼 표시하지 않음.
ProviderOperation operation_id, attempt/candidate, provider+model, request_hash, idempotency_key_if_supported, request_id, state, reserved/actual_cost, receipt, output_refs intent 선기록. accepted/unknown을 단순 failed로 재전송하지 않음. provider별 quota·돈 상한.
FeedbackEvent feedback_id, operation_id, actor, action, artifact_from/to_version+digest, reason_tag, explanation, scope, timestamp, commit refs 수정과 사유는 한 logical operation. 중복 요청은 중복 사건 아님. 기각·kill도 남김.

권장 상태 분리:

waiting_external은 lease가 없어도 복구 가능한 durable provider operation을 가리켜야 한다. worker가 polling을 맡는다고 control-plane 생존 원본이 worker 메모리여서는 안 된다.

채택·승인의 최소 확정 흐름

  1. API가 인증·예상 revision·idempotency를 검사하고 pending operation을 내구성 있게 저장한다.
  2. runner는 고정 입력을 받아 격리 실행하고 raw 출력/로그/에셋을 proposal namespace에 올린다.
  3. 서버가 현재 epoch·입력·권한·schema·media·출처를 검증하고 adoption 명령을 만든다.
  4. Git writer가 expected ref와 operation ID로 정확한 파일 집합을 커밋한다. main feedback 기록과 콘텐츠 커밋 사이의 중간 상태는 journal로 추적한다.
  5. DB가 commit SHA를 확인하고 projection/완료 상태를 확정한다. outbox의 다음 task를 unique key로 내보낸다.
  6. 승인 시 동일하게 exact bundle을 대상으로 처리한다. 모든 확정 조건이 충족되기 전에는 approved/다음 유료 dispatch를 열지 않는다.
  7. 재시작 시 pending operation을 Git commit의 operation ID, 실제 에셋, provider 원장과 대조해 이어 간다. 추측으로 새 생성/새 발행하지 않는다.

5. 3인 팀의 최소 실현 구성

권장 토폴로지

> 공개 정제: 실행·코드 예시는 제외했습니다. 이 절의 계약 설명을 읽고, 구성과 흐름은 검토 허브를 참조하세요.

모든 단계 두 에이전트 이상을 보존하는 실행 배치

아래는 기존 역할을 유지한 최소 배치다. 생성 API는 에이전트 수로 세지 않는다. 사람 gate는 콘텐츠 생산 단계가 아니므로 별도다.

단계 보존할 agent 구성 비용·동시성 제어
글감 Grok·Claude 제안 → Codex 채점 두 제안자는 병렬, 정해진 후보 상한. judge는 합쳐 한 번.
시장성 Grok 수집 → Antigravity 근거 재열람 → Codex 리포트 의존관계는 직렬, 독립 URL 검증만 제한 병렬. 원문 snapshot 재사용.
canon·비트 Claude → Codex → 필요한 수정 직렬. 고정 canon과 diff 중심 비평.
컷 텍스트 Claude → Grok 직렬. 바뀐 컷 중심 비평하되 전체 훅·연속성 확인을 생략하지 않음.
컷 이미지 Claude prompt → GPT·Grok 이미지 → Antigravity 두 생성기 모두 유지. 컷/provider 동시 실행 상한과 fan-in, optional Higgsfield는 정책으로 명시.
키아트 Grok prompt → 두 이미지 생성기 → Antigravity+Claude 검사 두 심사 agent는 같은 고정 후보 묶음으로 병렬. 중복 생성 없이 검사 결과를 결합.
영상 Claude 지시 → Higgsfield → Antigravity 두 agent 유지. 작은 승인된 shot 집합부터, 후보별 재생성·돈 상한.
조립·검수 Codex 편집명세 → 고정 렌더러 → Claude 내용 검사 모델은 명세·비평, 반복 렌더는 모델 호출 없이 수행 가능. 수정된 shot의 영향 범위 재검사.
발행·측정 Codex 발행명세/리포트 → Claude 대조 두 agent 유지. 실제 publish는 adapter의 한 번의 외부 작업. 측정은 별도 durable schedule.
feedback 정리 Claude 규칙 초안 → Codex 충돌 검사 → 사람 고정 feedback snapshot으로 배치 실행, 동일 입력 digest의 결과 재사용.

‘둘 이상’은 동시 실행·동등한 대형 생성 두 번을 뜻하지 않는다. maker→critic의 직렬 분업도 충족한다. 다만 기존 GPT+Grok 동시 후보 요구를 비용 때문에 임의 삭제하거나, 두 모델의 상호 확인 없이 동일 모델 self-review로 바꾸지는 않는다. 모델/짝 변경은 원칙과 독립성·기능 계약을 충족하는지 별도 승인한다.

6. 최초 vertical slice의 통과 기준

4주 계획을 포기하라는 제안이 아니라, 다음을 실행 증거로 통과시키는 순서다. 현재 저장소에서 실행됐다는 뜻은 아니다.

  1. 텍스트 단계 하나의 완결: pinned input → maker → 독립 critic → 제한 revise → versioned human edit+사유 → stale approval 409 → exact bundle Git 확정. 저장/재시작해도 이어짐.
  2. 두 이미지 provider: 같은 승인 prompt/reference로 GPT와 Grok 후보를 모두 요청. 한 provider timeout·unknown·반려·지연을 주입하고 중복 과금 위험을 표시. 후보 및 두 agent 검수 provenance 보존.
  3. 영상 한 shot와 고정 조립: A2 bundle 입력만 사용. renderer가 agent code를 실행하지 않음. A3가 정확한 편집본·metadata digest에 묶임.
  4. 발행 rehearsal: 초기에는 명시적 수동 발행도 가능하되 release intent/원격 content ID/측정 schedule을 남김. 자동 publish를 켤 때 중복 방지·unknown 대사가 선행되어야 함.
  5. feedback 한 바퀴: 편집 사유→불변 digest 입력→Claude/Codex proposal→사람 merge→새 job에 정확한 wiki version 주입. 취향/단발 선례와 규칙을 구분.
  6. 실패 주입 acceptance: claim 직후/외부 호출 직후/업로드 직후/Git 확정 직후/DB 반영 직후 중단; lease 동시 획득; 늦은 complete; 중복 complete; 두 사람 edit/approve 경합; main ref 경합; disk-full; restore; quota 소진; hold/kill 중 provider 완료. 자동 복구 가능한 것과 수동 대사할 것을 구분.

검증 지표는 편당 비용·시간뿐 아니라 duplicate provider risk, unknown operation age, pending Git operations, stale result rejection, approval invalidation, human wait, schema/semantic rejection, 후보 수/편향까지 포함한다. provider 비용과 구독 비용을 섞지 말고 모델·후보·attempt·콘텐츠별 귀속을 남긴다.

7. 공식 문헌의 실제 열람 범위와 한계

외부 문헌을 현재 구현의 증거로 사용하지 않았다. 아래는 설계 원칙의 참고다. 원문 직접 추출은 Tavily quota 제한으로 실패했다. 사용 가능한 검색 fallback(Exa)이 반환한 공식 URL의 긴 본문 발췌를 실제 읽었다. 즉, ‘공식 문헌을 찾기만 함’과는 다르지만 live 원문 전체를 직접 열람한 것으로 보고하지 않는다. 별도 browser fallback에서는 주소 입력 결과가 요청과 달라 공유 브라우저 동시 조작 가능성을 확인해 추가 조작을 중단했다. 명령 실행 금지에 따라 curl/Python HTTP를 대체 실행하지 않았다. 이 lane의 ‘공식 2개 원문 live 전체 열람’ 요건은 제한 사항으로 남긴다.

출처 등록용 CLI/검증 스크립트 역시 명령 실행 금지 때문에 실행하지 않았다. [W1]/[W2]는 이 파일 안에서만 쓰는 출처 식별자이며 중앙 citation ledger의 숫자라고 주장하지 않는다.

최종 권고

기존 문서의 좋은 선택은 유지하되, 다음 문장으로 아키텍처 중심을 바꾸는 것이 최소 수정 방향이다.

> 콘텐츠 agent와 runner의 결과는 검증 전 제안이다. control plane이 버전 고정 입력, 단일 권위의 운영 상태, fenced attempt, 정확한 승인 bundle, 유료 side effect 원장을 갖고 canonical 채택을 통제한다. Git은 승인된 콘텐츠·규칙의 근거이고, Git commit 자체가 queue/과금/승인 트랜잭션을 대신하지 않는다.

이 계약이 없으면 어댑터 4종과 UI가 완성되어도 복구 가능한 제작 시스템은 아니다. 반대로 이 계약을 작은 vertical slice로 먼저 증명하면 총 3인·모든 단계 두 에이전트 요구를 유지하면서도 운영 복잡도와 불필요한 모델 호출을 줄일 수 있다.