Create Architecture Decision Record

Generate Architecture Decision Records with numbering and contradiction detection.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/rghsoftware/context-engine --skill create-architecture-decision-record
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Create Architecture Decision Record
Source: https://github.com/rghsoftware/context-engine/tree/main/context-engine/skills/adr-create
Command: npx skills add https://github.com/rghsoftware/context-engine --skill create-architecture-decision-record

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation of Architecture Decision Records (ADRs) while ensuring that new decisions do not conflict with existing accepted ones, maintaining architectural integrity.

Core Features & Use Cases

  • Automated ADR Generation: Creates new ADR files with a unique number and title.
  • Contradiction Detection: Compares new decisions against existing ADRs for scope overlap and potential conflicts.
  • Workflow Integration: Guides the user through decision capture, conflict resolution, and ADR writing.
  • Use Case: When a significant technical change is proposed, use this Skill to document it, check for compatibility with past decisions, and ensure it's properly recorded in the Context/Decisions/ directory.

Quick Start

Use the adr-create skill to document a new decision about the database access pattern.

Frequently Asked Questions about Create Architecture Decision Record

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

FAQPage Schema
How do I create an Architecture Decision Record without conflicting with existing decisions?

To create an Architecture Decision Record safely, this Skill automates numbering and drafting while performing contradiction detection against accepted ADRs. It identifies scope overlaps across files and features to ensure new architectural decisions maintain consistency.

What is the best way to document technical decisions and manage architectural debt?

Documenting technical decisions to manage architectural debt requires capturing the context, decision, and status. This Skill guides you through decision capture and conflict resolution, writing the outcome to a strict ADR template in the Context/Decisions/ directory.

How does contradiction detection work for Architecture Decision Records?

Contradiction detection for Architecture Decision Records works by comparing newly proposed decisions against existing accepted ones. The process identifies potential conflicts and scope overlaps across specific technical concerns within defined technology stacks to resolve issues proactively.

When do I need to create an ADR for a software engineering project?

You need to create an ADR when a significant technical change is proposed in a software engineering project. Documenting the decision ensures architectural integrity, verifies compatibility with past choices, and provides historical context for future reference.

Do I need a strict ADR template to automate architecture documentation?

Yes, a strict ADR template is required to automate architecture documentation. Adhering to predefined rules and maintaining historical integrity ensures the automated generation produces consistent, valid records that align with your existing technology stack.

Can I check if a new database access pattern conflicts with past architectural decisions?

Yes, you can check if a new database access pattern conflicts with past architectural decisions. By drafting the proposed change with this Skill, it validates the new decision against existing ADRs to detect scope overlaps and technical conflicts.