# 06-agent-work — 계약·정책 (SSOT only)

org-os는 **SSOT(정의·계약)만** 남긴다. 이 폴더는 이제 **에이전트 협업의 규칙(계약 YAML)만** 담는다.
실제 **작업 산출물·런타임 상태는 프로젝트별 root 폴더**로 나갔다(아래).

## 계약 (정책 YAML — 규칙 바꿀 때만 수정)
| 파일 | 정체 |
|---|---|
| `collaboration-modes.yaml` | divergent(발산)/converge(수렴) 모드 규칙 |
| `governance-tiers.yaml` | light/standard/heavy 티어 + 인간 게이트 |
| `execution-policy.yaml` | pipeline·fan-out/collapse·synthesis-rehydration·병렬감사 |
| `collaboration-map.yaml` | 설계→구현 handoff + cascade + 그룹 간 협업 엣지 |
| `context-package-spec.yaml` | subagent 입력 계약(무엇을 주고 무엇을 금지) + design-brief |
| `report-templates.yaml` | 보고서 템플릿 + YAML→MD 렌더 매핑 |
| `design-brief-spec.yaml` | 디자인·비주얼 산출물의 제약층 계약 |
| `agent-operating-kpi.yaml` | 에이전트 운영 KPI·토큰 예산 정의 |

## 산출물·상태는 프로젝트 워크스페이스로 (org-os 밖)
생성물은 더 이상 여기 쌓이지 않는다. **현재 워크스페이스**(`.orgos-workspace` 또는 env `ORGOS_WORKSPACE`, 기본 `test-labs-documents`) 아래로 간다 — 훅은 `.claude/hooks/_workspace.py`로 경로를 해석한다.

```
<project>/                         # 예: test-labs-documents/, ca-tmpl/, _sandbox/
  completion-records/<wf>/*.report.yaml   # 에이전트 보고서 = SoT (불변, guard가 검증)
  completion-records/<wf>/*.md            # 대표용 렌더 (render_report.py 자동 생성)
  evidence/<wf>/*                         # 보고서가 source-uri로 인용하는 근거 자료 (지우면 evidence 깨짐)
  reports/INDEX.md, TOKENS.md             # 이 프로젝트 목차·토큰 대시보드 (자동 생성)
  state/                                  # workflow-state-registry·work-queue·evidence-ledger·token-ledger.jsonl
  slack-inbox/, slack-outbox/             # 알림 큐
  design-system/                          # (있으면) 그 프로젝트 디자인 시스템
```

## 보고서 불변식 (변함 없음)
- 경로는 `new_report.py --workflow <wf> --role <role>`로 발급 → 현재 워크스페이스의 `completion-records/<wf>/<role>-<UTCstamp>.report.yaml`.
- 한 번 쓴 `.report.yaml`은 **덮어쓰기·Edit 금지**(`guard_tools`가 `completion-records/*.report.yaml` 경로로 차단 — 위치 무관). 재작업도 새 파일로 감사 추적 보존.
- MD는 YAML의 파생 뷰(idempotent). `reports/INDEX.md`는 워크플로별 append-only 목차(`render_report.py --index`, 현재 워크스페이스 기준).
- 사람은 `<project>/completion-records/<id>.md`(또는 `reports/INDEX.md`)만 읽으면 된다. **YAML은 에이전트용, MD는 사람용.**