skills.rest
Dexploarer
DexploarerCOMMUNITY
Explore all skills by this author →
Website𝕏@dEXploarerGitHub

ADR Assistant

Automate creation, analysis, and maintenance of Architecture Decision Records.

7|2|Updated Nov 9, 2025
Search Tags:#automation#architecture#documentation#software design#technical debt#ADR#decision records
One-click install
npx skills add https://github.com/Dexploarer/hyper-forge --skill adr-assistant-dexploarer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ADR Assistant
Source: https://github.com/Dexploarer/hyper-forge/tree/main/.claude/plugins/core-dev/skills/adr-assistant
Command: npx skills add https://github.com/Dexploarer/hyper-forge --skill adr-assistant-dexploarer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation, analysis, and maintenance of Architecture Decision Records (ADRs), ensuring consistent documentation of technical choices and their implications. It prevents decision fatigue and improves team alignment.

Core Features & Use Cases

  • ADR Analysis: Reviews existing ADRs, identifies conflicts, and suggests improvements.
  • ADR Creation: Generates new ADRs following templates, researches alternatives, and documents consequences.
  • Use Case: When evaluating "GraphQL vs REST for our new API," this skill researches options, analyzes your stack, documents pros/cons, and creates a new ADR file, updating the index automatically.

Quick Start

Help me create an Architecture Decision Record for choosing between GraphQL and REST for our new API.

Frequently Asked Questions about ADR Assistant

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document architectural decisions and keep them organized across my project?▼

Architecture Decision Records (ADRs) document technical choices and their rationale in a structured format. ADRs create a searchable history of decisions, alternatives considered, and consequences, helping teams understand why choices were made and preventing duplicate discussions.

Can I automate creating ADRs when evaluating technology choices like GraphQL vs REST?▼

Yes. ADR automation researches technology alternatives, analyzes your stack, documents pros and cons, generates new ADR files following a template, and updates your decision index automatically—eliminating manual documentation work.

How do I identify conflicts between existing architectural decisions?▼

ADR analysis reviews your current decision records, detects conflicting choices, suggests improvements to alignment, and flags related decisions that may contradict each other or create technical debt.

What should an ADR template include to track implementation and success?▼

A complete ADR template captures the decision context, alternatives evaluated, chosen solution, consequences, tradeoffs, implementation timeline, and success metrics—ensuring decisions are measurable and their impact is tracked.

When should I use ADRs instead of informal decision documentation?▼

Use ADRs when decisions affect system architecture, technology stack, or long-term design. Formal ADRs prevent decision fatigue, improve team alignment on technical choices, and create accountability through structured record-keeping.

Related Skills

Explore More Software Engineering Skills→
v4lheruv4lheru

pact-prepare-research

Standardize technology research preparation for architectural decisions.

Community
Intermediate
Remaker-DigitalRemaker-Digital
2

kb-adr

Create architecture decision records with ADR-* IDs in the Knowledge Database.

Official
Intermediate
majesticlabs-devmajesticlabs-dev
47

create-adr

Create standardized Architecture Decision Records with a versioned naming convention.

Official
Advanced
sethdfordsethdford
2

Architecture Decision Records

Create and maintain Michael Nygard ADR templates in Confluence.

Community
Advanced