skills.rest
CarlosQ96
CarlosQ96COMMUNITY
Explore all skills by this author →
GitHub

architecture-decision

Generates Architecture Decision Records with rationale, trade-offs, and outcomes from user input.

Updated Apr 9, 2026
Search Tags:#architecture#documentation#adr#governance#system-design#decision-record
One-click install
npx skills add https://github.com/CarlosQ96/robot-crawler --skill architecture-decision-carlosq96
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-decision
Source: https://github.com/CarlosQ96/robot-crawler/tree/main/.agents/skills/architecture-decision
Command: npx skills add https://github.com/CarlosQ96/robot-crawler --skill architecture-decision-carlosq96

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions are often under-documented and hard to track across teams, leading to inconsistent implementations and misalignment.

Core Features & Use Cases

  • ADR generation: Create a structured Architecture Decision Record with context, alternatives, and consequences.
  • Traceability: Link ADRs to related GDDs and other ADRs to maintain a decision history.
  • Collaboration: Integrates with governance workflows, prompts for reviews from specialists, and suggests next steps.

Quick Start

Provide a short ADR title and a paragraph describing the decision context to begin drafting.

Frequently Asked Questions about architecture-decision

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

FAQPage Schema
How do I document architecture decisions to maintain traceability across teams?▼

You can document architecture decisions by generating an Architecture Decision Record (ADR) that captures context, alternatives, and consequences. This ensures traceability and cross-team alignment for major technical choices.

What should be included in an Architecture Decision Record for system design?▼

An Architecture Decision Record should include the issue, available options, the final decision, and a migration or validation plan. It also captures the rationale and consequences to guide engineers during implementation.

How do I start drafting an ADR for a major technical choice?▼

To begin drafting an ADR, provide a short title and a paragraph describing the decision context. This initial input is used to generate the structured record with its options and validation plan.

Can I link architecture decision records to other governance documents?▼

Yes, you can link ADRs to related GDDs and other ADRs to maintain a comprehensive decision history. This integration supports governance workflows and prompts for specialist reviews.

Why does inconsistent implementation happen across engineering teams?▼

Inconsistent implementation occurs because architecture decisions are often under-documented and hard to track. Using ADRs to capture rationale and consequences resolves this misalignment.

Related Skills

Explore More Software Engineering Skills→
mvillmowmvillmow
18

doc-generate-adr

Generate Architecture Decision Records with structured Context, Decision, Rationale, and Consequences.

Community
Basic
Tonybleything76Tonybleything76

cto-advisor

Provide strategic guidance and tools for CTOs to manage technical debt and scale teams.

Community
Advanced
jmaglyjmagly
175

architecture-evolution

Analyze architecture change impact and generate ADRs and migration plans.

Community
Advanced
pratikrath126pratikrath126
42

architecture

Organize architecture decisions using structured ADR templates and decision records.

Community
Advanced