architecture-designer

Design high-level system architecture with diagrams and Architecture Decision Records.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/shalevamin/The-_Ultimate_agents --skill architecture-designer-shalevamin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-designer
Source: https://github.com/shalevamin/The-_Ultimate_agents/tree/main/.claude/skills/architecture-designer
Command: npx skills add https://github.com/shalevamin/The-_Ultimate_agents --skill architecture-designer-shalevamin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the complexity of designing robust, scalable, and maintainable software systems by providing a structured approach to architectural decision-making and documentation.

Core Features & Use Cases

  • Architecture Design: Create high-level system diagrams and component interactions.
  • ADR Authoring: Generate Architecture Decision Records to document key choices and trade-offs.
  • Technology Evaluation: Assess and select appropriate technologies based on requirements.
  • Use Case: When starting a new microservices project, use this Skill to define the core services, their communication patterns, and document the decision to use Kafka for inter-service communication via an ADR.

Quick Start

Use the architecture-designer skill to design a scalable e-commerce backend system, including a diagram and ADRs for key decisions.

Frequently Asked Questions about architecture-designer

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

FAQPage Schema
How do I design and document high-level system architecture for a new microservices project?

To design system architecture for microservices, you create high-level component diagrams and generate Architecture Decision Records (ADRs) to document key technology trade-offs, communication patterns, and non-functional requirements.

What is an Architecture Decision Record and when do I need one for system design?

An Architecture Decision Record (ADR) is a document capturing key architectural choices and trade-offs. You need ADRs when evaluating technology selections, planning for scalability, or finalizing infrastructure patterns to ensure maintainable system design.

Can I use this to evaluate technology trade-offs and select infrastructure patterns for scalability?

Yes, you can evaluate technology trade-offs and select infrastructure patterns for scalability. The process facilitates architectural decision-making by assessing appropriate technologies based on your specific non-functional requirements and project constraints.

What's the best way to structure microservices and define their communication patterns?

The best way to structure microservices is by defining core services and their communication patterns during high-level system design. This involves mapping component interactions and documenting inter-service communication choices using ADRs.

How do I plan for non-functional requirements during architecture review?

You plan for non-functional requirements during architecture review by evaluating system scalability, assessing technology trade-offs, and documenting infrastructure pattern selections to ensure the high-level system design remains robust and maintainable.