25 lines
1015 B
Markdown
25 lines
1015 B
Markdown
# 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.
|