alex-1/.platform/initialized.md

Platform Initialization

Field	Value
Component	alex-1
Repository	apps/alex-1
Runtime	python-fastapi
Branch model	dev → staging → prod (→ main SoR)
Code lives on	dev (push to dev triggers build + deploy to dev env)
Protected	main, staging, prod (require PR + passing CI + 1 approval)
Free push	dev (inner loop — no PR, no approval required)

Promotion flow

Push to dev freely. The CI/CD pipeline builds and deploys to the dev environment automatically on every commit.

Promotion to higher environments requires a PR — the integration test must pass and 1 reviewer must approve before the merge is allowed:

• dev → staging — opens a PR; CI gate + 1 approval required
• staging → prod — opens a PR; CI gate + 1 approval required

main is the system of record. It contains only workflow files and platform metadata. Application code is promoted to it from prod via PR.