002-write-xdr

Create XDR decision records with conflict checking and standardized templates.

1|1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/flaviostutz/agentkit --skill 002-write-xdr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 002-write-xdr
Source: https://github.com/flaviostutz/agentkit/tree/main/examples/.xdrs/_core/adrs/principles/skills/002-write-xdr
Command: npx skills add https://github.com/flaviostutz/agentkit --skill 002-write-xdr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the creation of clear, conflict-checked decision records (XDRs) by guiding users through a structured process, ensuring adherence to established standards and preventing redundant or conflicting documentation.

Core Features & Use Cases

  • Interactive XDR Creation: Guides users through selecting decision type, scope, and subject.
  • Conflict Checking: Researches existing records to identify and flag potential conflicts.
  • Standardized Templating: Enforces a consistent structure and mandatory language for all decision records.
  • Use Case: When a new architectural choice needs to be documented, this skill will help you define its scope, title, and ensure it doesn't contradict existing ADRs.

Quick Start

Use the 002-write-xdr skill to create a new ADR about choosing a package manager for Node.js projects.

Frequently Asked Questions about 002-write-xdr

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

FAQPage Schema
How do I write an architectural decision record interactively?

To write an architectural decision record interactively, this Skill guides you through selecting the decision type, scope, and subject, then enforces a standardized template for concise documentation.

What is an XDR document and when do I need to create one?

An XDR (eXperimental Decision Record) document captures architectural choices like ADRs, BDRs, and EDRs. You need to create one when a new architectural choice requires structured, conflict-checked documentation.

How can I check a new technical decision record for conflicts with existing ones?

To check a technical decision record for conflicts, the Skill researches your existing records during creation, automatically identifying and flagging potential contradictions before writing the file.

Can I enforce a standardized template for all my ADRs?

You can enforce a standardized template for all ADRs by using this Skill, which applies consistent structure and mandatory language defined by the referenced XDR standards.

What is the best way to generate a unique ID for a decision record?

The best way to generate a unique ID for a decision record is using this Skill's systematic approach for XDR ID generation, which ensures consistent naming and file writing during interactive creation.

Do I need to define XDR standards before creating decision records?

Yes, you need predefined XDR standards, specifically the referenced '001-xdr-standards.md', to ensure the generated decision records adhere to the required structural and mandatory language rules.