Harness MultiAgent 허브

§08 · 학습 챕터

06. Approval · envelope

승인 · envelope · safe_to_apply

워커가 만든 결과를 바로 코드에 반영하지 않습니다. 승인·envelope·safe_to_apply 세 겹의 안전장치가 있습니다.

정본: _shared/approval-policy.md · AGENTS.md § Approval · runtime-route-matrix.md대상: 바이브코더 · 초급 개발자 (기술 용어 + 한글 설명 병행)
챕터 이동chapter-nav

이전·다음 챕터로 이동합니다. 본문은 아래 학습 블록 카드에서 펼칩니다.

이전

05. Workers · MCP / 워커 · MCP · call_worker

홈

Harness MultiAgent 2.1

다음

07 4 flavors

01. Harness Orchestrator02. Install · validate03. Folder 3 layers04. Task lifecycle05. Workers · MCP06. Approval · envelope07. Four flavors08. RUNBOOK09. KNOT · wiki10. KNOT · install11. KNOT · bridgeLAB · Phase · Run
전체 학습 블록 카드learn-blocks
학습 블록

workers_approved

승인 목록

_shared/approval-policy.md · AGENTS.md § Approval · runtime-route-matrix.md · 워커를 호출하기 전 task.md의 workers_approved에 이름을 적고, log.md에 [APPROVAL]로 기록합니다.

문서코드본문현재실습
학습 블록

Approval log format

[APPROVAL] 기록

_shared/approval-policy.md · AGENTS.md § Approval · runtime-route-matrix.md · [2026-06-10 14:31] [APPROVAL] user approved workers: codex (implement), gemini — scope: login API draft

문서코드본문실습
학습 블록

Envelope schema

envelope 포장

_shared/approval-policy.md · AGENTS.md § Approval · runtime-route-matrix.md · 워커 호출 결과는 stdout에 envelope JSON (schema v2)으로 반환됩니다. orchestrator가 result.md에 옮깁니다.

문서코드본문실습
학습 블록

Summary

(한 줄)

_shared/approval-policy.md · AGENTS.md § Approval · runtime-route-matrix.md · (한 줄)

문서코드본문실습
학습 블록

Artifacts

Artifacts

_shared/approval-policy.md · AGENTS.md § Approval · runtime-route-matrix.md · Artifacts

문서코드본문실습
학습 블록

Verification Checklist

Verification Checklist

_shared/approval-policy.md · AGENTS.md § Approval · runtime-route-matrix.md · Verification Checklist

문서코드본문실습
학습 블록

Envelope (JSON 블록)

Envelope (JSON 블록)

_shared/approval-policy.md · AGENTS.md § Approval · runtime-route-matrix.md · { "safe_to_apply": false, "worker_called": true }

문서코드본문실습
학습 블록

safe_to_apply

적용 게이트

_shared/approval-policy.md · AGENTS.md § Approval · runtime-route-matrix.md · 바이브코더 팁: 의심되면 false 유지 → “diff만 보여줘”라고 오케스트레이터에 요청.

문서코드본문실습
학습 블록

Cross-vendor critique

교차 검수

_shared/approval-policy.md · AGENTS.md § Approval · runtime-route-matrix.md · 다른 벤더 워커가 mode: critique로 리뷰합니다.

문서코드본문실습
학습 블록

External write four conditions

외부 repo 4조건

_shared/approval-policy.md · AGENTS.md § Approval · runtime-route-matrix.md · codex/claude가 tasks/<task>/ 밖에 쓰려면 네 가지 모두 충족 (AGENTS.md):

문서코드본문실습
학습 블록

Common mistakes

자주 하는 실수

_shared/approval-policy.md · AGENTS.md § Approval · runtime-route-matrix.md · 자주 하는 실수

문서코드본문실습
학습 블록

Checklist

체크리스트

_shared/approval-policy.md · AGENTS.md § Approval · runtime-route-matrix.md · 체크리스트

문서코드본문실습
선택 블록 본문block-detail

workers_approved

승인 목록

워커를 호출하기 전 task.md의 workers_approved에 이름을 적고, log.md에 [APPROVAL]로 기록합니다.

정본 발췌 (approval-policy.md)

workers_approved:
  - worker: claude
    mode: implement
    approved_at: 2026-06-10
    purpose: 메인 구현 및 설계
    approved_by: user
  - worker: codex
    mode: critique
    approved_at: 2026-06-10
    purpose: Orchestrator 산출물 교차 리뷰
    approved_by: user
  - worker: gemini
    mode: analysis
    approved_at: 2026-06-10
    purpose: 장문 문서 제3자 검토
    approved_by: user
규칙 한글
목록에 없으면 호출 금지
동일 task·동일 worker+mode 재호출 재승인 불필요
Orchestrator 내부 추론 worker 아님 → 승인 불필요
검증 실패 후 재시도 승인 범위 내 자동 허용

승인 요청 시 사용자에게 알릴 것

  1. 어떤 worker (claude | codex | gemini)
  2. mode — claude/codex: implement | critique · gemini: analysis (three-worker-roles.md)
  3. 목적 (한 줄)
  4. 예상 호출 횟수 (쿼터·비용)