gridpilot.gg/docs/architecture/core/CORE_FILE_STRUCTURE.md

Core File Structure (Strict)

This document defines the canonical physical structure for core/.

It describes where code lives, not the full behavioral rules.

Core rules and responsibilities are defined elsewhere.

1) Core is feature-based

Core is organized by bounded context / feature.

core/
  shared/
  <context>/
    domain/
    application/

2) core/<context>/domain/

Domain contains business truth.

Canonical folders:

core/<context>/domain/
  entities/
  value-objects/
  services/
  events/
  errors/

See docs/architecture/core/DOMAIN_OBJECTS.md.

3) core/<context>/application/

Application coordinates business intents.

Canonical folders:

core/<context>/application/
  commands/
  queries/
  use-cases/
  services/
  ports/

See:

• docs/architecture/core/USECASES.md
• docs/architecture/core/CQRS.md