adr-generator

Generate structured Markdown or JSON Architecture Decision Records from assessment data.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/Ankh-Studio/copilot-enablement-adr --skill adr-generator-ankh-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-generator
Source: https://github.com/Ankh-Studio/copilot-enablement-adr/tree/main/skills/adr-generator
Command: npx skills add https://github.com/Ankh-Studio/copilot-enablement-adr --skill adr-generator-ankh-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the creation of professional Architecture Decision Records (ADRs), transforming complex analysis data into clear, actionable documentation.

Core Features & Use Cases

  • Automated ADR Generation: Creates ADRs from assessment data, ensuring consistency and completeness.
  • Multiple Template Styles: Supports consultant, technical, and executive templates for different audiences.
  • Use Case: After running an AI enablement assessment, use this Skill to generate a consultant-quality ADR that outlines findings, risks, and a phased implementation plan for stakeholders.

Quick Start

Use the adr-generator skill to create a consultant-style ADR from the assessment results found in './assessment.json'.

Frequently Asked Questions about adr-generator

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

FAQPage Schema
How do I generate an Architecture Decision Record from assessment data?

To generate an Architecture Decision Record, you process assessment data like tech stack analysis and readiness scores through the adr-generator, which outputs structured Markdown or JSON documents for formal decision logging.

What is the best way to document AI enablement findings for stakeholders?

Documenting AI enablement findings is best handled by generating a consultant-quality ADR that outlines risks, security findings, and a phased implementation plan using customizable templates tailored for different audiences.

Can I output ADRs in JSON format instead of Markdown?

Yes, you can output ADRs in JSON format instead of Markdown, as the generator supports producing both structured Markdown and JSON documents to accommodate formal decision logging and communication needs.

Does the adr-generator support executive or technical templates?

The adr-generator supports multiple template styles including consultant, technical, and executive templates, allowing you to customize the generated Architecture Decision Records for different audience types.

How do I create a consultant-quality ADR from a local JSON file?

You create a consultant-quality ADR by pointing the generator at your local assessment results file, such as './assessment.json', which it processes to automatically produce the structured decision record documentation.

What should an Architecture Decision Record include for formal decision logging?

An Architecture Decision Record for formal logging should include tech stack analysis, readiness scores, security findings, and a phased implementation plan, ensuring complex analysis data is transformed into clear, actionable documentation.