wshobson/agents

architecture-decision-records

Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.

16K installs 39K starsUpdated Sep 2, 2026License: MIT

Install

npx skills add wshobson/agents@architecture-decision-records

Runs in your terminal. Adds the skill globally for Claude Code, Cursor, Codex and others; add -g -y to skip prompts.

What it does

Architecture Decision Records Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions. When to Use This Skill - Making significant architectural decisions - Documenting technology choices - Recording design trade-offs - Onboarding new team members - Reviewing historical decisions - Establishing decision-making processes Core Concepts 1. What is an ADR? An Architecture Decision Record captures: - Context: Why we needed to make a decision - Decision: What we decided -…

Excerpt from the skill's own SKILL.md. Read the full file on GitHub before installing: skills run with your agent's permissions.

View source on GitHub

Before you install

Skills are plain text instructions the agent follows, sometimes with scripts. Check the source, prefer repositories with many installs and stars, and read any script it ships.

Categories

Related skills

  • tailwind-design-system

    wshobson/agents

    Build scalable design systems with Tailwind CSS v4, design tokens, component libraries, and responsive patterns. Use when creating component libraries, implementing design systems, or standardizing UI patterns.

    62K installs 39KDesign & UIReact & Next.js
  • brand-landingpage

    wshobson/agents

    >

    38K installs 39KDesign & UIMarketingResearch
  • Master Next.js 14+ App Router with Server Components, streaming, parallel routes, and advanced data fetching. Use when building Next.js applications, implementing SSR/SSG, or optimizing React Server Components.

    29K installs 39KReact & Next.jsData
  • code-review-excellence

    wshobson/agents

    Master effective code review practices to provide constructive feedback, catch bugs early, and foster knowledge sharing while maintaining team morale. Use when reviewing pull requests, establishing review standards, or mentoring developers.

    28K installs 39KCode review
  • api-design-principles

    wshobson/agents

    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.

    28K installs 39KDesign & UITestingDocumentation
  • Use this skill when designing or reviewing a PostgreSQL-specific schema. Covers best-practices, data types, indexing, constraints, performance patterns, and advanced features

    25K installs 39KDesign & UIDataProductivity

Search skills

/skills/wshobson/agents/architecture-decision-records/