Architecture Decision Record

Architecture Decision Record is a Writing skill for Claude Code, published by product-on-purpose in pm-skills.

565 stars74 forkson product-on-purpose/pm-skillsAdded 2026/08/25+3% in starsRepository updated 2026/08/25

agent-skillsagentskillsai-skillsclaude-codeclaude-desktopcodexdesign-sprintfoundation-sprintopenskillsproduct-managementskill-familiestriple-diamond

Install in seconds

Install Architecture Decision Record

Copy Architecture Decision Record into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/product-on-purpose/pm-skills/tree/main/skills/develop-adr ~/.claude/skills/develop-adr

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/product-on-purpose/pm-skills.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/develop-adr/SKILL.md in product-on-purpose/pm-skills
Installs to: ~/.claude/skills/develop-adr
Collection: One of 25 skills cataloged from this repository
Category: Writing — 1012 skills

What Architecture Decision Record does

Architecture Decision Record documents a significant technical decision, its context, and consequences. Use it when choosing architecture, technology, or development patterns that future teams need to understand.

Architecture Decision Record is cataloged under Writing on DirSkills. Architecture Decision Record comes from a repository tagged agent-skills, agentskills, ai-skills, claude-code and claude-desktop.

Documentation

README

Excerpt

Architecture Decision Record (ADR)

An Architecture Decision Record documents a significant technical decision along with its context and consequences. ADRs capture the "why" behind architectural choices so future team members understand the reasoning - especially important when they question why something was done a particular way. This skill follows Michael Nygard's lightweight ADR format.

When to Use

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Architecture Decision Record

What else does product-on-purpose publish alongside Architecture Decision Record?
Architecture Decision Record is one of 25 skills that DirSkills catalogs from product-on-purpose/pm-skills, the repository it ships in. Its siblings there include Acceptance Criteria, Build Risk Review and Competitive Analysis. Each one is a separate skill with its own page in this directory, installs the same way Architecture Decision Record does, and is maintained by product-on-purpose in that same repository. The rest of the collection is listed on the product-on-purpose/pm-skills page.
How does Architecture Decision Record compare to other Writing skills?
Architecture Decision Record ranks #701 by stars among the 1012 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Architecture Decision Record against them. Open each page to compare what they document and how they install.