flashplan-edge-optimized-cross-venue-exe/AGENTS.md

FLASHPLAN AGENTS

Overview

• FlashPlan is a federated edge planner for cross-venue execution. This repository provides a minimal MVP core to bootstrap development and testing.

Architecture

• Core primitives: LocalProblem, SharedVariables, PlanDelta
• Edge planner: lightweight optimization with a simple ADMM-lite coordinator
• Adapters: venue A, venue B; mock risk center
• Transport: TLS-stub boundary to illustrate secure channels (no real network in MVP)
• Delta-sync: deterministic reconciliation on reconnects

Tech Stack

• Python 3.11+ (typing, dataclasses, small in-process simulations)
• Tests with pytest
• Packaging via setuptools (pyproject.toml)

How to run tests

• ./test.sh
• The script runs pytest and python -m build to verify packaging.

Development Rules

• Implement smallest correct change first; small, well-scoped PRs preferred.
• Favor plain Python modules with clear interfaces; add tests for new behavior.
• Do not publish or push to remote without explicit user instruction.