kalei/docs/build-phases/README.md

52 lines
1.6 KiB
Markdown
Raw Normal View History

# 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