
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-codeInstalls 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
| Size | Recommended 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