123 lines
3.6 KiB
Markdown
123 lines
3.6 KiB
Markdown
# START HERE — GeoIntel Architect Canonical Entry Point
|
|
|
|
This is the single canonical entry point for Codex, reviewers and future contributors.
|
|
Older handoff files are historical. If documents conflict, follow the precedence order in this file.
|
|
|
|
## Current milestone
|
|
|
|
**M14 — Build Launch Package**
|
|
|
|
The repository is no longer only a documentation bundle. It is now a specification-controlled engineering repo for building GeoIntel Kempen as a GeoAI Workbench.
|
|
|
|
## Product one-liner
|
|
|
|
GeoIntel Kempen is a GeoAI Workbench for the Belgian Kempen that processes raster data, vector data and AI outputs into geospatially correct detections, segmentations, QA/QC metrics and exports.
|
|
|
|
## Non-negotiable product identity
|
|
|
|
GeoIntel is:
|
|
|
|
- a GeoAI Workbench;
|
|
- a geospatial data processing product;
|
|
- a platform for raster/vector/AI/QA workflows;
|
|
- a portfolio-grade implementation of GIS, remote sensing, computer vision and data engineering.
|
|
|
|
GeoIntel is not primarily:
|
|
|
|
- a generic dashboard;
|
|
- a reporting-only tool;
|
|
- a chatbot;
|
|
- a QGIS clone;
|
|
- a mock demo app.
|
|
|
|
## Canonical read order for Codex
|
|
|
|
Read these files in order before coding:
|
|
|
|
1. `docs/00-start/START_HERE.md`
|
|
2. `docs/governance/GEOINTEL_CONSTITUTION.md`
|
|
3. `docs/governance/ARCHITECTURE_INVARIANTS.md`
|
|
4. `docs/governance/FORBIDDEN_DECISIONS.md`
|
|
5. `docs/governance/DECISION_PRECEDENCE.md`
|
|
6. `docs/specs/CANONICAL_DOMAIN_MODELS.md`
|
|
7. `docs/specs/GIS_STANDARDS.md`
|
|
8. `docs/specs/RASTER_STANDARDS.md`
|
|
9. `docs/specs/STATE_MACHINES.md`
|
|
10. `docs/workflows/GOLDEN_PATHS.md`
|
|
11. `docs/build/BUILD_ORDER_DEPENDENCY_GRAPH.md`
|
|
12. `docs/build/CODEX_OPERATING_SYSTEM.md`
|
|
13. `docs/40-build-launch/SPRINT_1_SCOPE_FREEZE.md`
|
|
14. `docs/40-build-launch/BUILD_SUCCESS_DEFINITION.md`
|
|
15. `docs/40-build-launch/CODEX_STOP_RULES.md`
|
|
16. `prompts/codex/m14/CODEX_FIRST_DAY_MASTER_PROMPT.md`
|
|
|
|
## Canonical first implementation target
|
|
|
|
The first vertical slice is:
|
|
|
|
**Project + Area + Dataset + Raster/Vector metadata + Reference polygons + Detection result import + QA/QC + GeoJSON export.**
|
|
|
|
Do not start with full AI inference if the foundation is not stable. The first goal is to prove the data lifecycle and geospatial correctness.
|
|
|
|
## Canonical V1 golden path
|
|
|
|
1. Create project.
|
|
2. Create/select an Area in the Kempen.
|
|
3. Upload or load a raster/vector dataset.
|
|
4. Extract and persist metadata.
|
|
5. Load reference polygons, initially demo GRB-like buildings.
|
|
6. Import or generate predicted building detections.
|
|
7. Convert outputs to valid geospatial features.
|
|
8. Run QA/QC against the reference layer.
|
|
9. Show results on the map and in metrics panels.
|
|
10. Export GeoJSON.
|
|
|
|
## What Codex may improve autonomously
|
|
|
|
Codex may improve:
|
|
|
|
- implementation quality;
|
|
- test coverage;
|
|
- type safety;
|
|
- error handling;
|
|
- UI clarity;
|
|
- documentation clarity;
|
|
- internal helper abstractions;
|
|
- performance within defined budgets.
|
|
|
|
Codex may not change:
|
|
|
|
- product identity;
|
|
- core stack;
|
|
- CRS policy;
|
|
- database choice;
|
|
- async job architecture;
|
|
- API envelope shape;
|
|
- state machine names;
|
|
- golden path priority;
|
|
- forbidden decisions.
|
|
|
|
## Conflict resolution
|
|
|
|
If any older document conflicts with this M14 launch layer, follow this order:
|
|
|
|
1. Constitution and architecture invariants.
|
|
2. Forbidden decisions.
|
|
3. State machines and canonical models.
|
|
4. API/database contracts.
|
|
5. Build order dependency graph.
|
|
6. M14 build-launch docs for first-run scope and stop rules.
|
|
7. Older milestone handoff documents.
|
|
|
|
## Required pass ending
|
|
|
|
Every Codex pass must end with:
|
|
|
|
- files changed;
|
|
- commands run;
|
|
- tests passed/failed;
|
|
- known limitations;
|
|
- whether golden paths still pass;
|
|
- whether any architecture invariant was touched;
|
|
- next recommended pass.
|