idea15-edgemind-verifiable-onboard/AGENTS.md

EdgeMind - Agent Documentation

Architecture overview:

• core: idea15_edgemind_verifiable_onboard
• modules:
  • planner.py: Lightweight MILP-free planner that matches goals to the cheapest providing action within energy budgets
  • contracts.py: SafetyContract primitives for pre/post validation
  • contract_layer.py: Data-contract layer scaffolding (Objects, Morphisms, Functors)
  • cli.py: Simple CLI to exercise the planner and contracts

Tech stack:

• Python 3.8+
• Numpy, Pydantic, PyYAML for data structures and serialization
• Lightweight, edge-friendly planning logic with open-ended extensibility

How to test:

• Run pytest to execute tests
• Use test.sh to run tests and packaging verification (build) locally

Testing commands:

• bash test.sh
• python3 -m build

Rules for contributors:

• Implement features with small, well-scoped patches
• Write tests for every new feature
• Keep interfaces backwards-compatible unless explicitly requested
• Update AGENTS.md with notable architectural changes