adr-writer
Installation
SKILL.md
ADR Writer
Paulo Merson 스타일의 간결한 ADR을 작성한다. 결정 자체보다 “왜 그렇게 결정했는지”를 명확히 남기는 데 집중한다.
워크플로우
-
기존 관례를 먼저 확인한다.
docs/adr,docs/decisions,adr,architecture아래의 ADR 파일을 찾는다.- 기존 파일이 있으면 번호, 파일명, 상태 값, 문서 언어, 제목 형식을 따른다.
- 관례가 없으면
docs/adr/NNNN-kebab-case-title.md를 기본값으로 사용한다.
-
결정 정보를 정리한다.
- 날짜: 기존 ADR 관례가 없으면 현재 날짜를
YYYY-MM-DD형식으로 기록한다. - 상태: 기본값은
제안됨; 사용자가 확정된 결정이라고 말하면승인됨을 사용한다. - 문제 상황: 어떤 문제나 제약 때문에 결정이 필요한가.
- 결정: 무엇을 하기로 했는가.
- 근거: 왜 이 선택이 적합한가.
- 대안: 검토했지만 선택하지 않은 대안은 무엇인가.
- 결과: 이 결정으로 얻는 것과 감수하는 것은 무엇인가.
- 날짜: 기존 ADR 관례가 없으면 현재 날짜를