Community생산성 & 협업github.com

wshobson/architecture-decision-records

중요한 기술적 결정을 문서화하거나, 기존 아키텍처 선택을 검토하거나, 의사 결정 프로세스를 수립할 때 사용되는 아키텍처 결정 기록(ADR) 작성 및 유지 관리 스킬입니다.

architecture-decision-records란 무엇인가요?

이 스킬은 아키텍처 결정 기록(ADR)을 작성하고 유지 관리하는 모범 사례를 제공합니다. 개발자, 아키텍트, 기술 리더가 중요한 기술적 결정을 체계적으로 문서화하여 프로젝트의 의사 결정 내역을 투명하게 추적할 수 있도록 돕습니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 및 개발 도구와 호환되며, 마크다운 기반의 간단한 템플릿을 통해 빠르게 ADR을 생성하고 관리할 수 있습니다. 또한 기존 ADR을 검토하고, 결정의 맥락과 대안을 이해하며, 일관된 형식을 유지하도록 지원하여 장기적인 프로젝트 유지보수성과 지식 공유를 강화합니다.

지원 대상~Claude Code~Codex CLI~Cursor
Part ofAgent Workflows
npx skills add https://github.com/wshobson/agents/tree/main/skills/architecture-decision-records

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

원본 보기→모든 스킬 둘러보기

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

문서

architecture-decision-records은(는) 무엇을 하나요?

중요한 기술적 결정을 문서화하거나, 기존 아키텍처 선택을 검토하거나, 의사 결정 프로세스를 수립할 때 사용되는 아키텍처 결정 기록(ADR) 작성 및 유지 관리 모범 사례를 따릅니다.

개요

ADR(Architecture Decision Record)은 특정 아키텍처 결정과 그 배경, 영향, 그리고 대안들을 캡처하는 간결한 문서입니다. 이 스킬은 일관된 형식과 명확한 추론을 통해 ADR을 작성하고 유지하는 방법을 안내합니다.

주요 기능

  • ADR 생성: 표준 템플릿을 사용하여 새로운 결정 기록을 신속하게 작성합니다.
  • ADR 검토: 기존 기록을 분석하여 결정의 맥락과 일관성을 평가합니다.
  • 프로세스 설정: 팀 내 ADR 도입을 위한 모범 사례와 워크플로우를 제안합니다.

사용 예시

  • 새로운 마이크로서비스 분할 결정을 ADR로 문서화
  • 과거 데이터베이스 선택 결정 검토 및 이유 파악
  • 기술 부채 관리 전략 수립 시 ADR 템플릿 활용

참고: 모든 ADR은 마크다운 형식으로 저장되며, 버전 관리 시스템과 통합되어 변경 이력을 추적할 수 있습니다.

관련 명령어

  • generate adr - 새 ADR 생성
  • review adr <id> - 특정 ADR 검토
  • list adrs - 모든 ADR 목록 보기

자세한 정보

원본 저장소 및 최신 업데이트는 GitHub에서 확인하세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

wshobson/accessibility-compliance

Implement WCAG 2.2 compliant interfaces with mobile accessibility, inclusive design patterns, and assistive technology support. Use when auditing accessibility, implementing ARIA patterns, building for screen readers, or ensuring inclusive user experiences.

wshobson/airflow-dag-patterns

Build production Apache Airflow DAGs with best practices for operators, sensors, testing, and deployment. Use when creating data pipelines, orchestrating workflows, or scheduling batch jobs.

wshobson/angular-migration

Migrate from AngularJS to Angular using hybrid mode, incremental component rewriting, and dependency injection updates. Use when upgrading AngularJS applications, planning framework migrations, or modernizing legacy Angular code.

wshobson/anti-reversing-techniques

Understand anti-reversing, obfuscation, and protection techniques encountered during software analysis. Use this skill when analyzing malware evasion techniques, when implementing anti-debugging protections for CTF challenges, when reverse engineering packed binaries, or when building security research tools that need to detect virtualized environments.

wshobson/api-design-principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.

wshobson/architecture-patterns

Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use this skill when designing clean architecture for a new microservice, when refactoring a monolith to use bounded contexts, when implementing hexagonal or onion architecture patterns, or when debugging dependency cycles between application layers.

wshobson/async-python-patterns

Master Python asyncio, concurrent programming, and async/await patterns for high-performance applications. Use when building async APIs, concurrent systems, or I/O-bound applications requiring non-blocking operations.

wshobson/attack-tree-construction

Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.

wshobson/auth-implementation-patterns

Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues.

wshobson/avoid-ai-writing

Audit and rewrite prose so it stops reading as machine-generated. Use this skill when asked to remove AI-isms, clean up AI writing, edit a draft for AI tells, audit a README, changelog, release note, PR description, or blog post for machine-sounding prose, or make text sound less like AI. Supports a detect-only mode, a rewrite mode, and an edit-in-place mode, with optional voice and context profiles.

wshobson/backtesting-frameworks

Build robust backtesting systems for trading strategies with proper handling of look-ahead bias, survivorship bias, and transaction costs. Use when developing trading algorithms, validating strategies, or building backtesting infrastructure.

wshobson/bash-defensive-patterns

Master defensive Bash programming techniques for production-grade scripts. Use when writing robust shell scripts, CI/CD pipelines, or system utilities requiring fault tolerance and safety.

wshobson/bats-testing-patterns

Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities.

wshobson/bazel-build-optimization

Optimize Bazel builds for large-scale monorepos. Use when configuring Bazel, implementing remote execution, or optimizing build performance for enterprise codebases.

wshobson/before-you-build

Pre-build product and feature risk review for founders, product managers, and AI-assisted builders. Use this skill when the user is about to build a landing page, MVP, SaaS product, internal tool, agent workflow, or major feature and needs to check demand, positioning, monetization, retention, trust, distribution, and adoption risk before implementation starts.

wshobson/billing-automation

Build automated billing systems for recurring payments, invoicing, subscription lifecycle, and dunning management. Use when implementing subscription billing, automating invoicing, or managing recurring payment systems.

wshobson/binary-analysis-patterns

Master binary analysis patterns including disassembly, decompilation, control flow analysis, and code pattern recognition. Use when analyzing executables, understanding compiled code, or performing static analysis on binaries.

wshobson/block-no-verify-hook

Configure a PreToolUse hook to prevent AI agents from skipping git pre-commit hooks with --no-verify and other bypass flags. Use when setting up Claude Code projects that enforce commit quality gates.

wshobson/brand-landingpage

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

wshobson/changelog-automation

Automate changelog generation from commits, PRs, and releases following Keep a Changelog format. Use when setting up release workflows, generating release notes, or standardizing commit conventions.

관련 스킬

steipete/gemini

Gemini CLI one-shot prompts, summaries, generation, skills, hooks, MCP, or Gemma routing.

community

steipete/gh-issues

Fetch GitHub issues, select candidates, spawn background fix agents, open PRs, and optionally process PR review comments.

community

steipete/skill-creator

Create, edit, audit, tidy, validate, or restructure AgentSkills and SKILL.md files.

community

steipete/clawhub

Search, install, update, sync, or publish agent skills with the ClawHub CLI and registry.

community

steipete/coding-agent

Delegate coding work to Codex, Claude Code, or OpenCode as background workers; not simple edits or read-only code lookup.

community

steipete/mcporter

List, configure, authenticate, call, and inspect MCP servers/tools with mcporter over HTTP or stdio.

community
← More 생산성 & 협업 skills