architecture-decision

Name: architecture-decision
Availability: InStock
Author: carlosq96

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

Ready to run

npx skills add https://github.com/CarlosQ96/robot-crawler --skill architecture-decision-carlosq96

💬 Prompt for ChatGPT / Claude Chat▼

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.