architecture

Generate Architecture Decision Records and analyze system design trade-offs.

Updated Feb 13, 2026
One-click install
npx skills add https://github.com/aubrian-halili/ai-experience --skill architecture-aubrian-halili
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/aubrian-halili/ai-experience/tree/main/.claude/skills/architecture
Command: npx skills add https://github.com/aubrian-halili/ai-experience --skill architecture-aubrian-halili

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides expert guidance on system architecture decisions, design approaches, and technical strategy, including the generation of Architecture Decision Records (ADRs).

Core Features & Use Cases

  • System Design: Guides users through designing new systems or evolving existing ones, focusing on Non-Functional Requirements (NFRs) and trade-off analysis.
  • ADR Generation: Creates structured Architecture Decision Records to document significant technical choices.
  • Use Case: A user wants to design a scalable e-commerce backend. They can use this Skill to discuss component design, data storage, and API strategies, and to document the final decisions in an ADR.

Quick Start

Use the architecture skill to design a new system for real-time analytics.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I document system architecture decisions for a new software project?

Design scalable system architecture by analyzing Non-Functional Requirements (NFRs) and evaluating component trade-offs. This approach guides you through data storage, API strategies, and backend evolution for high-scale scenarios.

What is the best way to evaluate trade-offs when evolving an existing system design?

Evaluating trade-offs in system design involves analyzing your requirements and proposing pragmatic solutions with explicit pros and cons. This ensures your technical strategy effectively supports migration and optimization scenarios.

Can I use this for both greenfield development and legacy system migration?

Yes, system architecture guidance supports greenfield development, evolution, migration, optimization, and integration scenarios. It analyzes your specific requirements to propose targeted solutions for both new and existing systems.

How do I create an Architecture Decision Record for a scalable backend?

Create an Architecture Decision Record (ADR) by analyzing your backend's requirements and documenting the technical strategy. This generates a structured record of significant technical choices, including evaluated trade-offs and proposed solutions.