Documentation//Architecture
🛤️

Architecture

Agents specialized in system architecture and solution design. Focuses on scalability, design patterns, and architectural decisions.

Installation

First, install the Han CLI tool:

npm install -g @thebushidocollective/han

Then install the plugin:

han plugin install do-architecture

Overview

Agents specialized in system architecture and solution design. Focuses on scalability, design patterns, and architectural decisions.

Agents

This plugin provides the following specialized agents:

  • Solution Architect
  • System Architect

Usage

Agents can be invoked using the Agent tool or through natural conversation:

Use the Solution Architect to analyze...

Each agent brings specialized expertise and perspective to their domain.

License

Licensed under MIT - see repository for details.

Agents

🤖

solution-architect

Use this agent for solving specific technical problems with architectural patterns and technology-agnostic recommendations . This agent analyzes requirements, recommends patterns, and provides architectural guidance for specific features or challenges . Use when you need pattern recommendations for a specific problem, not full system architecture design . Examples: <example>Context: Need to handle file uploads efficiently. user: 'How should we architect file upload handling for large files (up to 5GB)?' assistant: 'I'll use solution-architect to analyze requirements, evaluate patterns (chunked upload, resumable upload, direct-to-storage), and recommend an architecture with rationale and trade-offs.' <commentary>This is a specific problem requiring pattern selection and architectural guidance.</commentary></example> <example>Context: Need to improve search performance . user: 'Our search is slow. What architectural approach should we use?' assistant: 'Let me use solution-architect to analyze the search problem, evaluate solutions (full-text search, Elasticsearch, read replicas, caching), and recommend an approach based on your scale and requirements.' <commentary>Specific problem requiring architectural solution recommendation.</commentary></example>

🤖

system-architect

Use this agent for system architecture design and evaluation. This agent focuses on architectural patterns, quality attributes, system design principles, and architectural decision-making . Use when you need to design system architecture, evaluate architectural trade-offs, or create architectural decision records . Examples: <example>Context: Need to design a new microservices-based system. user: 'We need to design the architecture for a distributed event processing system that handles 100K events/second' assistant: 'I'll use system-architect to analyze quality attribute requirements (scalability, performance, reliability), evaluate architectural patterns (event sourcing, CQRS, stream processing), and create an architectural blueprint with ADRs.' <commentary>This requires architectural thinking about patterns, trade-offs, and quality attributes.</commentary></example> <example>Context: Evaluating architectural options for a new feature . user: 'Should we use event-driven architecture or REST APIs for our notification system?' assistant: 'Let me use system-architect to evaluate both approaches against quality attributes, analyze trade-offs (consistency vs availability, coupling vs performance), and recommend the appropriate pattern with rationale.' <commentary>This is an architectural decision requiring trade-off analysis.</commentary></example>