ADR-lite 형식
모든 의사결정은 간결한 구조를 따라요:
| 섹션 | 설명 |
|---|---|
| 컨텍스트 | 이 결정이 필요한 이유 |
| 결정 | 무엇을 결정했는지 |
| 이유 | 가장 강력한 한 가지 이유 |
| 대신 | 고려한 대안(최대 3개) |
| 영향 | 결과와 영향을 받는 영역 |
복잡한 결정에는 확장 형식이 트레이드오프 섹션을 추가해요.
스마트 기능
대안 자동 추론
결정만 적어도 AI가 흔히 쓰이는 대안 1-2개를 추론해요:
/note-decide user 서비스에 PostgreSQL을 써요AI가 대신 MongoDB, MySQL 을 추가해요 — 데이터베이스 선택에서 흔한 대안이기 때문이에요.
의사결정 체인
기존 의사결정 메모를 검색해요. 새 결정이 옛 결정을 대신하면 “대체” 링크를 만들어요:
대체: "user 서비스에 MongoDB 사용" (2월 10일)이렇게 거슬러 올라가 추적할 수 있는 의사결정 히스토리가 쌓여요.
중복 감지
새 메모를 만들기 전에 /note-decide가 관련된 이전 결정을 검색하고, 비슷한 결정이 이미 있으면 알려줘요.
제목 가이드라인
좋은 제목은 실행 가능하고 구체적이에요:
- “인증에 JWT 사용” (단순한 “인증”이 아니라)
- “Fly.io에 배포” (단순한 “배포”가 아니라)
- “REST에서 GraphQL로 전환” (단순한 “API”가 아니라)
/note-decide를 언제 쓰나요
무엇을 골랐는지뿐 아니라 왜 그것을 골랐는지 기록하고 싶을 때 써요. 의사결정 로그는 다음과 같은 상황에서 진가를 발휘해요:
- 새 팀원이 “우리가 왜 이렇게 했죠?”라고 물을 때
- 몇 달 뒤에 결정을 다시 검토해야 할 때
- 아키텍처가 어떻게 발전해 왔는지 추적하고 싶을 때