# 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.