architecture

Identify and codify architectural decisions using ADR templates and trade-off analysis.

Updated Jan 21, 2026

Search Tags:#architecture #documentation #adr #trade-offs #pattern-analysis #design-review #decision-record

Ready to run

npx skills add https://github.com/ollieb89/orchestrator --skill architecture-ollieb89

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/ollieb89/orchestrator/tree/main/.cursor/skills/architecture
Command: npx skills add https://github.com/ollieb89/orchestrator --skill architecture-ollieb89

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architectural decisions drive project risk and complexity; this framework helps teams structure analysis, document rationale, and standardize decision making.

Core Features & Use Cases

ADR templates to capture context, options, decisions, and consequences.
Pattern references and decision trees to guide pattern selection.
Trade-off analysis to compare alternatives and document risks and mitigations.

Quick Start

Review the project context, select an ADR template, and document the first architecture decision in one sentence.

Frequently Asked Questions about architecture

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?▼

An architecture decision record (ADR) codifies context, options, decisions, and consequences. You need ADRs when architectural decisions drive project risk and complexity, requiring structured analysis and documented rationale to standardize decision making.

How do I document architectural trade-offs for my software project?▼

You document architectural trade-offs by using a framework to compare alternatives, identify risks, and record mitigations. This approach applies trade-off analysis to capture the rationale behind your software architecture decisions.

How do I write my first ADR quickly for a new project?▼

To write your first ADR quickly, review the project context, select an ADR template, and document the architecture decision in a single sentence. This structured approach ensures fast capture of context, options, and consequences.

Can I use ADR templates for projects of varying sizes?▼

Yes, you can use ADR templates for projects of varying sizes. The framework supports structured decision records, pattern guidance, and trade-off analysis across diverse software architecture domains, adapting to different project scales.

What is the best way to select an architecture pattern for my application?▼

The best way to select an architecture pattern is using decision trees and pattern references. This framework guides pattern selection by linking knowledge assets and applying trade-off analysis to your specific project context.

How does pattern analysis work for software architecture decisions?▼

Pattern analysis works by applying decision frameworks and references to guide pattern selection. It evaluates trade-offs between architectural alternatives, documenting risks and mitigations to standardize your decision making process.