company-haness/org-os

Org OS Storage Contract

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

Directory Map

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}/ 구조를 정본으로 한다.