Files
company-haness/org-os/04-architecture
..
2026-07-23 17:49:00 +09:00

04-architecture — 아키텍처 SoT (ADR·RFC·시스템 문맥·데이터 모델)

이 디렉터리는 **이 회사·이 제품의 실제 아키텍처 결정과 구조의 단일 원천(SoT)**이다. 일반 아키텍처 패턴 카탈로그가 아니라 우리 시스템이 실제로 어떻게 구성되고 왜 그렇게 결정됐는지를 담는다.

구조

04-architecture/
  adr/              # Architecture Decision Records (되돌릴 수 없는/큰 결정 + 근거)
  rfc/              # Request for Comments (제안·논의 중 설계)
  system-context/   # C4 system-context / 컨테이너 다이어그램 (D2 우선)
  data-model/       # 데이터 모델·스키마·소유권

규칙

  • 회사 특정 사실만. 아키텍처 방법론(C4·ADR 작성법 등)은 skill·role-working-methods에.
  • 다이어그램은 D2 우선({type: d2}), Mermaid는 폴백(CLAUDE.md diagram-craft).
  • 아키텍처 판단의 근거로 ADR/RFC 실물을 인용하면 E3+ 가능. 실물이 없으면 01-company/README.md의 confidence 상한(≤E2/Med)을 따른다.
  • 현재는 스텁: 실제 ADR/RFC가 쌓이기 전까지 "미확정 아키텍처 문맥".