Create a project
What happens first
Section titled “What happens first”- Copy or initialize the Starter with the bootstrap workflow.
- Run the local
/setupworkspace and enter the product identity, platforms, design profile, pages, SaaS modules, optional capabilities, providers, and two environment identities. - Review the generated
starter.blueprint.json. This file records intent; it is not a deployment action. - Let the controller read the project context and materialize only selected packs.
- Provision a new empty database from that final selection. Do not carry Starter-era legacy migration or backfill logic into initialization.
- Run the repository verification gates before asking for a Development release.
Read these sources in order
Section titled “Read these sources in order”AGENTS.md— operating, safety, documentation, and release rules.PROJECT.md— product purpose and current state.starter.blueprint.json— selected product shape.catalog/catalog.json— available Design, Page, SaaS, and Capability packs.design/catalog.json— selected visual profile and adapter readiness.pages/catalog.json— route ownership, renderer, selection, and acceptance rules.- the current Change Spec and affected
features/*/MODULE.mdfiles.
Empty database rule
Section titled “Empty database rule”A new Starter project begins from an empty PostgreSQL database and applies the current SQL baseline. Existing-product backfills or compatibility migrations do not belong in the Starter baseline; a product that already owns data must design those separately.
Completion standard
Section titled “Completion standard”A page render or HTTP 200 is not enough. Completion requires the selected behavior, typechecks and builds, focused contract tests, documentation synchronization, bundle or performance budgets, and the relevant release dry run.