Harness MultiAgent 허브

§10–11 · 학습 챕터

08. RUNBOOK

운영 runbook

하네스를 매일 쓸 때의 절차서와, (선택) MAT으로 task·워커 진행을 화면에서 보는 방법입니다. 영상 v2.0 마지막 장면처럼 “어디까지 갔는지”를 파일과 TUI로 동시에 확인할 수 있습니다.

정본: docs/operator-runbook.md · MAT · orchestrator-rules.md대상: 바이브코더 · 초급 개발자 (기술 용어 + 한글 설명 병행)
챕터 이동chapter-nav

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

이전

07. Four flavors / 4 flavor · 교차 검수

홈

Harness MultiAgent 2.1

다음

§09 KNOT · vault · bridge

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
학습 블록

Session start

세션 시작 체크리스트

docs/operator-runbook.md · MAT · orchestrator-rules.md · Orchestrator 세션을 열 때 작업 전 확인 (operator-runbook.md §1).

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

New task E2E

새 작업 시작

docs/operator-runbook.md · MAT · orchestrator-rules.md · 가이드: _templates/task-folder.md · operator-runbook.md §2.

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

Worker preflight

워커 호출 전 점검

docs/operator-runbook.md · MAT · orchestrator-rules.md · 30초 체크리스트 (operator-runbook.md §2 Step 4~5):

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

MAT tracker

MAT 모니터링

docs/operator-runbook.md · MAT · orchestrator-rules.md · MAT (Multi-Agent Tracker) = tasks/ 상태·worker 호출을 TUI로 보는 도구 (선택). upstream

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

Operator runbook

operator-runbook 정본

docs/operator-runbook.md · MAT · orchestrator-rules.md · 전문: docs/operator-runbook.md (또는 docs/learn/canonical/operator-runbook.md)

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

Incident response

장애 대응

docs/operator-runbook.md · MAT · orchestrator-rules.md · 에러는 log.md [ERROR]에 남기고, 가능한 범위까지 진행 (orchestrator-rules.md §3).

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

Baseline status

Baseline 완료 상태

docs/operator-runbook.md · MAT · orchestrator-rules.md · Baseline = “이 시점부터 학습·운영 기준” 표시. Hub 콘텐츠도 이 baseline에 맞춰 정렬.

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

Common mistakes

자주 하는 실수

docs/operator-runbook.md · MAT · orchestrator-rules.md · 자주 하는 실수

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

Checklist

체크리스트

docs/operator-runbook.md · MAT · orchestrator-rules.md · 체크리스트

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

Session start

세션 시작 체크리스트

Orchestrator 세션을 열 때 작업 전 확인 (operator-runbook.md §1).

환경

export MULTIAGENT_ROOT="/path/to/multi-agent-system"
cd "$MULTIAGENT_ROOT/.."
# 확인 기대
1 MULTIAGENT_ROOT 존재 AGENTS.md, _shared/backends.json
2 Interactive Cursor Agent 백그라운드·worktree 격리 아님
3 .cursor/rules/multi-agent-harness.mdc multi-agent-system/** 적용
4 validate (구조 변경 후) ALL PASS

진행 중 task 스캔

  1. tasks/*/task.md — status ≠ done 인 것
  2. 각 task 3파일: task.md · log.md · context.md
  3. orchestrator-rules.md §3 재진입 프로토콜

CLI PATH (worker 예정 시)

command -v claude && command -v codex && command -v agy && jq --version
bash "$MULTIAGENT_ROOT/_shared/adapters/call_worker.sh" --dry-resolve claude
bash "$MULTIAGENT_ROOT/_shared/adapters/call_worker.sh" --dry-resolve codex
bash "$MULTIAGENT_ROOT/_shared/adapters/call_worker.sh" --dry-resolve gemini