skills.rest
tractorjuice
tractorjuiceCOMMUNITY
Explore all skills by this author →
GitHub

arckit-adr

Generate MADR v4.0 Architecture Decision Records with UK Government requirements.

2.1k|266|Updated Oct 14, 2025
Search Tags:#architecture#documentation#decision record#adr#governance#uk government#mad
One-click install
npx skills add https://github.com/tractorjuice/arc-kit --skill arckit-adr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arckit-adr
Source: https://github.com/tractorjuice/arc-kit/tree/main/arckit-codex/skills/arckit-adr
Command: npx skills add https://github.com/tractorjuice/arc-kit --skill arckit-adr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps enterprise architects create comprehensive Architecture Decision Records (ADRs) that document critical architectural choices, ensuring clarity, traceability, and adherence to governance standards.

Core Features & Use Cases

  • ADR Generation: Creates ADRs following the MADR v4.0 format, enhanced with UK Government requirements.
  • Traceability: Links decisions to requirements, principles, stakeholders, and risks.
  • Option Analysis: Facilitates structured comparison of different architectural options.
  • Use Case: When deciding on a new database technology, use this Skill to generate an ADR that outlines the problem, evaluates options like PostgreSQL vs. MongoDB, justifies the chosen solution, and links to relevant business and technical requirements.

Quick Start

Use the arckit-adr skill to document a new architectural decision for the 'user-authentication' project.

Frequently Asked Questions about arckit-adr

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

FAQPage Schema
How do I generate an Architecture Decision Record that meets governance requirements?▼

To generate an Architecture Decision Record meeting governance requirements, this Skill creates structured ADRs using the MADR v4.0 format, incorporating UK Government requirements for traceability to principles, risks, and stakeholders. It defines escalation levels and validation plans to support enterprise governance workflows.

When do I need to document architectural decisions using MADR format?▼

You need to document architectural decisions using the MADR format when evaluating critical technical choices and requiring structured traceability. It captures decision drivers, option comparisons, and consequences to justify selections like database technologies against business requirements.

Can I link architectural decisions to existing project requirements and risks?▼

Yes, you can link architectural decisions to existing project requirements and risks. The Skill ensures traceability by mapping decision records to principles, requirements, stakeholders, and risks within the generated documentation.

What is the best way to compare architectural options for a new technology?▼

The best way to compare architectural options for a new technology is using structured ADR analysis. This Skill facilitates option comparison by evaluating drivers, consequences, and validation plans to justify the chosen solution against alternatives.

Does this ADR generation approach support enterprise architecture escalation workflows?▼

Yes, this ADR generation approach supports enterprise architecture escalation workflows. It explicitly defines escalation levels and governance forums within the decision record, aligning critical architectural choices with formal review processes.

Related Skills

Explore More Software Engineering Skills→
markeriksonmarkerikson
41

project-overview

Create project overview documents with scope, decisions, constraints, and success metrics.

Community
Intermediate
d-o-hubd-o-hub
4

adr-creation

Create MADR-based ADR documents with constraints from AGENTS.md.

Community
Intermediate
nicolehaugennicolehaugen

architectural-proposals

Guide creation of architectural proposals with structured documentation and risk analysis.

Community
Advanced
angga30angga30

architecture-decision-records

Capture and standardize architectural decisions using MADR, Lightweight ADR, and RFC templates.

Community
Advanced