modular-monolith

name	modular-monolith
description	Architecture patterns including modular monolith and hexagonal architecture. Use when designing module boundaries, ports/adapters, or refactoring for testability.

Modular Monolith

Architecture guidance for modular monolith and backend evolution. Two documents:

Document	Content
DECISIONS.md	When/why to add each stage: single server → cache+CDN. Pain-driven triggers, heuristics, 6-stage progression.
PATTERNS.md	How to structure a modular monolith: domain separation, Client/Implementation, no cross-domain FKs, ArchUnit enforcement, microservice migration.

Companion Skills

• backend-patterns — API design, validation, error handling
• api-design — REST/GraphQL contract patterns
• architecture-decision-records — capture architecture decisions