govoplan-forms/AGENTS.md

GovOPlaN Forms Codex Guide

Scope

This repository owns immutable reusable form definitions and their designer. Runtime values, drafts, receipts, attachments, signatures, and handoffs belong to govoplan-forms-runtime or the corresponding domain owner.

Working Rules

• Resolve cross-module behavior through Core contracts and capabilities; do not import another optional module's tables or WebUI pages.
• Keep definition revisions immutable and tenant-bound. Schema changes create a new revision and use optimistic concurrency.
• Keep submitted values out of Forms events, logs, and definition storage.
• Every behavior or UI change must update the relevant user/admin documentation and architecture declaration in the same change.

Verification

PYTHONPATH=src:/mnt/DATA/git/govoplan-core/src \
  /mnt/DATA/git/govoplan/.venv/bin/python -m unittest discover -s tests