cloudai-x avatar

Designing Architecture

This one gives you a structured framework for making architecture decisions instead of just winging it. You get pattern selection guides based on team size and codebase scale, visual diagrams for common approaches like Clean Architecture and CQRS, and a decision template that forces you to document trade-offs. The feature-based vs layer-based directory structures are opinionated but sensible. What I like is the validation checklist at the end, it catches the common mistake of picking microservices for a three-person team. Best used when starting new projects or refactoring existing ones where you need to justify your choices to teammates or future you.

skills.sh installs
249
GitHub stars
1.4K
last updated
Aug 21, 2026

Install

$ npx -y skills add cloudai-x/claude-workflow-v2 --skill designing-architecture --agent claude-code

Installs into .claude/skills of the current project.

Files

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

Sponsors

Details

Repository
github.com/cloudai-x/claude-workflow-v2
Categories
Code Review & Quality, Automation & Workflows
License
MIT
First seen
Jun 3, 2026

More from cloudai-x/claude-workflow-v2

All 14
1longranger2 avatarplan-reviewlongranger2/claude-gpt-workflowUse when the user says "/plan-review", "plan review", or "PRD review" and provides a plan file path that needs critical review and iterative refinement with Cod247skills.sh installs
2rysweet avatarpm-architectrysweet/amplihackExpert project manager orchestrating backlog-curator, work-delegator, workstream-coordinator, and roadmap-strategist sub-skills. Coordinates complex software pr245skills.sh installs
3sickn33 avatarperformance-testing-review-ai-reviewsickn33/antigravity-awesome-skillsperformance testing review ai review244skills.sh installs
4guia-matthieu avatarnaming-6-gatesguia-matthieu/clawfu-skillsUse when creating brand names, product names, or company names in 2026. Use when naming needs to work across languages, voice assistants, and AI recommendation 239skills.sh installs
5plugins-world avatarpw-embedded-c-styleplugins-world/pw-skills嵌入式 C 代码风格助手, 基于 51 单片机教学项目的代码规范。默认使用蛇形命名 (snake_case), 可选驼峰命名。用于创建符合嵌入式开发规范的项目结构, 优化代码风格, 提供硬件驱动模板。适用于 51 单片机、STM32 等嵌入式 C 项目开发。239skills.sh installs
6meleantonio avatarlit-review-assistantmeleantonio/awesome-econ-ai-stuffSearch, summarize, and synthesize economics literature238skills.sh installs