architecture

Guide architecture decisions with ADR documentation and trade-off analysis.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/Arbab1308/BrownlandBL-2 --skill architecture-arbab1308
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/Arbab1308/BrownlandBL-2/tree/main/.agent/skills/architecture
Command: npx skills add https://github.com/Arbab1308/BrownlandBL-2 --skill architecture-arbab1308

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architectural decisions are complex and require traceable rationale, trade-off analysis, and structured documentation to align teams and future changes.

Core Features & Use Cases

  • ADR-driven decision recording and rationale
  • Requirements-driven architecture analysis benchmarks
  • Pattern and reference guidance for common design decisions
  • Use Case: Evaluate a new service boundary using ADR templates and decision records

Quick Start

Describe your system goals and constraints to begin architecture analysis.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I document architectural decisions and trade-offs?

Document architectural decisions by creating Architecture Decision Records (ADRs) that capture context, options, and consequences. This ensures traceable rationale and structured documentation to align teams and manage future system changes.

What is an ADR and when do I need one for software architecture?

An ADR is an Architecture Decision Record used to log design decisions, rationale, and trade-offs. You need an ADR when evaluating service boundaries or making significant pattern choices to ensure decisions are traceable and aligned across teams.

How do I analyze requirements for architecture design?

Analyze requirements for architecture design by evaluating system goals and constraints against established patterns. This requirements-driven analysis provides benchmarks to guide trade-off evaluation and structured decision-making across projects.

Does this architecture analysis approach work for evaluating new service boundaries?

Yes, evaluating new service boundaries is a core use case supported by architecture analysis. You can use ADR templates and decision records to document the context, options, and consequences of the proposed service boundary.

What is the best way to track architecture decisions across multiple projects?

The best way to track architecture decisions across projects is by maintaining consistent ADR documentation. Logging decisions with their context, options, and consequences ensures traceable rationale and structured alignment for future changes.

How do I structure an ADR for pattern and reference guidance?

Structure an ADR using sections for context, options, and consequences to provide pattern and reference guidance. This format records the rationale and trade-offs evaluated, ensuring the architectural decision is traceable and comprehensive.