Skip to main content
Back to registry

architecture-decision-records

wshobson/agents

Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions.

Installs3
Install command
npx skills add https://github.com/wshobson/agents --skill architecture-decision-records
Security audits
Gen Agent Trust HubPASS
SocketPASS
SnykPASS
About this skill
Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions. An Architecture Decision Record captures: OrderCreated { orderId, customerId, items[], timestamp } OrderItemAdded { orderId, item, timestamp } OrderItemRemoved { orderId, itemId, timestamp } PaymentReceived { orderId, amount, paymentId, timestamp } OrderShipped { orderId, trackingNumber, timestamp } - Making significant architectural decisions - Documenting technology choices - Recording design trade-offs - Onboarding new team members - Reviewing historical decisions - Establishing decision-making processes - Context : Why we needed to make a decision - Decision : What we decided - Consequences : What happens as a result - Write ADRs early - Before implementation starts - Keep them short - 1-2 pages maximum - Be honest about trade-offs - Include real cons - Link related decisions - Build decision graph - Update status - Deprecate when superseded - Don't change accepted ADRs - Write new ones to supersede - Don't skip context - Future readers need background - Don't hide failures - Rejected decisions are valuable - Don't be vague - Specific decisions, specific consequences - Don't forget implementation - ADR without action is waste

Source description provided by the upstream skill listing. Community reviews and install context appear in the sections below.

Community Reviews

Latest reviews

Sign in to review

No community reviews yet. Be the first to review.

Browse this skill in context
FAQ
What does architecture-decision-records do?

Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the context and rationale behind significant technical decisions.

Is architecture-decision-records good?

architecture-decision-records does not have approved reviews yet, so SkillJury cannot publish a community verdict.

What agent does architecture-decision-records work with?

architecture-decision-records currently lists compatibility with Agent compatibility has not been published yet..

What are alternatives to architecture-decision-records?

Skills in the same category include telegram-bot-builder, flutter-app-size, sharp-edges, iterative-retrieval.

How do I install architecture-decision-records?

npx skills add https://github.com/wshobson/agents --skill architecture-decision-records

Related skills

More from wshobson/agents

Related skills

Alternatives in Software Engineering