Clean Architecture Powerup
Part of Claude Code Powerups - a marketplace of specialized plugins that extend Claude Code's capabilities.
An opinionated toolkit for building production-ready .NET Clean Architecture applications with FastEndpoints, Repository pattern, and Domain-Driven Design.
Overview
Clean Architecture Powerup is a comprehensive Claude Code plugin that helps you build, migrate, and maintain .NET applications following Clean Architecture principles. Based on Microsoft's eShopOnWeb reference application, it provides expert guidance, code generation, and architecture validation.
⚡ Opinionated Skill: This is an opinionated toolkit specifically designed for .NET/C# applications. It prescribes a specific approach to Clean Architecture using FastEndpoints, Repository pattern, Specification pattern, and Domain-Driven Design principles. If you're looking for language-agnostic architecture guidance or other tech stacks, this plugin may not be the best fit.
Perfect for:
- .NET developers building Clean Architecture applications
- Teams migrating legacy code to modern architecture patterns
- Architects seeking pattern guidance and code reviews
- Developers learning Clean Architecture and Domain-Driven Design
Features
🏗️ Project Scaffolding
Scaffold complete Clean Architecture solutions from scratch with interactive wizard:
- Choose your API style: FastEndpoints, Minimal APIs, or Controllers
- Select database: SQL Server, PostgreSQL, or In-Memory
- Configure authentication: JWT, ASP.NET Identity, or None
- Auto-configure project structure, dependencies, and references
⚡ Feature Generation
Generate complete CRUD features across all layers in minutes:
- Domain entities with proper encapsulation and business logic
- Repository interfaces and implementations
- Specification pattern for complex queries
- Service layer with Result pattern
- API endpoints with validation
- Unit and integration tests
🔄 Legacy Migration
Migrate existing codebases to Clean Architecture with guided refactoring:
- Architecture analysis and violation detection
- Layer separation guidance
- Dependency inversion recommendations
- Step-by-step migration plan
🔍 Architecture Auditing
Scan your project for architecture violations and anti-patterns:
- Dependency rule violations
- Missing abstractions
- Improper layer coupling
- Anti-patterns and code smells
- Actionable fix suggestions
📚 Pattern Library
Browse and copy 14 proven Clean Architecture patterns:
- Repository Pattern with generic base
- Specification Pattern for queries
- Domain Events with MediatR
- Result Pattern for operation outcomes
- Guard Clauses for validation
- Test Data Builders
- And more...
Installation
From GitHub
claude plugin marketplace add waelouf/cc-powerup-clean-architecture
claude plugin install clean-architecture-powerup
Local Development
- Clone this repository:
git clone https://github.com/waelouf/cc-powerup-clean-architecture.git
cd cc-powerup-clean-architecture
- Link the plugin:
claude-code plugin link .
Usage
Slash Commands
The plugin provides 5 powerful slash commands:
/clean-arch:new - Scaffold New Project
Create a new Clean Architecture solution with interactive wizard.
/clean-arch:new
# or with project name
/clean-arch:new MyProject
/clean-arch:add-feature <EntityName> - Generate CRUD Feature
Generate a complete CRUD feature across all layers.
/clean-arch:add-feature Product
/clean-arch:add-feature Order
/clean-arch:add-feature Customer
/clean-arch:migrate - Migrate Legacy Code
Analyze and migrate existing codebase to Clean Architecture.
/clean-arch:migrate
/clean-arch:audit - Audit Architecture
Scan for violations and anti-patterns with actionable fixes.
/clean-arch:audit
/clean-arch:patterns - Browse Patterns
Interactive pattern library with 14 proven examples.
/clean-arch:patterns
Automatic Skill Invocation
The clean-architecture skill is automatically invoked during conversations when you discuss Clean Architecture topics:
- Architecture design and planning
- Code reviews for Clean Architecture projects
- Troubleshooting architecture issues
- Learning Clean Architecture concepts
Quick Start Example