feat: add module contracts and discovery

README.md

@@ -6,10 +6,10 @@ surfaces.
 
 ## Current status
 
-Phase 1 establishes the repository foundation only. It includes reproducible workspace
-tooling, strict TypeScript defaults, executable architectural boundary checks, tests, CI, and
-local PostgreSQL/S3-compatible infrastructure. Core runtime, module discovery, identity,
-Module SDK, surfaces, and feature modules intentionally begin in later phases.
+Phase 2 is underway. The repository now includes public module contracts, the Module SDK,
+side-effect-free module manifests, deterministic automatic discovery, compatibility and dependency
+validation, and a cloneable backend-only module template. Runtime registration, Drizzle, identity,
+surfaces, and feature modules remain later vertical slices.
 
 ## Quick start
 
@@ -19,6 +19,7 @@ Prerequisites: Node.js 24 LTS, pnpm 11.12, and Docker with Compose.
 pnpm install --frozen-lockfile
 cp .env.example .env
 pnpm infrastructure:up
+pnpm modules:validate
 pnpm verify
 ```
 
@@ -37,6 +38,7 @@ environment.
 - [Platform architecture](docs/architecture/platform-architecture.md)
 - [Repository boundaries](docs/architecture/repository-boundaries.md)
 - [Repository workflow](docs/development/repository-workflow.md)
+- [Module development](docs/module-development/README.md)
 - [Architecture decisions](docs/architecture/decisions/README.md)
 
 No open-source license has been selected yet. A license should be added only after the project