Agent skill · writing content · aiskillstore
adr-log
Document architecture decisions with ADR (Architecture Decision Records). Use when making significant technical decisions, choosing between alternatives, or when onboarding needs context on past decisions.
Why this skill is useful
Provides a structured template and specific examples for documenting architecture decisions that the AI wouldn't reliably generate on its own.
What it needs
Requires adr-tools installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
ADR (Architecture Decision Records) 아키텍처 결정을 문서화하여 "왜 그렇게 했는지"를 기록하는 스킬입니다. Core Principle "결정의 '무엇'보다 '왜'가 중요하다." "6개월 후의 나도 알아볼 수 있게 기록한다." ADR이 필요한 경우 상황 예시 ------ ------ 기술 선택 React vs Vue, PostgreSQL vs MongoDB 아키텍처 패턴 Monolith vs Microservices 의존성 추가 새 라이브러리 도입 보안 결정 인증 방식 선택 성능 트레이드오프 캐싱 전략 결정 표준 변경 코딩 컨벤션 변경 ADR 폴더 구조 ADR 템플릿 docs/adr/0000-adr-template.md 실제 ADR 예시 docs/adr/0001-use-nextjs-app-router.md docs/adr/0002-choose-postgresql-over-mongodb.md ADR 작성 가이드 번호 체계 상태 흐름 Proposed: 검토 중 Accepted: 승인되어 적용 중 Deprecated: 더 이상 유효하지 않음 Superseded by ADR-XXXX: 새 결정으로 대체됨 작성 팁 ADR 도구 adr-tools (CLI) README.md (ADR 인덱스) Workflow ADR 작성 시점 코드 리뷰에서 Checklist 프로젝트 설정 [ ] docs/adr/ 폴더 생성 [ ] ADR 템플릿 파일 추가 [ ] README.md (인덱스) 생성 [ ] 번호 체계 정의 ADR 작성 시 [ ] 컨텍스트가 충분히 설명되었는가? [ ] 대안들이 공정하게 비교되었는가? [ ] 결정 이유가 명확한가? [ ] 트레이드오프가 솔직하게 기록되었는가? [ ] 관련 ADR/이슈가 링크되었는가? References ADR GitHub Documenting Architecture Decisions (Michael Nygard) adr-tools
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/adr-log