geointel/AGENTS.md

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.