ADR (Architecture Decision Records) 아키텍처 결정을 문서화하여 "왜 그렇게 했는지"를 기록하는 스킬입니다. Core Principle "결정의 '무엇'보다 '왜'가 중요하다." "6개월 후의 나도 알아볼 수 있게 기록한다." ADR이 필요한 경우 | 상황 | 예시 | |------|------| | 기술 선택 | React vs Vue, PostgreSQL vs MongoDB | | 아키텍처 패턴 | Monolith vs Microservices | | 의존성 추가 | 새 라이브러리 도입 | | 보안 결정 | 인증 방식 선택 | | 성능 트레이드오프 | 캐싱 전략 결정 | | 표준 변경 | 코딩 컨벤션 변경 | ADR 폴더 구조 ADR 템플릿 실제 ADR 예시 ADR 작성 가이드 번호 체계 상태 흐름 - Proposed : 검토 중 - Accepted : 승인되어 적용 중 - Deprecated : 더 이상 유효하지 않음 - Superseded by ADR-XXXX : 새 결정으로 대체됨 작성 팁 ADR 도구 adr-tools (CLI) README.md (ADR 인덱스) Workflow ADR 작성 시점 코드 리뷰에서 Chec…