스킬 architecture-decision-records
📦

architecture-decision-records

안전

아키텍처 결정 기록 생성

또한 다음에서 사용할 수 있습니다: wshobson

이 스킬은 팀이 구조화된 템플릿을 사용하여 중요한 기술적 결정을 문서화하는 데 도움을 줍니다. 포괄적인 ADR 형식, 라이프사이클 관리 가이드, 그리고 맥락과 절충안 및 근거를 기록하는 모범 사례를 제공합니다.

지원: Claude Codex Code(CC)
🥉 75 브론즈
1

스킬 ZIP 다운로드

2

Claude에서 업로드

설정 → 기능 → 스킬 → 스킬 업로드로 이동

3

토글을 켜고 사용 시작

테스트해 보기

"architecture-decision-records" 사용 중입니다. 프론트엔드 프로젝트에 TypeScript 도입을 위한 ADR 생성

예상 결과:

Status: Accepted, 현재 React 코드베이스 문제에 대한 Context, TypeScript 도입 Decision, 좋은 점 (타입 안정성, IDE 지원) 과 나쁜 점 (학습 곡선, 빌드 복잡성) 을 다루는 Consequences, 그리고 교육 세션을 포함한 Mitigations 가 있는 완전한 ADR 문서.

"architecture-decision-records" 사용 중입니다. 레거시 인증 서비스의 폐기 문서화

예상 결과:

ADR-0015 를 대체함을 보여주는 상태, 현재 서비스의 문제 목록을 포함한 Context, 단계적 접근을 포함한 Migration Plan, 그리고 원래 결정에서 잘못되었던 점에 대한 Lessons Learned 가 있는 폐기 ADR.

보안 감사

안전
v1 • 2/24/2026

Security analysis confirms this is a safe documentation skill. Static findings for external_commands, network, and weak_crypto are false positives. The skill contains markdown templates, example CLI commands (shown as documentation), and reference URLs to external documentation. No executable code, no data exfiltration, no cryptographic operations.

1
스캔된 파일
444
분석된 줄 수
0
발견 사항
1
총 감사 수
보안 문제를 찾지 못했습니다

감지된 패턴

False Positive: External Commands DetectionFalse Positive: Network DetectionFalse Positive: Weak Cryptographic Algorithm
감사자: claude

품질 점수

38
아키텍처
100
유지보수성
87
콘텐츠
50
커뮤니티
100
보안
100
사양 준수

만들 수 있는 것

데이터베이스 기술 선택 문서화

새 프로젝트에서 PostgreSQL, MySQL 또는 MongoDB 중 선택할 때, 표준 ADR 템플릿을 사용하여 요구사항을 캡처하고 옵션을 비교하며 완전한 근거와 함께 결정을 기록합니다.

프레임워크 마이그레이션 결정 기록

Angular 에서 React 로 마이그레이션을 계획할 때, 폐기 ADR 을 작성하여 변경 이유, 마이그레이션 단계 및 이전 결정에서 얻은 교훈을 문서화합니다.

팀 결정 프로세스 수립

새 팀 멤버를 온보딩할 때, ADR 템플릿을 사용하여 과거 아키텍처 선택과 현재 아키텍처 배후의 추론을 이해하도록 돕습니다.

이 프롬프트를 사용해 보세요

기본 ADR 요청 
[DECISION_TITLE] 에 대한 아키텍처 결정 기록을 생성하세요. 표준 MADR 형식을 사용하세요. 이 결정을 내려야 하는 이유에 대한 맥락, 고려했던 옵션, 최종 결정 및 결과를 포함하세요.
기술 비교 
[USE_CASE] 에 대한 [TECHNOLOGY_A], [TECHNOLOGY_B], [TECHNOLOGY_C] 를 비교하는 ADR 을 생성하세요. 각 옵션에 대한 상세한 장단점, 요구사항을 포함하고 근거와 함께 최선의 선택을 권장하세요.
폐기 기록 
[NEW_TECHNOLOGY] 로 대체되는 [OLD_TECHNOLOGY] 에 대한 폐기 ADR 을 생성하세요. 원래 결정이 내려진 맥락, 변경된 사항, 마이그레이션 계획 및 교훈을 포함하세요.
RFC 스타일 제안 
[PROPOSAL] 에 대한 상세한 RFC 스타일 ADR 을 생성하세요. 동기, 상세한 설계, 단점, 고려된 대안, 미해결 질문 및 구현 계획을 포함하세요. 팀 검토 및 토론에 적합하도록 작성하세요.

모범 사례

  • 결정 맥락을 정확하게 캡처하기 위해 구현 시작 전에 ADR 작성
  • 결과 섹션에 정직한 절충안과 잠재적 단점 포함
  • 프로젝트의 결정 의존성 그래프를 구축하기 위해 관련 ADR 링크
  • 결정이 폐기되거나 대체될 때 ADR 상태 업데이트

피하기

  • 구체적인 맥락이나 근거 없이 모호한 결정 작성
  • 다른 옵션이 고려했음을 보여주는 것을 피하기 위해 대안 섹션 생략
  • 대체하는 새 ADR 을 생성하는 대신 기존 ADR 수정
  • 아키텍처 문서화가 필요하지 않은 사소한 결정에 대한 ADR 생성

자주 묻는 질문

아키텍처 결정 기록이란 무엇인가요?
아키텍처 결정 기록 (ADR) 은 프로젝트 중에 내려진 중요한 아키텍처 결정을 캡처하는 문서입니다. 일반적으로 맥락, 결정 자체, 그리고 그 결정의 결과를 포함합니다.
언제 ADR 을 생성해야 하나요?
프레임워크 도입, 데이터베이스 기술 선택, API 설계 패턴, 보안 아키텍처 또는 통합 패턴과 같은 중요한 아키텍처 결정을 내릴 때 ADR 을 생성하세요. 사소한 패치나 일상적인 유지보수는 ADR 을 생략하세요.
어떤 ADR 형식을 사용해야 하나요?
포괄적인 결정에는 표준 MADR 형식을, 빠른 결정에는 경량 형식을, 간단한 선택에는 Y-Statement 를, 팀 검토가 필요한 복잡한 제안에는 RFC 스타일을 사용하세요.
관련 ADR 을 어떻게 연결하나요?
각 ADR 에 번호로 다른 ADR 을 참조하는 Related Decisions 섹션을 포함하세요. 'Supersedes ADR-0003' 또는 'Complements ADR-0002'와 같은 상태 표시기를 사용하여 관계를 표시하세요.
승인된 ADR 을 수정할 수 있나요?
아닙니다. 승인된 ADR 은 수정해서는 안 됩니다. 대신 이전 것을 대체하는 새 ADR 을 생성하고 변경된 내용과 이유를 문서화하세요.
ADR 관리에 도움이 되는 도구는 무엇인가요?
adr-tools 는 ADR 관리를 위한 인기 있는 CLI 도구입니다. 디렉토리 초기화, 새 ADR 생성, 목차 생성, 관련 결정 연결을 할 수 있습니다.

개발자 세부 정보

작성자

sickn33

라이선스

MIT

리포지토리

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/architecture-decision-records

참조

main

파일 구조

📄 SKILL.md