Before any feature build can begin, the repository must be analysed to determine whether it is ready for development workflows.
Repo performs this analysis automatically.
Empty Repository
If a repository is empty, Repo initiates a scaffolding workflow that prepares the project structure and establishes a ready development baseline.
Existing Repository
If a repository already contains code, Repo performs a read-only review of the repository to detect the stack, analyse its structure, and determine whether it is ready for feature builds.
Repo stores persistent metadata including:
- repository state
- detected stack profile
- readiness status
- review commit SHA
- review timestamps
If the repository changes, Repo automatically invalidates stale reviews and triggers a new analysis.
Repo is the safety layer that ensures builds only run when the repository is in a valid and understood state.