Skills

Designing Architecture

Designs software architecture and selects appropriate patterns for projects.

Install

npx skills add CloudAI-X/claude-workflow-v2 --skill designing-architecture -g -a claude-code -y
Category
Design
Updated
29d ago
License
MIT
Context cost
Lightabout 1,370 tokens
Runs scripts
No, instructions only

What it does

Designs software architecture and selects appropriate patterns for projects. Use when designing systems, choosing architecture patterns, structuring projects, making technical decisions, or when asked about microservices, monoliths, or architectural approaches.

Designing Architecture

When to Load

  • Trigger: System design, module structure, new project scaffolding, choosing architecture patterns
  • Skip: Simple bug fixes or minor code changes that don't affect architecture

Architecture Decision Workflow

Copy this checklist and track progress:

Architecture Design Progress:
- [ ] Step 1: Understand requirements and constraints
- [ ] Step 2: Assess project size and team capabilities
- [ ] Step 3: Select architecture pattern
- [ ] Step 4: Define directory structure
- [ ] Step 5: Document trade-offs and decision
- [ ] Step 6: Validate against decision framework

Pattern Selection Guide

By Project Size

SizeRecommended Pattern
Small (<10K LOC)Simple MVC/Layered
Medium (10K-100K)Clean Architecture
Large (>100K)Modular Monolith or Microservices

By Team Size

TeamRecommended
1-3 devsMonolith with clear modules
4-10 devsModular Monolith
10+ devsMicroservices (if justified)

Common Patterns

1. Layered Architecture

┌─────────────────────────────┐
│       Presentation          │  ← UI, API Controllers
├─────────────────────────────┤
│       Application           │  ← Use Cases, Services
├─────────────────────────────┤
│         Domain              │  ← Business Logic, Entities
├─────────────────────────────┤
│      Infrastructure         │  ← Database, External APIs
└─────────────────────────────┘

Use when: Simple CRUD apps, small teams, quick prototypes

2. Clean Architecture

Read the whole SKILL.md on GitHub

More in Design