kalei/docs/codex phase documents/README.md

Codex Phase Documents

Last updated: 2026-02-10

This folder contains the deep execution plan for building Kalei from zero to launch and then Phase 2 growth.

Read in order:

1. phase-0-groundwork-and-dev-environment.md
2. phase-1-platform-foundation.md
3. phase-2-core-experience-build.md
4. phase-3-launch-readiness-and-hardening.md
5. phase-4-spectrum-and-scale.md

Phase map

• Phase 0: Groundwork and Dev Environment
  • Goal: stable tooling, accounts, repo standards, and local infrastructure.
• Phase 1: Platform Foundation
  • Goal: production-quality backend skeleton, auth, entitlements, core data model.
• Phase 2: Core Experience Build
  • Goal: ship Mirror, Turn, Lens end-to-end in mobile + API.
• Phase 3: Launch Readiness and Hardening
  • Goal: safety, billing, reliability, compliance, app store readiness.
• Phase 4: Spectrum and Scale
  • Goal: analytics pipeline, weekly and monthly insights, scaling controls.

Definition of progression

Do not start the next phase until the current phase exit checklist is complete.

If a phase slips, reduce scope but do not skip quality gates for:

• security
• safety
• observability
• data integrity

Tooling policy

These phase docs assume an open-source-first stack:

• Gitea for source control and CI
• GlitchTip for error tracking
• PostHog self-hosted for product analytics
• Ollama (local) and vLLM (staging/prod) for open-weight model serving

Platform exceptions remain for mobile distribution and push:

• Apple App Store and Google Play billing/distribution APIs
• APNs and FCM delivery infrastructure