skills.rest
khulnasoft
khulnasoftOFFICIAL
Explore all skills by this author →
Website𝕏@khulnasoftGitHub

adr-skill

Capture and standardize architecture decisions as machine-actionable MADR-style ADRs.

8|Updated Mar 7, 2025
Search Tags:#automation#architecture#documentation#adr#version-control#decision-record#coding-workflow
One-click install
npx skills add https://github.com/khulnasoft/ai-toolkit --skill adr-skill-khulnasoft
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-skill
Source: https://github.com/khulnasoft/ai-toolkit/tree/main/skills/adr-skill
Command: npx skills add https://github.com/khulnasoft/ai-toolkit --skill adr-skill-khulnasoft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create and maintain Architecture Decision Records (ADRs) optimized for agentic coding workflows. This skill helps you propose, write, update, accept/reject, deprecate, or supersede an ADR; bootstrap an adr folder and index; consult existing ADRs before implementing changes; and enforce ADR conventions. The ADRs are designed to be self-contained, actionable, and auditable.

Core Features & Use Cases

  • Propose and draft ADRs that are self-contained and actionable for coding agents.
  • Bootstrap an ADR folder and an index to centralize decisions.
  • Enforce ADR conventions and an agent-ready checklist (implementation plan, verification criteria).
  • Consult existing ADRs before implementing changes to prevent relitigating decisions.
  • Use Socratic questioning to capture intent before drafting.

Quick Start

Create a new ADR by detailing the decision, context, consequences, and implementation plan in the designated ADR file and directory, following the MADR template.

Frequently Asked Questions about adr-skill

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

FAQPage Schema
How do I create architecture decision records that coding agents can automatically implement?▼

To create agent-ready architecture decision records, you draft machine-actionable ADRs using the MADR template that include context, consequences, and a deterministic implementation plan. This ensures coding agents can execute the specified architectural changes automatically.

What is the best way to manage architecture decision records in an automated coding workflow?▼

Managing ADRs in an automated coding workflow involves bootstrapping a centralized ADR folder with an index, applying versioned statuses, and enforcing self-contained documentation conventions. This allows agents to consult existing decisions before writing code.

How do I prevent coding agents from relitigating past architectural decisions?▼

You prevent agents from relitigating decisions by maintaining a centralized, indexed ADR folder. Agents consult these existing, self-descriptive architecture decision records before implementing changes, ensuring traceable and consistent behavior.

Does the MADR format support an evaluation checklist for agentic coding tasks?▼

Yes, the MADR format supports an agent-ready evaluation checklist. ADRs are standardized with a specific implementation plan and verification criteria, ensuring coding agents can self-evaluate their code against the architectural requirements.

When should I supersede or deprecate an architecture decision record?▼

You supersede or deprecate an architecture decision record when new technical contexts invalidate previous choices. The skill enforces clear versioned statuses and deterministic file naming to maintain an auditable, traceable history of architectural changes.

Related Skills

Explore More Software Engineering Skills→
abdullah1854abdullah1854
1

algorithmic-art

Generate dated Markdown ADRs with Context, Decision, Consequences, Alternatives, and References.

Community
Intermediate
jmanhypejmanhype
24

spec-kit-workflow

Implement Spec Kit workflow phases and generate project artifacts.

Community
Basic
MicrotronXMicrotronX
29

mxDecision

Create and maintain Architecture Decision Records in the mxLore knowledge DB via MCP-Tools.

Community
Advanced
koolerkxkoolerkx

documentation-and-adrs

Record architectural decisions and API changes with ADR templates.

Community
Intermediate