develop-adr
Creates an Architecture Decision Record following the Nygard format to document significant technical decisions, their context, and consequences. Use when making technical choices that affect system architecture, technology selection, or development patterns.
npx skills add product-on-purpose/pm-skills --skill develop-adr --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 --> # 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 - Making significant technical decisions that affect system architecture - Choosing between technology options (frameworks, databases, services) - Establishing patterns that future development should follow - Documenting the rationale for constraints or non-obvious approaches - Preserving institutional knowledge about past decisions ## When NOT to Use - The decision is a product or UX design choice, not architecture or technology -> use `develop-design-rationale` - You are still exploring whether an approach is feasible -> time-box the exploration and record it with `develop-spike-summary` first - You need to pitch a solution to stakeholders -> use `develop-solution-brief`; an ADR records a decisio
- When to Use
- When NOT to Use
- Instructions
- Output Format
- Quality Checklist
- Examples
What does the develop-adr skill do?
Creates an Architecture Decision Record following the Nygard format to document significant technical decisions, their context, and consequences. Use when making technical choices that affect system architecture, technology selection, or development patterns.
How do I install it?
Run `npx skills add product-on-purpose/pm-skills --skill develop-adr --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From product-on-purpose/pm-skills, a repository with 518 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.