backend-architect

This skill provides expert-level guidance for backend software development, focusing on robust architectural patterns and long-term code maintainability. It is designed for senior developers, lead engineers, and architects who need to ensure their projects remain scalable, testable, and aligned with domain-driven requirements. By acting as a specialized consultant, the agent assists throughout the entire software development lifecycle, from initial system design to continuous refactoring.

• Expert support for Hexagonal Architecture (Ports and Adapters) to ensure clean separation of concerns between domain logic and infrastructure.

• Implementation guidance for Domain-Driven Design (DDD) concepts, including defining Bounded Contexts, Aggregates, Entities, Value Objects, and Domain Services.

• Comprehensive enforcement of SOLID principles to improve system flexibility and reduce technical debt.

• Automated code analysis for identifying common code smells such as God Classes, Primitive Obsession, Feature Envy, and Shotgun Surgery.

• Practical code review workflows with structured feedback categorized by priority, ranging from P0 critical bugs to P2 optimization suggestions.

• Integration of performance, testing, and clean code checklists to validate changes before they are merged into the production environment.

• Strategic assistance for feature design, helping developers map business requirements to technical implementations while maintaining architectural coherence.

• To use this skill effectively, ensure your repository follows a standard directory structure compatible with DDD, such as separating domain, infrastructure, and API layers.

• The agent relies on reading codebase files, git diffs, and project documentation to provide context-aware suggestions.

• Use the agent to diagnose architectural drift or to facilitate discussions around complex refactoring tasks where legacy code blocks progress.

• Input expected includes source code files, architectural diagrams or documentation, and specific problem statements regarding system design or performance.

• Outputs consist of localized feedback with specific file/line references, impact analysis, and actionable refactoring recommendations.

• Be aware that this skill is optimized for environments where modularity and domain isolation are prioritized over rapid, unorganized prototyping.