Files
geointel/docs/15-tomorrow-execution/CODEX_HANDOFF_BRIEFING.md
Jens faeb58ef6d
GeoIntel release gates / Compile, test, contracts and builds (push) Successful in 1m49s
GeoIntel release gates / Python and npm vulnerability policy (push) Successful in 21s
GeoIntel release gates / Production AI image, SBOM and container scan (push) Successful in 5m39s
GeoIntel release gates / Deploy exact gated revision to Unraid (push) Failing after 58m43s
Initial public release
2026-08-31 21:56:53 +02:00

1.5 KiB

Codex Handoff Briefing

You are inheriting GeoIntel Kempen, a GeoAI Workbench for the Belgian Kempen.

Read first

  1. README.md
  2. AGENTS.md
  3. docs/V1_SCOPE_FREEZE.md
  4. docs/SERVICE_ARCHITECTURE.md
  5. docs/REPOSITORY_CONVENTIONS.md
  6. docs/15-tomorrow-execution/M8_TOMORROW_EXECUTION_PACK.md
  7. docs/15-tomorrow-execution/DAY_1_EXECUTION_TIMELINE.md
  8. the current pass prompt under prompts/codex/day-1/

Build philosophy

Build thin but real vertical slices. Do not hide missing functionality behind convincing UI. A small working API with tests is better than a beautiful mock.

The first usable vertical slice

The first vertical slice is:

Project -> Area -> Dataset registration -> Metadata -> Map/Workbench display -> Export-ready internal structure

Object detection, segmentation and QA/QC are important, but they must sit on a stable foundation.

Common failure modes to avoid

  • Creating frontend-only mock data that bypasses API state.
  • Mixing geometry parsing into random route handlers.
  • Adding AI dependencies before the data model is stable.
  • Hardcoding local file paths.
  • Ignoring CRS metadata.
  • Creating database models that cannot handle future PostGIS geometries.
  • Implementing upload without storage policy.
  • Writing TODOs instead of completing the requested pass.

Improvement freedom

You may add helper modules, stricter validation, better tests, and cleaner component structure. You may not change the product scope or stack.