designing-architecture

Evaluate software architecture patterns with trade-off analysis and decision criteria.

1.4k|186|Updated Jan 1, 2026
One-click install
npx skills add https://github.com/CloudAI-X/claude-workflow-v2 --skill designing-architecture-cloudai-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: designing-architecture
Source: https://github.com/CloudAI-X/claude-workflow-v2/tree/main/skills/designing-architecture
Command: npx skills add https://github.com/CloudAI-X/claude-workflow-v2 --skill designing-architecture-cloudai-x

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designers and engineers often struggle to select appropriate architecture patterns and structure projects effectively. This Skill provides a clear framework to guide architecture decisions across various project types.

Core Features & Use Cases

  • Architecture pattern guidance: outlines Layered, Clean, Hexagonal, Event-Driven, and CQRS patterns with decision criteria.
  • Directory structure guidance: suggests scalable layouts and module organization for different project sizes.
  • Decision framework: offers criteria for simplicity, scalability, maintainability, and trade-off analysis.
  • Use Case: helps a small team choose between Monolith and Modular Monolith for a medium-sized application.

Quick Start

Use designing-architecture to frame architectural decisions in your next project and compare patterns for your system design.

Frequently Asked Questions about designing-architecture

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

FAQPage Schema
How do I choose between monolithic and microservices architecture for my project?

Monolithic and microservices architectures serve different scales and team structures. Monoliths suit smaller teams and tightly-coupled domains; microservices enable independent deployment and scaling but add operational complexity. Use the decision framework to evaluate simplicity, scalability, and maintainability trade-offs for your system size and growth projections.

What are the main software architecture patterns and when should I use each one?

Layered, Clean, Hexagonal, Event-Driven, and CQRS patterns each optimize for different quality attributes. Layered architecture emphasizes simplicity; Clean and Hexagonal isolate business logic; Event-Driven handles asynchronous workflows; CQRS separates read and write models. The Skill outlines decision criteria for each pattern based on your system requirements.

How should I organize my project directory structure for a scalable application?

Directory structure depends on project size and complexity. The Skill suggests layouts for small, medium, and large projects with module organization strategies that support maintainability and team collaboration. Proper structure prevents bottlenecks as codebases grow and teams expand.

What trade-offs should I consider when selecting an architecture pattern?

Architecture patterns balance competing concerns: simplicity versus scalability, maintenance overhead versus deployment flexibility, and team coordination costs. The decision framework analyzes trade-offs across these dimensions so you can prioritize what matters most for your constraints and goals.

Can I use a modular monolith as a middle ground between monolith and microservices?

Yes, modular monoliths combine monolithic deployment with internal module boundaries, deferring microservices migration. This approach suits teams needing scalability and maintainability without full distributed-system complexity. The Skill helps evaluate whether this fits your team size, application domain, and growth timeline.