architecture-decision-records
아키텍처 결정을 빠르게 명확하게 기록하세요
팀은 결정 사항이 문서화되지 않거나 분산되어 있으면 컨텍스트를 잃게 됩니다. 이 스킬은 ADR 템플릿, 라이프사이클 가이드라인 및 검토 체크리스트를 제공하여 결정 사항을 일관되게 기록할 수 있도록 합니다.
스킬 ZIP 다운로드
Claude에서 업로드
설정 → 기능 → 스킬 → 스킬 업로드로 이동
토글을 켜고 사용 시작
테스트해 보기
"architecture-decision-records" 사용 중입니다. Write an ADR to adopt Redis for caching product pages.
예상 결과:
- ADR-0010: 제품 페이지 캐싱에 Redis 사용
- 상태: 수용됨
- 컨텍스트: 피크 시간 동안 페이지 로드 속도 저하
- 결정: Redis를 읽기 전용 캐시로 추가
- 결과: 읽기 속도 향상, 캐시 무효화 작업 추가
"architecture-decision-records" 사용 중입니다. Create an ADR for choosing between REST and GraphQL.
예상 결과:
- ADR-0015: API 레이어에 GraphQL 사용
- 상태: 수용됨
- 컨텍스트: 모바일 클라이언트가 유연한 데이터 페칭 필요
- 결정: Apollo Server와 함께 GraphQL 채택
- 고려함: 페이지네이션이 포함된 REST API, Falcor
- 장점: 과도한 데이터 가져오기 감소, 강력한 타이핑
- 단점: 복잡성 증가, 캐싱 어려움
보안 감사
안전Pure documentation skill containing only templates and guidance for writing Architecture Decision Records. All 56 static findings are false positives: detected patterns are markdown documentation examples, harmless text strings in prose, and legitimate documentation links. No executable code, file access, network activity, or external commands are present.
위험 요인
🌐 네트워크 접근 (9)
⚙️ 외부 명령어 (25)
품질 점수
만들 수 있는 것
주요 선택 사항 문서화
데이터베이스, 플랫폼 및 통합 결정에 대한 구조화된 ADR을 생성합니다.
결정 로그 표준화
팀 전체에 걸쳐 일관된 ADR 프로세스와 검토 체크리스트를 채택합니다.
과거 결정 검토
온보딩 중 과거 선택 사항과 그 결과를 이해합니다.
이 프롬프트를 사용해 보세요
Create a lightweight ADR for adopting TypeScript in our frontend. Include context, decision, and consequences.
Write a standard ADR comparing PostgreSQL, MySQL, and MongoDB for our product catalog.
Draft a deprecation ADR to replace MongoDB with PostgreSQL, including a migration plan.
Create an RFC style ADR for event sourcing in order management, with motivation, design, drawbacks, and alternatives.
모범 사례
- 구현 시작 전에 ADR 작성
- 긍정적 결과와 부정적 결과 모두 기록
- 관련 ADR 연결하고 시간에 따라 상태 업데이트
피하기
- 대신 수용된 ADR 수정
- 컨텍스트와 결정 동인 생략
- 명확한 결정 없이 모호한 언어 사용