Repository Shape
Directories
Section titled “Directories”apps/site: public placeholder and future product entry.apps/dev: internal development surface atdev.giantrealms.com.apps/wiki: internal Astro Starlight wiki atwiki.giantrealms.com.apps/docs: public Astro Starlight documentation atdocs.giantrealms.com.packages/contracts: stable shared types, route contracts, and DTOs.packages/domain: pure validation, policy, and simulation rules.packages/platform: cloud/runtime adapters and route manifests.packages/backend: application services, repositories, and orchestration.infrastructure: CDK stacks for web, auth, DNS, certificates, and access gates.
Direction
Section titled “Direction”Higher-level packages depend inward on contracts and domain logic. Infrastructure consumes contracts and exports runtime IDs, but application code should not import CDK constructs.