skills.rest
BridgingIT-GmbH
BridgingIT-GmbHOFFICIAL
Explore all skills by this author →
GitHub

adr-architecture

Create Architecture Decision Records with context, alternatives, and consequences.

7|4|Updated Dec 12, 2023
Search Tags:#architecture#templates#documentation#adr#governance#design-decision
One-click install
npx skills add https://github.com/BridgingIT-GmbH/bITdevKit --skill adr-architecture-bridgingit-gmbh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adr-architecture
Source: https://github.com/BridgingIT-GmbH/bITdevKit/tree/main/.agents/skills/adr-architecture
Command: npx skills add https://github.com/BridgingIT-GmbH/bITdevKit --skill adr-architecture-bridgingit-gmbh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions are difficult to justify and reuse without a clear, discoverable record. ADRs provide a structured trail of context, alternatives considered, decisions made, and consequences for future teams and audits.

Core Features & Use Cases

  • Standard ADR Template: A consistent, portable format to capture metadata, context, options, decisions, and outcomes.
  • Advanced Workflows: Guidance for complex decisions using templates, methodologies, stakeholder management, and quantitative analysis.
  • Quality Guardrails: Integrated checklists and a quality rubric to ensure durable, repeatable decisions.

Quick Start

Draft an ADR following the standard format to document a significant architectural decision.

Frequently Asked Questions about adr-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document architecture decisions to capture context and trade-offs?▼

Architecture decision records provide a structured template to document context, alternatives, decisions, and consequences. You capture metadata, stakeholder input, and rationale to ensure technical decisions are discoverable and justified for future teams.

What is an ADR and when do I need to create one?▼

An ADR is an architecture decision record used to document significant technical choices. You need to create one for technology selections, migrations, standards, and infrastructure changes to provide a discoverable trail for audits and future teams.

How do I write an architecture decision record for enterprise-scale migrations?▼

Drafting an architecture decision record for enterprise migrations uses advanced workflows with stakeholder management and quantitative analysis. The standard template includes context, alternative analysis, quantified consequences, and review steps to handle complex governance requirements.

Can I use a standard ADR template for single-team technical decisions?▼

Yes, the standard architecture decision record template is portable and suitable for both single-team and enterprise-scale technical decisions. It ensures durable, repeatable outcomes through integrated quality checklists and a quality rubric for consistent documentation.

What is the best way to ensure architecture decisions pass governance reviews?▼

To pass governance reviews, document architecture decisions using a process-ready template that includes stakeholders, alternative analysis, and quantified consequences. Integrated quality guardrails and checklists ensure the record meets structured context and audit requirements.

Does this ADR workflow include stakeholder management and quantitative analysis?▼

Yes, advanced architecture decision record workflows include guidance for stakeholder management and quantitative analysis. These methodologies support complex decisions by providing structured alternative analysis and quantified consequences within the standard documentation template.

Related Skills

Explore More Software Engineering Skills→
pluginagentmarketplacepluginagentmarketplace
3

technical-decision-making

Generate technical decision documents with evaluation frameworks and action plans.

Community
Advanced
HMWKRHMWKR

cantos-write

Generate standardized Cantos Architecture Decision Records and Design Decision Records.

Community
Basic
JaviMontanoJaviMontano

apex-communication-plan

Generate a project communication plan with stakeholder matrices, cadences, channels, and templates.

Community
Advanced
provenimpactprovenimpact

needs-adr

Record and manage Architecture Decision Records with lifecycle and index.

Official
Advanced