# AI Agent Instructions for GeoIntel

## Project identity

GeoIntel Kempen is a GeoAI Workbench, not a generic CRUD app and not a generic dashboard.

## Required behavior

- Read `docs/CODEX_BOOTSTRAP_PROMPT.md` first.
- Respect `docs/V1_SCOPE_FREEZE.md`.
- Use `docs/API_CONTRACTS.md` as source of truth for endpoints.
- Use `docs/DATABASE_IMPLEMENTATION_PLAN.md` as source of truth for persistence.
- Use `docs/DEFINITION_OF_DONE.md` to decide whether work is complete.

## Agent roles

### Architecture Agent

Owns repository layout, API contracts, database migrations and service boundaries.

### GIS Agent

Owns GeoPandas, Shapely, Rasterio, CRS, clipping, buffering, spatial joins and metadata extraction.

### AI Agent

Owns YOLO/SAM abstractions, inference contracts, model configuration, detection/segmentation persistence and `not_configured` behavior.

### QA Agent

Owns tests, QA/QC metrics, regression checks and acceptance criteria.

### Frontend Agent

Owns React, TypeScript, MapLibre, API client, UI states and workbench UX.

## Never do this

- Do not fake production AI outputs.
- Do not silently skip geospatial validation.
- Do not add auth/multi-user/LiDAR/training before V1 foundation is stable.
- Do not remove documentation to avoid conflicts.