스킬 architecture-decision-records
📦

architecture-decision-records

콘텐츠 리비전 r1 안전 ⚙️ 외부 명령어🌐 네트워크 접근

아키텍처 결정을 명확하게 문서화하기

중요한 기술적 선택은 채팅 스레드와 티켓 속에서 사라지는 경우가 많습니다. 이 스킬은 Claude, Codex, Claude Code가 맥락, 선택지, 결정, 결과를 보존하는 간결한 ADR을 작성하도록 돕습니다.

지원: Claude Codex Code(CC)
Maintain this Skill? Claim it 🥉 78 브론즈

내 에이전트로 설치

이 요청을 에이전트에 복사하세요. 공식 Skill 페이지와 매니페스트가 포함되어 있습니다.

에이전트 요청
Review the Skillstore skill "architecture-decision-records" from https://skillstore.io/skills/wshobson-architecture-decision-records.md and its manifest at https://skillstore.io/api/skills/wshobson-architecture-decision-records/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

에이전트는 계속해서 계획을 표시하고 보안 정책에서 요구하는 확인을 요청해야 합니다.

에이전트가 읽기 쉬운 리소스

AI 에이전트, 크롤러, 스크립트가 전체 페이지 대신 정리된 컨텍스트만 필요할 때 이 링크를 사용하세요.

Markdown 상세 GET /skills/wshobson-architecture-decision-records.md 서명된 manifest GET /api/skills/wshobson-architecture-decision-records/manifest 서명된 lockfile GET /api/skills/wshobson-architecture-decision-records/lockfile

테스트해 보기

"architecture-decision-records" 사용 중입니다. 전자상거래 서비스를 위한 기본 데이터베이스를 선택해야 합니다.

예상 결과:

  • 상태, 맥락, 결정 동인, 검토한 선택지, 근거, 결과, 리스크, 관련 결정을 포함한 표준 ADR입니다.
  • 이 기록은 PostgreSQL이 트랜잭션 무결성, 검색, JSON 속성, 팀 경험에 적합한 이유를 설명합니다.

"architecture-decision-records" 사용 중입니다. 우리 팀은 프론트엔드 결정을 문서화하는 경량 방식을 원합니다.

예상 결과:

  • 상태, 날짜, 결정자, 맥락, 결정, 좋은 결과, 나쁜 결과, 완화 방안을 포함한 간결한 ADR입니다.
  • 이 기록은 결정의 이유를 보존하면서도 풀 리퀘스트에 담을 수 있을 만큼 짧습니다.

"architecture-decision-records" 사용 중입니다. 오래된 스토리지 결정을 새로운 결정으로 대체해야 합니다.

예상 결과:

  • 이전 기록을 인용하고, 변경된 제약 조건을 설명하며, 새로운 결정을 명시하고, 마이그레이션 단계를 개요로 제시하는 대체 ADR입니다.
  • 이 기록은 과거 맥락을 유지하면서 현재 방향을 명확히 합니다.

보안 감사

안전
v7 • 2026. 7. 7. 버전별 보고서 열기

All static findings were adjudicated as false positives. The backtick detections are Markdown fences, inline code, or documented adr-tools examples, and the network detections are ordinary reference links with no evidence of data transfer or hidden access.

1
스캔된 파일
429
분석된 줄 수
0
검토 항목
0
오탐 무시됨

위험 요인

⚙️ 외부 명령어 (24)
SKILL.md:40-44 SKILL.md:44-50 SKILL.md:50-144 SKILL.md:144-145 SKILL.md:145-149 SKILL.md:149-174 SKILL.md:174-175 SKILL.md:175-179 SKILL.md:179-188 SKILL.md:188-192 SKILL.md:192-237 SKILL.md:237-241 SKILL.md:241-261 SKILL.md:261-267 SKILL.md:267-310 SKILL.md:310-316 SKILL.md:316-325 SKILL.md:325-329 SKILL.md:329-345 SKILL.md:345 SKILL.md:357-361 SKILL.md:361-379 SKILL.md:379-383 SKILL.md:383-405
🌐 네트워크 접근 (8)
SKILL.md:142 SKILL.md:143 SKILL.md:308 SKILL.md:309 SKILL.md:425 SKILL.md:426 SKILL.md:427 SKILL.md:428
가장 최근에 완료된 정적·의미론적 감사에서 확인된 보안 발견 사항이 감지되지 않았습니다. 이는 스킬에 부작용이 없음을 증명하지 않습니다.
감사자: codex 감사 이력 보기 →
이 보고서 공유 및 인용

버전이 지정된 평가 보고서, 중립 배지, 임베드 카드 및 인용을 공유하세요. Skillstore는 근거를 보고하지만 이 Skill의 안전 여부를 판단하지 않습니다.

버전별 보고서 열기
보안 평가

보고서 링크 복사

https://skillstore.io/skills/wshobson-architecture-decision-records/audits/7?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 배지

