architecture-design

Map business goals to high-level system structure and technology choices.

187|20|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/TheBushidoCollective/han --skill architecture-design-thebushidocollective
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-design
Source: https://github.com/TheBushidoCollective/han/tree/main/core/skills/architecture-design
Command: npx skills add https://github.com/TheBushidoCollective/han --skill architecture-design-thebushidocollective

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides high-level system design decisions, component boundaries, and long-term strategy.

Core Features & Use Cases

  • Context & Requirements: Align architecture with business goals and non-functional requirements.
  • Pattern & Boundary Decisions: Define clear interfaces and module boundaries.
  • Trade-offs & Alternatives: Consider options with rationale and impact.

Quick Start

Outline a high-level system diagram and outline 3 key components with responsibilities and interactions.

Frequently Asked Questions about architecture-design

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

FAQPage Schema
How do I design a scalable system architecture from scratch?

System architecture design maps business goals and technical requirements to high-level component structure, defining clear boundaries, interfaces, and technology choices. Start by outlining key components, their responsibilities, and how they interact to meet functional and non-functional requirements.

What are the trade-offs between different architectural patterns?

Architectural patterns—like monolithic, microservices, and layered designs—each offer distinct trade-offs in scalability, complexity, deployment, and maintainability. Evaluating patterns involves weighing these trade-offs against your system's business goals, team capacity, and long-term operational needs.

How do I define clear component boundaries in a system?

Clear boundaries emerge from identifying components' distinct responsibilities, defining their interfaces, and specifying how they interact. Well-defined boundaries reduce coupling, enable independent scaling and deployment, and make systems easier to understand and modify.

When should I reconsider my system's architecture?

Reconsider architecture when business goals shift, performance constraints emerge, team structure changes, or existing patterns create bottlenecks. Strategic architecture review captures these constraints and risks to guide evolution without disrupting implementation.

How do I document architecture decisions for a handoff to implementation?

Architecture documentation captures the high-level system structure, component interactions, technology selections with rationale, identified constraints, and known risks. This documentation enables engineering teams to implement consistently and make informed trade-offs during development.

Do I need to align architecture with business strategy?

Yes. Resilient, scalable architecture depends on alignment between business goals and system design. Non-functional requirements like performance, availability, and security derive from business strategy and must guide component design and technology choices.