architecture-decisions

Implement Architecture Decision Records and analyze system boundaries for scalability.

2|Updated Jun 30, 2026
One-click install
npx skills add https://github.com/Canhada-Labs/ceo-orchestration --skill architecture-decisions-canhada-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-decisions
Source: https://github.com/Canhada-Labs/ceo-orchestration/tree/main/.claude/skills/core/architecture-decisions
Command: npx skills add https://github.com/Canhada-Labs/ceo-orchestration --skill architecture-decisions-canhada-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps in making informed architectural decisions by following structured processes and guidelines, ensuring scalability and maintainability.

Core Features & Use Cases

  • Architecture Decision Records (ADR) Management: Document and track architectural decisions with ADRs.
  • Scalability Testing: Apply the 10x scale rule to ensure designs can handle growth.
  • System Boundary Analysis: Define and analyze system boundaries for better componentization.

Quick Start

Create a new architecture decision using the 'architecture-decisions' skill and follow the ADR template provided.

Frequently Asked Questions about architecture-decisions

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

FAQPage Schema
What is an Architecture Decision Record and when do I need one for system design?

An Architecture Decision Record (ADR) documents architectural choices to ensure maintainability. You need ADRs when making structural decisions that impact system boundaries, scalability, and long-term software design integrity.

How do I document software design decisions using ADR templates?

To document software design decisions, create a new architecture decision using the provided ADR template. Follow the structured guidelines to record context, decision details, and enforce system boundary analysis.

How does the 10x scale rule test architecture scalability?

The 10x scale rule tests architecture scalability by evaluating whether current software designs can handle ten times the current load. This analysis ensures system boundaries and componentization support future growth.

Do I need prior system design knowledge to analyze system boundaries?

Yes, you need ADR and system design knowledge to effectively analyze system boundaries. The process requires understanding blast radius analysis and architectural integrity to properly define componentization rules.

What is the best way to govern architectural integrity across a software project?

The best way to govern architectural integrity is by implementing Architecture Decision Records alongside blast radius analysis and system boundary enforcement. This structured approach ensures decisions align with scalability rules.

What are the limitations of using ADRs for system boundary analysis?

ADRs for system boundary analysis are limited by their reliance on existing system design knowledge. Without proper architectural context, documenting decisions and analyzing blast radius may not prevent scalability issues effectively.