91 lines
2.9 KiB
Markdown
91 lines
2.9 KiB
Markdown
# 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}/` 구조를 정본으로 한다.
|