init: company-haness 설계

2026-07-23 17:49:00 +09:00
parent 57d1bab894
commit f668d6a158
962 changed files with 98989 additions and 1 deletions
@@ -0,0 +1,90 @@
+# 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}/` 구조를 정본으로 한다.