도메인 모델링
설계 과정에서 프로젝트의 도메인 모델을 능동적으로 구축하고 개선하세요. 이는 능동적인 훈련입니다. 용어에 도전하고, 경계 사례 시나리오를 발명하고, 용어가 구체화되는 즉시 용어집과 결정을 기록하는 것입니다. (단순히 CONTEXT.md를 읽어 어휘를 파악하는 것은 이 스킬이 아닙니다. 그건 어떤 스킬도 할 수 있는 한 줄짜리 습관입니다. 이 스킬은 모델을 변경할 때 사용하는 것이지, 단순히 소비할 때가 아닙니다.)
파일 구조
대부분의 저장소는 단일 컨텍스트를 가집니다:
/
├── CONTEXT.md
├── docs/
│ └── adr/
│ ├── 0001-event-sourced-orders.md
│ └── 0002-postgres-for-write-model.md
└── src/
루트에 CONTEXT-MAP.md가 존재하면 저장소에 여러 컨텍스트가 있는 것입니다. 맵은 각 컨텍스트가 어디에 있는지 가리킵니다:
/
├── CONTEXT-MAP.md
├── docs/
│ └── adr/ ← 시스템 차원의 결정
├── src/
│ ├── ordering/
│ │ ├── CONTEXT.md
│ │ └── docs/adr/ ← 컨텍스트별 결정
│ └── billing/
│ ├── CONTEXT.md
│ └── docs/adr/
파일은 작성할 내용이 있을 때만 게으르게(lazily) 생성하세요. CONTEXT.md가 없으면 첫 번째 용어가 결정될 때 생성합니다. docs/adr/가 없으면 첫 번째 ADR이 필요할 때 생성합니다.
세션 중
용어집에 도전하기
사용자가 CONTEXT.md의 기존 용어와 충돌하는 용어를 사용하면 즉시 지적하세요. "용어집은 '취소'를 X로 정의하고 있지만, 당신은 Y를 의미하는 것 같습니다 — 둘 중 무엇입니까?"
모호한 언어 정제하기
사용자가 모호하거나 과부하된 용어를 사용하면 정확한 표준 용어를 제안하세요. "'계정'이라고 말씀하시는데, 고객(Customer)을 의미하나요 아니면 사용자(User)를 의미하나요? 이 둘은 다른 것입니다."
구체적인 시나리오 논의하기
도메인 관계가 논의될 때, 구체적인 시나리오로 스트레스 테스트하세요. 경계 사례를 탐색하고 사용자가 개념 간의 경계를 정확하게 설명하도록 강제하는 시나리오를 발명하세요.
코드와 상호 참조하기
사용자가 무언가의 작동 방식을 말할 때 코드가 동의하는지 확인하세요. 모순을 발견하면 표면화하세요: "코드는 전체 주문을 취소하지만, 방금 부분 취소가 가능하다고 말씀하셨습니다 — 어느 것이 맞습니까?"
CONTEXT.md 인라인 업데이트하기
용어가 결정되면 바로 그 자리에서 CONTEXT.md를 업데이트하세요. 일괄 처리하지 말고 발생하는 대로 캡처하세요. CONTEXT-FORMAT.md의 형식을 사용하세요.
CONTEXT.md에는 구현 세부 사항이 전혀 없어야 합니다. CONTEXT.md를 명세서, 스크래치 패드, 또는 구현 결정 저장소로 취급하지 마세요. 용어집 그 이상도 이하도 아닙니다.
ADR은 드물게 제공하기
다음 세 가지가 모두 참일 때만 ADR 작성을 제안하세요:
- 되돌리기 어려운 경우 — 나중에 마음이 바뀌는 데 드는 비용이 의미 있는 경우
- 맥락 없이 놀라운 경우 — 미래의 독자가 "왜 이렇게 했지?"라고 궁금해할 경우
- 실제 트레이드오프의 결과인 경우 — 진정한 대안이 있었고 특정 이유로 하나를 선택한 경우
세 가지 중 하나라도 빠지면 ADR을 건너뛰세요. ADR-FORMAT.md의 형식을 사용하세요.