# Org OS Storage Contract

이 디렉터리는 AI 조직 운영체계의 공식 상태, 역할, 근거, 작업 산출물을 저장하는 기준 위치다.

## Directory Map

```text
org-os/
  packs/
    pack-index.yaml            # 사람이 관리하는 family→domain Pack/plane 소유권

  generated/                   # compile_orgos_registry.py 산출물(수기 수정 금지)
    role-registry.yaml
    family-registry.yaml
    method-registry.yaml
    architecture-index.yaml
    static-components.d2
    runtime-sequence.d2
    authority-swimlane.d2
    event-model.d2

  00-role-registry/
    roles.yaml
    drai-matrix.yaml
    state-transition-rules.yaml
    tool-permission-matrix.yaml
    role-selection-scorecard.yaml
    team-topology-map.yaml
    lens-registry.yaml
    capability-families.yaml

  01-company/
    vision.md
    strategy.md
    principles.md

  02-capabilities/
    capability-map.md
    value-stream-map.md

  03-products/
    {product-id}/
      pr-faq.md
      roadmap.md
      metrics.md

  04-architecture/
    adr/
    rfc/
    system-context/
    data-model/

  05-operations/
    slo/
    incident/
    postmortem/
    release-acceptance/

  06-agent-work/
    workflow-state-registry.yaml
    work-queue.yaml
    context-package-spec.yaml
    evidence-ledger.yaml
    agent-operating-kpi.yaml
    collaboration-modes.yaml
    governance-tiers.yaml
    execution-policy.yaml
    completion-records/
    blocked-reports/
    executive-packets/

  07-knowledge-base/
    playbooks/
    checklists/
    lessons-learned/
```

## Rules

- `00-role-registry`는 역할, 권한, DRAI, 상태 전이, 역할 선택 기준의 단일 원천이다.
- `packs/pack-index.yaml`은 family의 domain Pack/plane 소유권 원천이고, `generated/`는 그 컴파일 결과다.
- `team-topology-map.yaml`은 팀 토폴로지, C-Level 균형, EA 계층, Golden Path/SLO/Shift-left, GTM Revenue Stack 기준을 workflow routing에 연결한다(원천 분석 문서는 `role-profiles.yaml`·`team-topology-map.yaml`로 흡수됨).
- `06-agent-work`는 workflow 실행 중 계속 갱신되는 상태와 작업 기록의 단일 원천이다.
- Slack은 알림 채널이며 상태 원천이 아니다.
- 보고서 파일은 반드시 `workflow-id`, `task-id`, `role-id`, `report-id` 중 필요한 ID를 포함해 registry와 연결한다.
- 새 product, architecture, operation 문서는 먼저 관련 workflow-state 항목을 만든 뒤 저장한다.
- `lens-registry.yaml`는 12개 불가침 평가 렌즈의 단일 원천이며, 다양성 바닥을 정의한다.
- `capability-families.yaml`의 28개 family는 role planner 후보 metadata이며, 실제 인스턴스화 단위는 `roles.yaml`의 75개 concrete role이다.
- 협업 실행은 `collaboration-modes.yaml`(발산/수렴) × `governance-tiers.yaml`(light/standard/heavy)로 결정하며, TIER-HEAVY는 기존 DRAI 동작과 동일하다.
- `03-products` 표기는 이 README의 `{product-id}/` 구조를 정본으로 한다.