{"enrichment":{"faq":[{"a":"architecture-decision-record provides templates and guidance for creating ADRs using the Nygard format. Start by capturing the context (the issue or problem), then state your decision clearly, document the consequences (both positive and negative), and list alternatives you considered. Include the decision status and date. This lightweight approach preserves your reasoning and helps teams understand why technical choices were made.","q":"How to write architecture decision records?"},{"a":"architecture-decision-record guides you to document each alternative you evaluated before choosing your decision. For each option, briefly describe what it is, note its key trade-offs, and explain why you rejected it or chose another instead. This section is crucial for future readers\u2014it shows the thinking process and prevents revisiting dismissed options without good reason.","q":"What should the ADR alternatives considered section include?"},{"a":"architecture-decision-record recommends creating an ADR whenever you make a significant architectural decision\u2014choices about technology, design patterns, or system structure that will shape your codebase's future. Create one when evaluating trade-offs, establishing team consensus on tech choices, or recording decisions that affect multiple teams or long-term maintenance.","q":"When should I create an ADR?"},{"a":"architecture-decision-record supports status workflow throughout a decision's life: from proposal through acceptance to supersession. Each ADR records when it was created, who decided, and its current status. When a decision is later replaced, you can link the new ADR to the old one, maintaining a complete history that helps onboarding and prevents losing context about why systems evolved.","q":"How does architecture-decision-record help track decision lifecycle?"},{"a":"architecture-decision-record emphasizes documenting both positive and negative consequences of your choice. Consequences include impacts on performance, maintainability, team skills, deployment complexity, and future flexibility. Tradeoffs show what you gained versus what you sacrificed\u2014for example, choosing a simpler framework might reduce learning curve but limit scalability. Recording these helps teams make informed decisions later.","q":"What are architectural decision consequences and tradeoffs?"},{"a":"architecture-decision-record helps you maintain architectural history and decision rationale for onboarding and reference. Without ADRs, new team members must reverse-engineer why systems are built a certain way. ADRs preserve context, prevent repeating past mistakes, establish team consensus on design patterns, and create a searchable record that answers 'why was this choice made?' years later.","q":"Why document architectural decisions with ADRs?"}],"shadow_tags":["decision-capture","architectural-memory","tech-rationale","design-governance","team-alignment","tradeoff-documentation","decision-lifecycle","context-preservation","implementation-tracking","stakeholder-review"],"summary_rewrite":"This skill provides templates and guidance for creating Architecture Decision Records\u2014lightweight documents that preserve the reasoning behind major technical choices. It walks you through the Nygard format, covering context, decision, consequences, and alternatives, plus best practices for lifecycle management and team review. Use it when evaluating trade-offs or recording decisions that shape your system's future."},"files":[{"bytes":8318,"path":"src/skills/architecture-decision-record/SKILL.md","sha256":"ba5d4bb3aa82b08de8938fbb61070aa236fa74a2c829f68ae7fa1eaaa13ec738","url":"https://skillfed.io/files/yonatangross/orchestkit/architecture-decision-record/9e910a6b/SKILL.md"}],"id":"yonatangross/orchestkit/architecture-decision-record","links":{"html":"https://skillfed.io/yonatangross/orchestkit/architecture-decision-record","md":"https://skillfed.io/yonatangross/orchestkit/architecture-decision-record.md","repo":"https://github.com/yonatangross/orchestkit"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":20,"language":"TypeScript","last_updated":"2026-07-28","license":"MIT","name":"architecture-decision-record","publisher":"yonatangross","stars":208},"relations":{"categories":["architecture","documentation","decision-making"],"similar":[{"id":"yonatangross/orchestkit/documentation-patterns"},{"id":"tech-leads-club/agent-skills/create-adr"},{"id":"affaan-m/ECC/architecture-decision-records"},{"id":"wshobson/agents/architecture-decision-records"},{"id":"JosiahSiegel/claude-plugin-marketplace/doc-diagnostic"},{"id":"majesticlabs-dev/majestic-marketplace/create-adr"},{"id":"delexw/claude-code-misc/adr-author"},{"id":"product-on-purpose/pm-skills/develop-adr"},{"id":"codestable/CodeStable/cs-domain"},{"id":"lyndonkl/claude/adr-architecture"}]},"slug":{"owner":"yonatangross","repo":"orchestkit","skill":"architecture-decision-record"},"version":"9e910a6b"}