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