create-architectural-decision-record은(는) 무엇을 하나요?
AI 최적화 의사 결정 문서화를 위한 아키텍처 결정 기록(ADR) 문서를 생성합니다.
개요
이 스킬을 사용하면 프로젝트 내에서 중요한 아키텍처 결정 사항을 표준화된 형식으로 기록할 수 있습니다. ADR은 결정의 맥락, 대안, 최종 선택, 그리고 그 결과를 명확하게 문서화하여 팀과 AI 시스템이 과거 결정을 이해하고 향후 결정을 내리는 데 도움을 줍니다.
사용 방법
- 명령 실행:
github/create-architectural-decision-record스킬을 호출합니다. - 결정 내용 입력: 문서화할 아키텍처 결정에 대한 정보를 제공합니다.
- ADR 생성: 템플릿을 기반으로 구조화된 ADR 문서가 생성되어 저장소에 추가됩니다.
지원 플랫폼
- GitHub 저장소
- Claude Code와 같은 AI 어시스턴트
템플릿 구조
생성되는 ADR 문서는 일반적으로 다음 섹션을 포함합니다:
- 제목: 결정의 요약
- 상태: 제안됨, 승인됨, 대체됨 등
- 맥락: 결정을 내리게 된 배경과 동기
- 결정: 내려진 구체적인 결정 사항
- 대안: 고려되었지만 채택되지 않은 옵션들
- 결과: 결정으로 인한 예상 효과와 영향
예시
# ADR-001: 마이크로서비스 아키텍처 채택
상태: 승인됨
맥락: 모놀리식 애플리케이션이 확장성과 유지보수에 문제를 겪음.
결정: 마이크로서비스 아키텍처로 전환하여 각 서비스를 독립적으로 배포 및 확장.
대안: 서비스 지향 아키텍처(SOA) 유지, 서버리스 전환.
결과: 배포 자유도 향상, 팀 자율성 증가, 초기 복잡성 증가.
주의 사항
- ADR은 간결하고 명확하게 작성되어야 합니다.
- 각 결정은 고유한 번호를 가져야 합니다.
- 필요시 결정을 업데이트하거나 대체할 수 있습니다.