{"enrichment":{"faq":[{"a":"Architecture Decision Records helps you document and track architectural decisions made during software design. The skill guides you through creating structured records using established conventions and templates, capturing the decision, its context, rationale, and alternatives. Each ADR follows a standardized format to ensure consistency across your project and team.","q":"How do I record architectural decisions?"},{"a":"Architecture Decision Records provides a built-in template that enforces quality standards for your decision documentation. The template ensures one decision per record, includes credible alternatives, and captures the decision's status and rationale. This standardized approach enables team alignment on architectural direction and creates a searchable, reviewable history of why choices were made.","q":"What is an ADR template for software projects?"},{"a":"Architecture Decision Records manages decision lifecycles with status tracking and supersession links. The skill lets you record both prospective decisions (before implementation) and retrospective ones (after the fact), maintaining a durable record that shows how architectural choices evolved. This enables you to maintain a searchable history and understand the reasoning behind each decision.","q":"How can I track architecture decisions over time?"},{"a":"Architecture Decision Records enforces best practices through its built-in validator and guidance. Key practices include documenting one decision per record, considering credible alternatives, capturing clear rationale, and tracking decision status over time. The skill helps establish a standardized format across your team, enabling better collaboration and ensuring architectural decisions are properly documented and justified.","q":"What are ADR best practices?"},{"a":"Architecture Decision Records enables team alignment by creating a structured, standardized record of design choices and their rationale. Teams use it to build a shared understanding of architectural direction, maintain searchable documentation of why decisions were made, and enforce quality standards through validation. This creates a durable reference that supports both current projects and future onboarding.","q":"How does Architecture Decision Records help teams?"}],"shadow_tags":["decision-tracking","design-rationale","documentation-framework","architecture-governance","team-alignment","knowledge-capture","decision-history","design-justification"],"summary_rewrite":"Create and maintain architecture decision records (ADRs) using established conventions, templates, and a built-in validator. The skill guides you through prospective and retrospective record creation, enforces quality standards like one decision per record and credible alternatives, and helps manage decision lifecycles with status tracking and supersession links. Use it to build a durable, reviewable record of why architecturally significant choices were made."},"gist":{"api_url":"https://skillfed.io/api/skills/dirnbauer/webconsulting-skills/architecture-decision-records.json","as_of":"2026-07-27","description":"Architecture Decision Records helps you document and track architectural decisions with structured templates.","install":{"manual":["git clone https://github.com/dirnbauer/webconsulting-skills","cp -r webconsulting-skills ~/.claude/skills/architecture-decision-records"],"primary":"npx skillfed install dirnbauer/webconsulting-skills/architecture-decision-records","version":"37b1cd94"},"kind":"skill","mirror_url":"https://skillfed.io/dirnbauer/webconsulting-skills/architecture-decision-records.md","similar":[{"id":"Mathews-Tom/armory/adr-writer","name":"adr-writer","publisher":"Mathews-Tom/armory","url":"https://skillfed.io/Mathews-Tom/armory/adr-writer"},{"id":"microsoft/hve-core/adr-author","name":"adr-author","publisher":"microsoft/hve-core","url":"https://skillfed.io/microsoft/hve-core/adr-author"}],"title":"Architecture Decision Records by dirnbauer \u2014 SkillFed","use":{"when":["Architecture Decision Records provides a built-in template that enforces quality standards for your decision documentation.","Architecture Decision Records manages decision lifecycles with status tracking and supersession links."]},"what":{"lead":"Architecture Decision Records helps you document and track architectural decisions with structured templates, validation, and supersession tracking.","rest":"Create and maintain architecture decision records (ADRs) using established conventions, templates, and a built-in validator. The skill guides you through prospective and retrospective record creation, enforces quality standards like one decision per record and credible alternatives, and helps manage decision lifecycles with status tracking and supersession links. Use it to build a durable, reviewable record of why architecturally significant choices were made."}},"id":"dirnbauer/webconsulting-skills/architecture-decision-records","install":{"mode":"external","repo":"https://github.com/dirnbauer/webconsulting-skills"},"links":{"html":"https://skillfed.io/dirnbauer/webconsulting-skills/architecture-decision-records","md":"https://skillfed.io/dirnbauer/webconsulting-skills/architecture-decision-records.md","repo":"https://github.com/dirnbauer/webconsulting-skills"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":6,"language":"Shell","last_updated":"2026-07-27","license":"NOASSERTION","name":"Architecture Decision Records","publisher":"dirnbauer","stars":33},"relations":{"categories":["software-architecture","documentation","knowledge-management"],"similar":[{"id":"dirnbauer/webconsulting-skills/grill-with-docs"},{"id":"Mathews-Tom/armory/adr-writer"},{"id":"microsoft/hve-core/adr-author"},{"id":"dirnbauer/webconsulting-skills/improve-codebase-architecture"},{"id":"dirnbauer/webconsulting-skills/handoff"},{"id":"dirnbauer/webconsulting-skills/enterprise-readiness"},{"id":"dirnbauer/webconsulting-skills/typo3-conformance"},{"id":"sipyourdrink-ltd/bernstein/architect"},{"id":"dirnbauer/webconsulting-skills/setup-matt-pocock-skills"},{"id":"dirnbauer/webconsulting-skills/typo3-ddev"}]},"slug":{"owner":"dirnbauer","repo":"webconsulting-skills","skill":"architecture-decision-records"},"version":"37b1cd94"}