37 lines
2.8 KiB
Markdown
37 lines
2.8 KiB
Markdown
# 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는 사람용.**
|