angular-clean-architecture

Angular Clean Architecture — Module System

When To Activate

• Creating a module under src/app/modules/
• Adding a use case, facade, store, port, or adapter to an existing module
• Wiring lazy routes + cached state
• Replacing session proxies with self-contained module adapters
• Creating standalone components that consume store state via facades
• Refactoring a legacy/mixed module (NgModule/NgRx) toward Clean Architecture
• Moving business logic out of components into facades/use-cases
• Adding or updating cross-module communication via the context registry

Relationship to Other Skills

Concern	Owner
Domain modeling (entity, VO, aggregate, invariants)	[[angular-ddd]]
State/replay mechanics (Store API, channels, history)	[[flurryx]]
Pre-merge enforcement / review checklist	[[angular-cop]]
Module layout, DI, ports/adapters, lazy loading, caching wiring, facade, context registry, session-proxy replacement, naming	this skill

Architecture Anchors (Verify Before Coding)

Anchor	What to look for
Reference module	At least one module under src/app/modules/ with full layer structure
flurryx store	Store.for<Config>().build() in application/store/
syncToStore usage	syncToStore(this.store, KEY) or syncToKeyedStore(...) in adapters/facades
Context registry	contextProvidersFor() mapping cross-module providers

If anchors are missing: do NOT invent imports. Continue best-effort, report mismatch.

Architecture Overview

src/app/modules/{moduleName}/
├── presentation/            # list/ details/ create/ edit/ container pages, forms/, components/
├── application/
│   ├── facades/{moduleName}.facade.ts
│   ├── use-cases/{verb-noun}.use-case.ts
│   └── store/{moduleName}.store.ts      # flurryx Store.for<Config>().build()
├── core/                    # domain hexagon — ZERO infra/framework imports
│   ├── models/  ports/  rules/  mappers/  events/
├── infrastructure/
│   ├── adapters/{verb-noun}.adapter.ts
│   └── api/{endpoints/, request/, response/}
├── routes.ts                # lazy loadComponent + route-level providers
├── routes.constants.ts
├── {moduleName}-service.providers.ts    # SELF-REGISTRATION entrypoint
├── public-api.ts            # SYNC contract: models, ports, providers fn
└── integration-api.ts       # REACTIVE contract: exports store for cross-module mirroring