ADR 생성 명령

사용자 입력

$ARGUMENTS

사용자 입력이 비어있지 않다면 반드시 고려해야 합니다.

개요

1. •

   사용자 입력 파싱:

   • •$ARGUMENTS에서 결정 주제 추출
   • •ADR 슬러그 생성 (2-4 단어, 영문, 하이픈 구분)
2. •

   맥락 수집:

   • •대화 이력과 사용자가 태그한 파일을 맥락으로 활용
   • •analysis.md가 태그되었으면: 결정, 선택지, 근거 추출 (증류, 복제 아님)
3. •

   기존 ADR 스캔:

   • •docs/decisions/ 파일명을 읽어 다음 번호 결정
   • •기존 ADR 프론트매터를 확인하여 중복 방지 또는 대체할 ADR 식별
4. •

   ADR 문서 작성:

   • •docs/decisions/NNNN-slug.md 생성 (한글)
   • •analysis.md 기반이면: 증류(distill) — 결정과 근거만 추출, 전체 복사 금지
   • •단독 호출이면: 대화 맥락에서 작성
5. •

   상호 링크 (해당 시):

   • •기존 ADR 대체 시: 이전 ADR 상태 갱신
6. •

   보고:

   • •생성된 파일 확인
   • •트리거된 PRICE 기준 표시

핵심 규칙

📝 문서 작성 언어

중요: ADR 문서는 한글로 작성해야 합니다. 기술 용어는 영문을 괄호 안에 포함할 수 있습니다.

📝 증류, 복제 아님

소스 자료(분석 문서, 대화)가 있을 때:

• •소스 = 상세한 분석이나 논의 (작업 범위)
• •ADR = 증류된 결정 기록 (0.5-1 페이지, 프로젝트 범위)
• •추출: 무엇을 결정했는가, 왜, 무엇을 포기했는가
• •소스 전체를 ADR에 복사하지 말 것

📝 번호 체계

• •0-패딩 4자리: 0001, 0002, ...
• •docs/decisions/에서 가장 높은 기존 번호 스캔
• •디렉토리 미존재 시 생성 후 0001부터 시작

📝 상태 값

• •수락됨 (Accepted) — 새 ADR 기본값
• •ADR-NNNN으로 대체됨 (Superseded by ADR-NNNN)
• •폐기됨 (Deprecated)

✅ 해야 할 것

• •구체적 맥락 포함 (추상적 설명 금지)
• •검토한 모든 선택지와 장단점 나열
• •수용한 트레이드오프 명시
• •버전 관리되는 출처 링크 (PR, 커밋, 다른 ADR) 가능 시 포함

❌ 하지 말아야 할 것

• •장황한 설명 — 1페이지 이내
• •소스 자료 통째로 복제
• •트레이드오프 생략 또는 단점 없는 척
• •사소한 결정에 ADR 생성 (rules/adr.md 제외 목록 참조)

문서 템플릿

생성할 파일: docs/decisions/NNNN-slug.md (한글)

---
status: 수락됨
date: YYYY-MM-DD
---

# ADR-NNNN: [제목]

## 맥락

[이 결정이 필요한 상황. 구체적 시나리오 포함.]

## 결정 요인

- [핵심 요인 1]
- [핵심 요인 2]

## 검토한 선택지

### 선택지 1: [이름]

- 장점: ...
- 단점: ...

### 선택지 2: [이름]

- 장점: ...
- 단점: ...

## 결정

[선택한 접근법]. [핵심 근거 1-2문장.]

## 결과

- 긍정적: ...
- 수용한 트레이드오프: ...

## 관련 문서

- [버전 관리되는 출처 — PR, 커밋, 다른 ADR 등]

실행

이제 위 지침에 따라 작업을 시작하세요.