skills.rest
jieni777
jieni777COMMUNITY
Explore all skills by this author →
GitHub

adr-writer

Generate standardized Architecture Decision Records from natural-language decisions.

1|Updated Jan 30, 2026
Search Tags:#architecture#documentation#adr#ai#software-design#decision-record
One-click install
npx skills add https://github.com/jieni777/opencode-config-backup --skill adr-writer-jieni777
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-writer
Source: https://github.com/jieni777/opencode-config-backup/tree/main/skills/adr-writer
Command: npx skills add https://github.com/jieni777/opencode-config-backup --skill adr-writer-jieni777

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions are often undocumented, boilerplate-heavy, and hard to standardize. This skill automates the generation of Architecture Decision Records with AI, ensuring consistent structure and comprehensive rationale.

Core Features & Use Cases

  • Generates complete ADRs in standard format (title, context, decision, consequences, alternatives)
  • Reduces boilerplate and lets teams focus on the actual decision
  • Works for decisions across databases, frameworks, deployment, and platform choices

Quick Start

Run npx ai-adr "switch from REST to GraphQL" to generate an ADR.

Frequently Asked Questions about adr-writer

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

FAQPage Schema
How do I generate an Architecture Decision Record from a natural language description?▼

You generate an Architecture Decision Record by providing a natural-language decision and project context to an AI tool. It outputs a standardized ADR with title, context, decision, consequences, and alternatives.

What is the standard format for an Architecture Decision Record?▼

A standard Architecture Decision Record includes a title, context, decision, consequences, and alternatives. This structure ensures traceability and comprehensive rationale across software architecture decisions.

Can I use AI to document software architecture decisions for framework or database choices?▼

Yes, you can use AI to document software architecture decisions for framework, database, deployment, and platform choices. It standardizes ADR generation and reduces boilerplate so teams can focus on the decision.

What is the best way to standardize ADR documentation across my software engineering team?▼

The best way to standardize ADR documentation is to automate generation with AI from natural-language inputs. This ensures consistent structure and comprehensive rationale for every technical decision record.

Does AI-generated ADR support traceability for software design alternatives?▼

AI-generated ADR supports traceability by explicitly documenting software design alternatives and consequences alongside the final decision. This ensures historical context is preserved across architecture decisions.

Related Skills

Explore More Software Engineering Skills→
windyroadwindyroad
4

wr-architect:create-adr

Create MADR 4.0 Architecture Decision Records in docs/decisions.

Official
Advanced
silvarojasdiegoarturo91silvarojasdiegoarturo91

ADR Format

Create Architecture Decision Records using prescribed templates and numbering conventions.

Community
Basic
Joncik91Joncik91
29

architect

Creates architectural decision records and evaluates system design options.

Community
Advanced
DidierRLopesDidierRLopes
8

convert-beehiiv-newsletter

Convert Beehiiv newsletter posts into blog markdown files with front matter and images.

Community
Advanced