Generate Markdown ADRs with context, alternatives, and reasoning from decisions.
npx skills add https://github.com/jieni777/opencode-config-backup --skill adr-gen
Please help me install this Agent Skill. Skill: adr-gen Source: https://github.com/jieni777/opencode-config-backup/tree/main/skills/adr-gen Command: npx skills add https://github.com/jieni777/opencode-config-backup --skill adr-gen
ADRs are essential for capturing why a decision was made, but teams often struggle to document and maintain architectural rationale. This Skill automates ADR generation to ensure decisions are tracked with context, alternatives considered, and reasoning.
Run npx ai-adr "Switch from REST to GraphQL" to generate an ADR.
High-intent search queries and answers about installing and using this skill.
Generate an Architecture Decision Record by running npx ai-adr with your decision topic to auto-produce a markdown file capturing context, alternatives, and reasoning. This enforces consistent ADR fields including Title, Status, Context, Decision, Consequences, and Alternatives for documentation.
An ADR is an Architecture Decision Record that captures why a decision was made across software projects and lifecycles. It should include Title, Status, Context, Decision, Consequences, and Alternatives to ensure architectural rationale is consistently tracked and maintained for onboarding.
Yes, you can automate ADR creation in markdown by running the CLI tool with a decision description. It outputs a structured markdown document with context and consequences, ensuring teams maintain consistent architecture documentation without manual formatting overhead.
The best way to document architectural context and alternatives is to generate a structured ADR in markdown. By enforcing fields for Context, Alternatives, and Consequences, the approach ensures all architectural rationale and decision reasoning is consistently captured for future reference.
No, manual markdown formatting is not needed for architecture decision records. The generation tool enforces the ADR structure and automatically outputs properly formatted markdown with all required fields, reducing documentation overhead and maintaining consistency across software projects.
mvillmowGenerate Architecture Decision Records with structured Context, Decision, Rationale, and Consequences.
JansenAnalyticsCreate, list, view, and search per-project ADR files in Markdown format.
zzafergokConvert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.
HermeticOrmusGenerate Markdown-based ADRs using MADR and Y-Statement templates.
