Files
company-haness/org-os/06-agent-work

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