skillfed

Create Adr

Create ADRs that capture the reasoning behind significant technical choices, including context, alternatives considered, and trade-offs. The skill guides you through gathering implementation details, identifying decision drivers, and structuring records that help future developers understand why architectural choices were made.

Create Adr generates structured Architecture Decision Records documenting technical choices and their rationale.

AI-generated summary based on this skill's SKILL.md

44 11 NOASSERTION updated by majesticlabs-dev

Install

majesticlabs-dev/majestic-marketplace/create-adr · repository language: Shell

git clone https://github.com/majesticlabs-dev/majestic-marketplace
cp -r majestic-marketplace ~/.claude/skills/create-adr

generated, unverified - the skill's exact subdirectory could not be determined; check the repository on GitHub

npx skillfed install majesticlabs-dev/majestic-marketplace/create-adr

Frequently asked questions

AI-generated answers based on this skill's SKILL.md and metadata

How to create an ADR with Create Adr?

Create Adr guides you through building a structured Architecture Decision Record that captures the reasoning behind significant technical choices. The skill helps you gather implementation details, identify decision drivers, and structure records that explain context, alternatives considered, and trade-offs so future developers understand why architectural choices were made.

What does Create Adr include in an ADR template?

Create Adr's template structure captures context (the issue motivating the decision), alternatives considered (other options evaluated), decision (the chosen approach), consequences (trade-offs and impacts), and rationale (why this choice was made). This systematic format ensures architectural choices are documented consistently with full reasoning preserved.

Can Create Adr automate ADR creation to maintain consistency?

Yes. Create Adr automates ADR creation by applying a standardized template, ensuring consistent formatting and structure across all decision records. This automation helps teams maintain uniform documentation practices and makes it easier for future developers to locate and understand architectural decisions.

What are the key sections Create Adr helps document?

Create Adr guides documentation of implementation details, decision drivers, context surrounding the choice, alternatives that were evaluated, the final decision, and consequences including trade-offs. By systematically capturing these elements, Create Adr ensures architectural reasoning is preserved for long-term team understanding.

How does Create Adr help document architecture choices?

Create Adr structures the documentation process by prompting you to identify decision drivers, evaluate alternatives, and articulate trade-offs. This helps teams capture not just what was decided, but why—creating a historical record that supports future architectural discussions and prevents revisiting settled decisions.

Related skills

Tags

decision-documentation architecture-governance design-rationale technical-records decision-tracking