[![Skillstore security assessment](https://skillstore.io/badges/skills/wshobson-architecture-decision-records/security.svg)](https://skillstore.io/skills/wshobson-architecture-decision-records?utm_source=security_passport_badge)

HTML 배지

<a href="https://skillstore.io/skills/wshobson-architecture-decision-records?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/wshobson-architecture-decision-records/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

임베드 카드

<iframe src="https://skillstore.io/embed/skills/wshobson-architecture-decision-records.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
학술 인용 (APA · BibTeX · CFF)

APA 인용

wshobson. (2026). architecture-decision-records security audit report (audit version 7) [Author version unspecified]. Skillstore. https://skillstore.io/skills/wshobson-architecture-decision-records/audits/7

BibTeX 인용

@techreport{wshobson-wshobson-architecture-decision-records-2026, author = {wshobson}, title = {architecture-decision-records security audit report (audit version 7)}, institution = {Skillstore}, year = {2026}, number = {7}, url = {https://skillstore.io/skills/wshobson-architecture-decision-records/audits/7}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "architecture-decision-records security audit report (audit version 7)" version: "unspecified" type: report authors: - name: "wshobson" date-released: "2026-07-07" url: "https://skillstore.io/skills/wshobson-architecture-decision-records/audits/7" identifiers: - type: other value: "skillstore:wshobson-architecture-decision-records:audit:7" description: "Skillstore immutable audit report identifier"

변형 비교

설치 가능한 변형 2개

각 작성자의 스킬은 별도의 설치 항목으로 유지됩니다. 추천 변형은 Skillstore 근거로 순위가 정해집니다.

이 변형이 1위인 이유

Skillstore 사용량이 더 높음
sickn33 권장

sickn33-architecture-decision-records

Skillstore 점수 78
증거 신뢰도 높음
Skillstore 사용량 17
업데이트됨

2026-09-09

wshobson 현재

wshobson-architecture-decision-records

Skillstore 점수 78
증거 신뢰도 높음
Skillstore 사용량 15
업데이트됨

2026-09-09

Skillstore 점수

이 점수의 이유 증거 신뢰도: 높음
55
아키텍처
85
유지보수성
87
콘텐츠
71
커뮤니티
83
사양 준수

만들 수 있는 것

새 플랫폼 결정 기록하기

구현을 시작하기 전에 데이터베이스, 프레임워크, API 또는 인프라 선택에 대한 ADR을 작성합니다.

엔지니어링 문서 표준화하기

일관된 기술 결정 기록을 위해 ADR 템플릿, 상태 모델, 검토 체크리스트를 정의합니다.

과거 트레이드오프 검토하기

새로운 제약 조건이 나타난 후 과거 결정이 폐기, 대체 또는 유지되어야 하는 이유를 문서화합니다.

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

기본 ADR 초안 작성 
[project]에 [technology]를 선택하는 것에 대한 경량 ADR을 작성하세요. 상태, 날짜, 맥락, 결정, 결과를 포함하세요.
선택지 비교 
[decision]에 대한 표준 ADR을 작성하세요. [option A], [option B], [option C]를 비교하세요. 결정 동인, 장점, 단점, 근거, 리스크를 포함하세요.
기존 ADR 대체 
ADR-[number]를 대체하는 ADR을 작성하세요. 무엇이 바뀌었는지, 새로운 결정, 마이그레이션 단계, 결과, 배운 점을 설명하세요.
ADR 프로세스 설계 
[team or organization]을 위한 ADR 워크플로를 정의하세요. 디렉터리 구조, 상태 정의, 검토 체크리스트, 소유권, 유지보수 규칙을 포함하세요.

모범 사례

  • 검토자가 가정을 일찍 검토할 수 있도록 구현 전에 ADR을 작성하세요.
  • 각 ADR은 하나의 중요한 결정과 그 구체적인 결과에 집중하세요.
  • 사실이 바뀐 뒤 승인된 기록을 다시 쓰는 대신 대체 ADR을 사용하세요.

피하기

  • 일상적인 버그 수정, 작은 구성 변경, 마이너 버전 업그레이드에는 ADR을 사용하지 마세요.
  • 거부된 선택지나 부정적인 결과를 미래의 독자에게 숨기지 마세요.
  • 승인된 ADR이 구현 티켓이나 관련 문서와 단절된 상태로 남아 있게 하지 마세요.

자주 묻는 질문

Architecture Decision Record란 무엇인가요?
ADR은 중요한 기술적 선택의 맥락, 결정, 근거, 결과를 기록하는 짧은 문서입니다.
언제 ADR을 작성해야 하나요?
미래의 팀이 이해해야 하는 중요한 아키텍처, 기술, 통합, 보안 또는 API 결정에 대해 작성하세요.
이 스킬이 폐기된 결정에도 도움이 되나요?
예. 변경된 제약 조건, 마이그레이션 단계, 결과, 배운 점을 설명하는 폐기 템플릿을 포함합니다.
이 스킬은 단일 ADR 형식을 강제하나요?
아니요. 세부 수준에 따라 사용할 수 있는 표준, 경량, Y-statement, 폐기, RFC 스타일 형식을 포함합니다.
이 스킬은 adr-tools를 자동으로 실행하나요?
아니요. 사용자가 수동으로 실행하도록 선택할 수 있는 선택적 adr-tools 명령만 문서화합니다.
이 스킬은 Claude Code와 Codex에 적합한가요?
예. Claude Code, Codex, Claude가 ADR을 작성하거나 유지관리할 때 사용할 수 있는 문서화 패턴을 제공합니다.

개발자 세부 정보

작성자

wshobson

라이선스

MIT

Skillstore 리비전

r1

버전 안내

작성자가 버전을 선언하지 않았습니다.

리포지토리

https://github.com/wshobson/agents/tree/main/plugins/documentation-generation/skills/architecture-decision-records

참조

36e07d5e13068e5be64447e8f20b427cf2cbd21a

유지보수 최신성

2026. 7. 21.

사용량

8 다운로드 · 238 조회

파일 구조

📄 SKILL.md

wshobson의 다른 스킬

전체 보기

관련 스킬

전체 보기