{"enrichment":{"faq":[{"a":"adr-author guides you through structured authoring in three phases: Frame captures scope and drivers, Decide evaluates options and rationale, and Govern writes the final ADR file with lineage tracking. You choose between compact Y-Statement or detailed MADR v4.0.0 output format, then enter via interactive capture, planner handoff, or template adoption to generate validated decision records.","q":"How to write architecture decision records with adr-author?"},{"a":"adr-author generates ADRs in two formats: Y-Statement for concise decisions, and MADR v4.0.0 for detailed architecture decision records. Both formats include frontmatter validation and can be generated through the Frame-Decide-Govern workflow, ensuring consistent structure and traceability across your decision documentation.","q":"What ADR formats does adr-author support?"},{"a":"Yes. adr-author normalizes existing ADR templates into its canonical structure through template adoption mode. This lets you migrate legacy decision records into standardized Y-Statement or MADR v4.0.0 format while preserving content and establishing lineage tracking for superseded decisions.","q":"Can adr-author adopt existing ADR templates?"},{"a":"adr-author manages ADR supersession lineage and decision history, allowing you to track which decisions replace earlier ones and maintain a complete audit trail. This capability integrates with the Govern phase to document decision evolution and dependencies across your architecture documentation.","q":"Does adr-author track decision history and supersession?"},{"a":"adr-author evaluates architecturally significant requirements (ASR) triggers to identify when ADR authoring is needed. You can enter the workflow via interactive capture for new decisions, planner handoff for decisions emerging from planning sessions, or template adoption to normalize existing records into canonical format.","q":"What triggers ADR authoring in adr-author?"},{"a":"Yes, adr-author is released under the MIT license, making it freely available for commercial and personal use. You can modify, distribute, and integrate it into your architecture decision documentation workflows without licensing restrictions.","q":"Is adr-author open source?"}],"shadow_tags":["decision-documentation","template-driven-authoring","architectural-governance","lineage-tracking","multi-format-output","phase-gated-workflow","schema-validation","handoff-integration"],"summary_rewrite":"adr-author guides you through structured architecture decision authoring in three phases: Frame captures scope and drivers, Decide evaluates options and rationale, and Govern writes the final ADR file with lineage tracking. Choose between compact Y-Statement or detailed MADR v4.0.0 output, and enter via interactive capture, planner handoff, or template adoption."},"files":[{"bytes":15048,"path":".github/skills/project-planning/adr-author/SKILL.md","sha256":"f9c1ca5e6ce7328b331df4447ce4656bc9668d04833951e33c27bdd5d528224f","url":"https://skillfed.io/files/microsoft/hve-core/adr-author/8505c6ad/SKILL.md"}],"id":"microsoft/hve-core/adr-author","links":{"html":"https://skillfed.io/microsoft/hve-core/adr-author","md":"https://skillfed.io/microsoft/hve-core/adr-author.md","repo":"https://github.com/microsoft/hve-core"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":237,"language":"PowerShell","last_updated":"2026-07-28","license":"MIT","name":"adr-author","publisher":"microsoft","stars":1299},"relations":{"categories":["architecture","decision-management","documentation"],"similar":[{"id":"JosiahSiegel/claude-plugin-marketplace/doc-diagnostic"},{"id":"tech-leads-club/agent-skills/create-adr"},{"id":"JosiahSiegel/claude-plugin-marketplace/adr-drafting"},{"id":"ncklrs/startup-os-skills/adr"},{"id":"vercel/ai/adr-skill"},{"id":"existential-birds/beagle/adr-writing"},{"id":"terrylica/cc-skills/implement-plan-preflight"},{"id":"wshobson/agents/architecture-decision-records"},{"id":"joelhooks/joelclaw/adr-skill"},{"id":"nWave-ai/nWave/nw-architecture-patterns"}]},"slug":{"owner":"microsoft","repo":"hve-core","skill":"adr-author"},"version":"8505c6ad"}