architecture

Document architecture decisions with context, trade-offs, and design patterns.

1|Updated Jun 23, 2026

Search Tags:#architecture #system design #design patterns #decision-making #context discovery

Ready to run

npx skills add https://github.com/phuonghx/aim-cli --skill architecture-phuonghx

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/phuonghx/aim-cli/tree/main/aim/templates/aim-agents/skills/architecture
Command: npx skills add https://github.com/phuonghx/aim-cli --skill architecture-phuonghx

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill aids in structuring and documenting architecture decisions, ensuring clarity in system design and maintaining a comprehensive record of reasoning.

Core Features & Use Cases

Decision Framework: Offers a structured approach to making architecture decisions, considering requirements, trade-offs, and decision records.
Context Discovery: Helps gather and organize context essential for effective design, including scale, team, timeline, and domain specifics.
Pattern Selection: Provides guidance on selecting appropriate design patterns for different scenarios and architectures.
Trade-off Analysis: Assists in documenting decisions with their trade-offs, ensuring that each choice is justified and understood.
Use Case: When planning the architecture for a large-scale system, this Skill can help in deciding between monolithic and microservices architectures based on specific project requirements.

Quick Start

Start the architecture decision-making process by running 'architecture discover' to gather context for your project.

Frequently Asked Questions about architecture

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

FAQPage Schema

How do I document architecture decisions for complex system design?▼

Document architecture decisions by gathering project context, analyzing trade-offs, selecting design patterns, and recording the structured reasoning to ensure clarity in system design. This provides a comprehensive record of why specific choices were made.

What's the best way to decide between monolithic and microservices architectures?▼

Decide between monolithic and microservices architectures by gathering essential context like scale, team size, timeline, and domain specifics. Analyzing these project requirements against documented trade-offs guides the selection of the appropriate structure.

How does context discovery work for system design?▼

Context discovery for system design works by gathering and organizing essential project parameters including scale, team dynamics, timelines, and domain specifics. Running a context discovery process ensures effective architectural planning by surfacing all relevant constraints.

How do I select appropriate design patterns for different software architectures?▼

Select appropriate design patterns by evaluating your gathered project context against specific architectural scenarios. The framework provides guidance on matching design patterns to different situations to ensure the chosen structure aligns with your requirements.

When should I use a structured architecture decision-making framework?▼

Use a structured architecture decision-making framework when planning large-scale or complex systems where clarity is essential. It is needed when you must justify choices and maintain a comprehensive record of reasoning for trade-offs and pattern selection.