---
name: modular-clean-architecture
description: "Design and implement modular Clean Architecture (hexagonal) backends in Python/FastAPI. Covers module decomposition, layer boundaries, dependency rules, solo-dev workflow, and 2026 best practices."
version: 2.1.0
author: Hermes Agent
license: MIT
platforms: [linux, macos, windows]
metadata:
  hermes:
    tags: [architecture, design, python, fastapi, modular, clean-architecture, hexagonal, ddd, cqrs]
    related_skills: [writing-plans, subagent-driven-development, test-driven-development]
---
# Modular Clean Architecture
Design and implement modular Clean Architecture (hexagonal) backends in Python/FastAPI. Covers module decomposition, layer boundaries, dependency rules, solo-dev workflow, and 2026 best practices.
## Sections
- Overview
- When to Use
- Module Structure
- Shared Core
- Dependency Rules
- 2026 Best Practices
- Testing Strategy
- Module Decomposition
- Solo-Dev Workflow
- Pitfalls
- References
- See Also
- Workflow
- Critical (N)
- High (N)
- Medium (N)
- Low (N)
- Patterns & Systemic Issues
- Strengths Confirmed
- Known Pitfalls (from real sessions)

## References (14)
Detail has been moved to reference files in `references/`.
Load a specific reference file for detailed guidance.

## Triggers
- Load this skill when working on relevant architecture/project tasks.
- For specific subtasks, load only the relevant `references/<file>.md`.