skills.rest
WindXRan
WindXRanCOMMUNITY
Explore all skills by this author →
GitHub

architecture-decision

Create Architecture Decision Records with context, alternatives, and consequences.

Updated Apr 4, 2026
Search Tags:#adr#technical review#decision records#architecture governance#engine reference#retrofit documentation
One-click install
npx skills add https://github.com/WindXRan/y3td --skill architecture-decision-windxran
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision
Source: https://github.com/WindXRan/y3td/tree/main/.claude/skills/architecture-decision
Command: npx skills add https://github.com/WindXRan/y3td --skill architecture-decision-windxran

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you reliably document significant technical decisions as Architecture Decision Records (ADRs), including context, alternatives, and consequences, so teams can build consistently and avoid contradictory architecture over time.

Core Features & Use Cases

  • Guided ADR authoring: Produces a complete ADR in the expected format with Status, Date, Engine Compatibility, Dependencies, and Consequences.
  • Engine-context grounded writing: Reads engine reference docs and flags knowledge gaps and domain-specific risks before drafting.
  • Collaborative gate reviews: Validates the draft via an engine specialist and then a technical director for architectural coherence.
  • Retrofit existing ADRs: Detects missing mandatory sections in an existing ADR file and appends only what’s absent (never overwriting existing content).
  • Registry + coverage follow-ups: Optionally updates an architecture registry and guides next steps for remaining priority ADRs and GDD work.

Quick Start

Run architecture-decision with a short title like event-system-architecture to create a new ADR for that decision.

Frequently Asked Questions about architecture-decision

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

FAQPage Schema
How do I write an Architecture Decision Record that includes context and consequences?▼

To write an Architecture Decision Record, you provide a short technical title and the tool generates a complete ADR with Status, Date, Engine Compatibility, Dependencies, and Consections sections. It grounds the writing in engine reference docs to flag knowledge gaps before drafting.

Can I retrofit missing mandatory sections in an existing ADR markdown file?▼

Yes, you can retrofit existing ADR markdown files by detecting and appending only missing mandatory sections. The process never overwrites your existing content, ensuring historical architecture governance documentation remains intact while achieving full compliance.

Does the ADR generation process validate technical decisions with reviewers?▼

Yes, the ADR generation process validates drafts through collaborative gate reviews. It checks the document with an engine specialist for domain-specific risks and a technical director for architectural coherence before finalizing the decision record.

What is the best way to maintain an architecture registry after creating decision records?▼

The best way to maintain an architecture registry is to optionally update it automatically after ADR validation. This tracks coverage and guides next steps for remaining priority decision records and GDD work during architecture governance workflows.

Related Skills

Explore More Software Engineering Skills→
dnkrowdnkrow
1

architecture-decision

Create Architecture Decision Records with context, dependencies, and consequences.

Community
Advanced
SentioLabsSentioLabs
1

finish

Run end-of-session workflows for Arc by capturing work, running quality gates, and committing changes.

Official
Advanced
rakhnianskii9rakhnianskii9

architecture-decision

Document architectural decisions using a standardized ADR workflow.

Community
Advanced
polsegupolsegu

architecture-decision

Create Architecture Decision Records with engine compatibility validation and registry updates.

Community
Advanced