Adr

Document architecture and product decisions using the Nygard ADR format — captures context, alternatives considered, and consequences so the team never asks 'why did we do it this way?' again. Use when making architecture decisions, choosing between technical approaches, selecting vendors, or any decision that will be hard to reverse.

9 stars 2 forksSoftware Development Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add tarunccet/pm-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add tarunccet/pm-skills --skill adr
Manual install
git clone --depth 1 https://github.com/tarunccet/pm-skills.git /tmp/pm-skills
mkdir -p ~/.claude/skills
cp -r /tmp/pm-skills/pm-execution/skills/adr ~/.claude/skills/adr

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Architecture Decision Record (ADR)

Create a structured record of a significant technical or product decision, capturing not just *what* was decided but *why* — so future teams inherit context, not just code.

### What You'll Need
| Input | Required? | Example |
|-------|-----------|---------|
| Decision to document | ✅ Required | "Migrate from REST to GraphQL for our public API" |
| Context and constraints | ✅ Required | Team size, timeline, tech stack, budget |
| Alternatives considered | 🟡 Recommended | "We also evaluated gRPC and keeping REST" |
| Stakeholders involved | 🟡 Recommended | Engineering lead, platform team, API consumers |
| Prior ADRs or related decisions | ⚪ Optional | "ADR-012: Adopted microservices architecture" |

> **Don't have everything?** Start anyway — the skill will work with what you provide and flag where richer input would improve the output.

### Domain Context

ADRs are the institutional memory of your engineering and product organization. They live alongside the codebase (often in a `docs/adr/` directory) and are **immutable** — when a decision is superseded, you create a new ADR that references the old one rather than editing it. This is part of **Execution** because ADRs are created at the point of decision, typically during sprint planning, design reviews, or technical spikes.

### Context

You are documenting an architecture or product decision about **$ARGUMENTS**.
Read the full skill on GitHub

Details

Skill name
adr
Path
pm-execution/skills/adr/SKILL.md
License
MIT
Repo updated
13 November 2026

FAQ

What does the Adr skill do?

Document architecture and product decisions using the Nygard ADR format — captures context, alternatives considered, and consequences so the team never asks 'why did we do it this way?' again. Use when making architecture decisions, choosing between technical approaches, selecting vendors, or any decision that will be hard to reverse.

How do I install the Adr skill?

Claude Code plugin: /plugin marketplace add tarunccet/pm-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Adr popular?

It lives in tarunccet/pm-skills, which has 9 GitHub stars and 2 forks.

Related skills

Ab Test Analysis

9

tarunccet/pm-skills

Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop recommendations. Use when evaluating experiment results, checking if a test reached significance, interpreting split test data, or deciding whether to ship a variant.

Testing & QA

AI Build Buy Partner

9

tarunccet/pm-skills

Evaluate AI capability sourcing options across build, buy, fine-tune, and partner archetypes using a structured decision matrix. Use when deciding whether to build a custom model, use an LLM API, fine-tune a base model, or partner with an AI vendor.

AI, LLMs & Agents

AI Data Strategy

9

tarunccet/pm-skills

Define a data strategy for AI products covering training data requirements, data quality, labeling strategy, feedback loops, and continuous retraining. Use when assessing data readiness for an AI feature, designing a data flywheel, or planning an ML data pipeline.

AI, LLMs & Agents

Cf Build

5

ecorkran/context-forge

Build and load a Context Forge context prompt. Use when the user asks to build, load, or refresh Context Forge context, optionally for a particular phase or slice.

Software Development

Implementation Review

5

cellrishi-code/claude-skills-atlas

Review an implementation against its requirements, repository conventions, correctness risks, tests, and maintainability. Use before opening a pull request or when reviewing completed work.

Software Development

Cf Check

5

ecorkran/context-forge

Run Context Forge consistency checks on project artifacts. Use when the user asks to check, fix, or audit cf project document consistency.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.