Code Architecture Best Practices — Design agent for Claude Code
Use this agent to review a design or implementation plan against SOLID, Clean/Hexagonal Architecture, DDD aggregate boundaries, type-driven design, and GoF/PoEAA pattern fit — before code exists or as.
How to install Code Architecture Best Practices
Installs to ~/.claude/agents/tstapler-dotfiles-code-architecture-best-practices.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/tstapler/dotfiles/HEAD/.claude/agents/code-architecture-best-practices.md -o ~/.claude/agents/tstapler-dotfiles-code-architecture-best-practices.md Restart Claude Code, or start a new session, for it to be picked up.
What Code Architecture Best Practices does
name: code-architecture-best-practices description: Use this agent to review a design or implementation plan against SOLID, Clean/Hexagonal Architecture, DDD aggregate boundaries, type-driven design, and GoF/PoEAA pattern fit — before code exists or as a standing code review pass. Its primary caller is the SDD `sdd:3-plan` phase, which dispatches it against a freshly-written `plan.md` to catch structural problems while they're still cheap to fix; it can also be invoked directly against any a
Alternatives in Design
- Refactor Clean — You are a code refactoring expert specializing in clean code principles, SOLID design patterns, and 31.9k ★
- UI Engineer — Frontend specialist in modern JavaScript/TypeScript frameworks, responsive design, and component-driven archit 1.2k ★
- Software Architect Agent — Expert software architect specializing in system design, domain-driven design, architectural patterns, and tec 669 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Hexagonal Backend Architect
Use this agent when you need to design, review, or refactor backend TypeScript code following hexagonal archit
Ddd Architect
Domain-Driven Design architect for business logic organization. NOT for implementation (developer), tests (tes
Clean Room Alternative
Generates a design alternative in isolation, without seeing the first design. Used by the design-it-twice skil
Mb Frontend
Frontend specialist for memory-bank /mb work stages. React/Vue/Svelte/Solid components, browser UI, accessibil
Code Reviewer Clean Code Expert
Clean Code expert persona for code review. Focuses on naming, function design, readability, SOLID principles,
iOS Architect
Tier 1 — Strategy. Owns module boundaries, layering, and technology decisions. Use for architecture design, Cl
Related Skills
Audit Architecture
Comprehensive architecture audit with pattern recommendations. Detects DDD, CQRS, Clean/Hexagonal/Layered Arch
Architecture Patterns
Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domai
Clean Oop
Apply SOLID, Clean Code, dependency boundaries, and testability.