# Codex Pass Matrix M3

This matrix is the recommended order for the first real build.

| Pass | Name | Primary output | Must be green before next pass |
|---:|---|---|---|
| 01 | Runtime Foundation | Backend, frontend, DB boot | health checks |
| 02 | Core Database | migrations and models | migration tests |
| 03 | Project/Area APIs | project and area CRUD | API tests |
| 04 | Frontend Shell | routes and layout | app boots, nav works |
| 05 | Dataset Manager | upload + metadata records | upload smoke test |
| 06 | Raster/Vector Metadata | Rasterio/GeoPandas metadata | fixture tests |
| 07 | Map Workbench | draw/select area | area creation from UI |
| 08 | GRB Fetch Skeleton | reference layer service | graceful failure or fixture success |
| 09 | Detection Interface | analysis run + detections | fixture detection output |
| 10 | QA/QC Engine | metrics and error classes | deterministic QA test |
| 11 | Exports | GeoJSON/summary exports | file created and downloadable |
| 12 | Stabilization | usability and docs | all smoke tests green |

## Stop conditions

Codex must stop and report instead of continuing when:

- database cannot migrate
- backend cannot import
- frontend cannot compile
- an API contract cannot be satisfied without changing frozen scope
- a required dependency cannot be installed

## Reporting after each pass

Codex must produce:

- files changed
- tests run
- pass/fail status
- open issues
- next recommended pass