clean-architecture-general

What problem does it solve?

Teams and learners struggle to consistently apply Clean Architecture (Ports & Adapters) in Go, especially when adding business use cases and external integrations without breaking dependency rules.

Core Features & Use Cases

• Runnable minimal demo: Generates a minimal Clean Architecture Go scaffold you can run immediately to learn the patterns with real code.
• Port/Adapter structure: Models business logic around interfaces (ports) and keeps adapters responsible for external integration and error mapping.
• Test-friendly by design: Supports unit tests using fakes with no DB/MQ/HTTP dependencies, keeping business rules isolated.
• Use-case expansion workflow: Provides SOP and AI prompt templates to add new use cases, ports, adapters, domain errors, and tests while preserving dependency direction.

Quick Start

Ask your AI assistant to extend the generated minimal demo by adding a new order use case (e.g., CancelOrder) and update the required domain errors, ports, adapters, handler mapping, and unit tests so the architecture constraints remain satisfied.