DR-0012: 결정의 원본은 모두 atelier/에 두고, 작은 UX 결정은 UX 결정 모음 하나에 모은다

배경

2026-10-17에 결정 기록을 ADR과 DR로 나눴다(DR-0001). 그때 옮긴 것은 ADR 가운데 아키텍처가 아닌 열 개였다. docs/02-ux-design/05-ux-decisions(조작과 화면의 작은 결정 Q1~Q23)는 ADR이 아니라 그 범위 밖이었고, 같은 날 CLAUDE.md에 “조작과 화면의 작은 결정은 DR이 아니라 05-ux-decisions에 둔다”고 적었다. 작은 결정이 많아 하나마다 DR 파일을 두기 무겁고, 열린 물음을 방문자가 docs/에서 보게 하려는 까닭이었다.

그런데 같은 날 “docs/는 요구사항과 설계의 최종 결과다. 이력이 아니다”라는 기준도 정했다. 결정의 이력을 담은 05는 이 기준과 어긋났다. 또 2026-10-18에 정한 작은 결정(MD1~MD3, E1 · H1 · K1)은 05에 들어가지 않고 규칙 문서의 본문에 날짜 꼬리표로 흩어졌다.

메인테이너가 inbox에 물었다(2026-10-18): “우리가 05-ux-decisions은 왜 DR로 이동하지 않았지요? decision들의 위치를 한 군데로 모으는 것을 어떻게 생각하세요?”

결정 기준

  • 결정을 찾을 곳이 한 곳이다
  • docs/는 이력 없이 지금의 규칙과 열린 물음만 담는다
  • 작은 결정 하나를 적는 데 드는 손이 적다
  • ADR · DR 목록에서 큰 결정이 묻히지 않는다

검토한 대안

그림은 시안 M25에 있다: https://claude.ai/artifact/RjNNgjKPdLuKV2a6P4YJT2 (저장소의 사본 journal/assets/2026-10-18-decision-place-study.html)

대안 A: 모두 atelier/에. 작은 결정은 모음 파일 하나

  • 장점: 결정의 원본이 atelier/ 한 곳. docs/는 규칙과 미결정만
  • 단점: 05를 가리키던 링크와 열린 물음을 옮겨야 한다

대안 B: 작은 결정도 DR 하나씩

  • 장점: 결정이 모두 같은 모양
  • 단점: 파일이 40개쯤 늘고, 승인 뒤 본문을 고치지 않는 규칙이 작은 결정에 무겁다. 큰 결정이 목록에 묻힌다

대안 C: 그대로, 작은 결정은 늘 05에

  • 장점: 옮길 것이 가장 적다
  • 단점: 결정이 두 곳에 남고, “docs/는 이력이 아니다”와 계속 어긋난다

결정

대안 A. 메인테이너가 시안 M25의 D1에서 1번(추천)을 골랐다 (2026-10-18).

  • 결정의 원본은 모두 atelier/에 둔다: 아키텍처는 ADR(atelier/adr/), 그 밖의 큰 결정은 DR(atelier/decisions/dr-…), 조작과 화면의 작은 결정은 UX 결정 모음(atelier/decisions/ux-decisions.md)에 물음 하나에 한 항목씩.
  • docs/02-ux-design/05-ux-decisions를 UX 결정 모음으로 옮겼다. 그 안의 열린 물음(Q1, Q2, Q4~Q6, Q8, Q11, Q12, Q19, Q20, Q10의 남은 것)은 9. 미결정 사항으로 옮겼다. 열린 물음의 원본은 docs/다.
  • docs/의 규칙에 단 날짜 꼬리표(“(2026-10-18, 시안 M23의 MD1 1번)“)는 UX 결정 모음의 항목으로 가는 링크로 바꾼다. 앞으로도 그렇게 단다.
  • UX 결정 모음은 ADR · DR과 달리 항목을 고칠 수 있다. 다시 정하면 그 항목에 “다시 정함 (날짜)“과 까닭을 덧붙인다(지금까지 05에서 하던 대로).

결과

  • 좋아지는 점: 결정은 atelier/에서, 지금의 규칙과 열린 물음은 docs/에서 찾는다. docs/02-ux-design/는 문서 넷이 된다.
  • 감수하는 점: 세션 기록과 journal/의 옛 링크도 새 파일로 바꿨다(링크 80개, DR-0001과 같은 방식). 글자로 적힌 “05-ux-decisions”는 그때의 기록이라 고치지 않았다.
  • 2026-10-18 전에 docs/ 본문에 단 날짜 꼬리표(2026-10-15 등)는 이번에 고치지 않았다 → backlog