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는 사람용.