# DeltaTrace Agent Guidelines

- Architecture: production-oriented MVP for end-to-end traceability in partitioned live-market pipelines.
- Tech Stack: Python 3.9+, dataclasses, simple TLS-ready adapters (simulated), and a deterministic replay engine.
- Testing: `test.sh` runs pytest and `python3 -m build` to verify packaging.
- Contribution: follow the simple module layout; add tests for any new feature; update README.
- Running tests:
  - bash test.sh
- Branching/Publishing:
  - Create feature branches per improvement; ensure tests pass before merging.
- Interoperability goals: TraceDSL primitives with per-message metadata; Merkle-backed proofs for auditability; 2 starter adapters (FIX feed and exchange gateway) for cross-ecosystem demos.