govoplan-workflow-engine/AGENTS.md

GovOPlaN Workflow Engine Codex Guide

Scope

This repository owns headless workflow definitions, immutable versions, validation, execution adapters, resumable state, human handoffs, and module-provided workflow baselines.

Documentation Contract

• Treat documentation as part of every behavior change. Update this module's manifest-driven DocumentationTopic contributions for affected user and administrator behavior.
• Keep feature content here; govoplan-docs projects it without importing Workflow Engine internals.
• Maintain a static user/admin baseline and run /mnt/DATA/git/govoplan/tools/checks/check-manifest-shapes.py after behavior or manifest changes.

Boundaries

• govoplan-workflow owns the optional editor; modules may define and run workflows through engine contracts without it.
• Preserve versioning, idempotency, authorization, recovery, and audit evidence at every transition.