idea160-exprove-open-source/AGENTS.md

ExProve Agent Guidelines

Architecture

• Core primitives:
  • LocalExecutionTask: per-instrument, per-venue execution task
• SharedMarketContext: versioned market signals across venues
• PlanDelta: incremental routing/size/timing decisions with metadata
• Attestation/AuditLog: cryptographic attestations and an append-only log
• Graph-of-Contracts: registry for adapters and data contracts

Development workflow

• Use Python as the MVP language for the core primitives.
• Tests live under tests/ and are executed via test.sh.
• Packaging uses pyproject.toml with a standard build-system block.

Validation

• Ensure test.sh runs: pytest and python3 -m build (to validate packaging).
• Maintain deterministic behavior for replayability in tests where applicable.

Contribution

• Add small, well-scoped changes. Update tests accordingly.
• Document public API in README.md and inline comments where necessary.

This file documents the architectural rules and contribution guidelines for ExProve in this repository.