{"enrichment":{"faq":[{"a":"ADR Author helps you structure decisions so automated tools can parse and verify them. The key is specificity: define clear Context (the problem), Decision (what you chose), and Consequences (trade-offs). When you set an enforceability level\u2014HIGH for strict CI checks, MEDIUM for code review gates, LOW for reference\u2014ADR Author guides you to write testable criteria that linting tools and bots can actually enforce, not vague principles.","q":"How do I write architectural decision records that AI can check?"},{"a":"ADR Author teaches you to match enforceability to impact. HIGH enforceability suits critical constraints (e.g., \"all database queries must use prepared statements\")\u2014these go into CI/linting rules. MEDIUM works for team guidelines that need human judgment in code review. LOW is for context-setting decisions that inform future work but don't block it. ADR Author walks you through assessing your decision's scope and team needs to pick the right level.","q":"What enforceability level should my architectural decision have?"},{"a":"ADR Author emphasizes specificity in each section. Context should name the actual problem and constraints you faced\u2014not generic background. Decision states what you chose and why, with enough detail that someone unfamiliar with your team understands it. Consequences lists both benefits and trade-offs honestly. This structure lets future developers and automated systems quickly grasp the reasoning, and makes it possible to write enforcement rules that stick.","q":"How do I structure Context, Decision, and Consequences sections effectively?"},{"a":"Yes. ADR Author guides you through reviewing existing records against team standards. You'll check whether Context is concrete, Decision is unambiguous, and Consequences are realistic. It also helps you spot ADRs that claim HIGH enforceability but lack the specificity needed for CI tools to verify them\u2014a common gap. This review process ensures your ADR library stays useful and actionable.","q":"Can ADR Author help me review existing ADRs for clarity and alignment?"},{"a":"ADR Author connects documentation to enforcement. Write your decision with the right enforceability level, then integrate it into your CI/code review workflow. HIGH-level ADRs become linting rules; MEDIUM-level ones get linked in pull request templates; LOW-level ones live in your architecture docs. By tying ADRs to actual process gates, you move from \"decisions on a wiki nobody reads\" to decisions that shape every commit.","q":"How do I make architectural decisions stick with my team?"},{"a":"ADR Author provides a template with Title, Status, Context, Decision, Consequences, and Enforceability Level. The enforceability field is crucial\u2014it tells your team and tools how strictly to apply the decision. Add a Verification Criteria section for HIGH-level decisions (e.g., \"linter checks for X\"). This structure lets you draft ADRs in plain language while keeping them machine-readable, so they integrate smoothly with your existing CI pipelines and review processes.","q":"What's an ADR template that works with CI and code review tools?"}],"shadow_tags":["decision-documentation","architecture-governance","enforcement-patterns","team-alignment","technical-rationale","review-automation","decision-capture","architecture-standards"],"summary_rewrite":"ADR Author guides you through writing Architectural Decision Records that future developers and automated systems can actually enforce. It covers the full workflow from reading existing ADRs to drafting decisions at the right enforceability level\u2014whether you need automated verification, human review, or reference-only documentation."},"files":[{"bytes":13230,"path":"skills/adr-author/SKILL.md","sha256":"99e9b6d9173cd41fee6cf8051c5dedd69e229a7afdb96685a25a8489b26998ac","url":"https://skillfed.io/files/delexw/claude-code-misc/adr-author/4b1e8204/SKILL.md"}],"id":"delexw/claude-code-misc/adr-author","links":{"html":"https://skillfed.io/delexw/claude-code-misc/adr-author","md":"https://skillfed.io/delexw/claude-code-misc/adr-author.md","repo":"https://github.com/delexw/claude-code-misc"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":0,"language":"HTML","last_updated":"2026-03-28","license":"MIT","name":"adr-author","publisher":"delexw","stars":1},"relations":{"categories":["architecture","documentation","governance"],"similar":[{"id":"product-on-purpose/pm-skills/develop-adr"},{"id":"affaan-m/ECC/architecture-decision-records"},{"id":"yonatangross/orchestkit/architecture-decision-record"},{"id":"tech-leads-club/agent-skills/create-adr"},{"id":"codestable/CodeStable/cs-domain"},{"id":"JosiahSiegel/claude-plugin-marketplace/doc-diagnostic"},{"id":"microsoft/hve-core/adr-author"},{"id":"JosiahSiegel/claude-plugin-marketplace/adr-drafting"},{"id":"FlorianBruniaux/claude-code-ultimate-guide/start"},{"id":"giuseppe-trisciuoglio/developer-kit/adr-drafting"}]},"slug":{"owner":"delexw","repo":"claude-code-misc","skill":"adr-author"},"version":"4b1e8204"}