# DeltaTrace SWARM Guidelines

Architecture: production-grade MVP for end-to-end traceability, deterministic replay, and governance-ready audit trails in live market pipelines.

Stack: Python 3.9+, minimal dependencies. Production-oriented design with a clear separation between core replay logic and adapters.

Testing: use test.sh to run unit tests and packaging checks. Packaging should be validated with python3 -m build.

Contributions: small, focused changes with tests. Follow the project style and add docstrings.

Publishing: when ready, ensure pyproject.toml/build metadata is consistent and add READY_TO_PUBLISH.

Contributor Guide (Tip for MVP cycles)
- Run test.sh to verify unit tests and packaging readiness after every meaningful change.
- Use the provided tests as the contract for expected behavior (e.g., deterministic replay ordering and trace serialization).
- Keep changes small and well-tested; prefer minimal, well-scoped edits over sweeping rewrites.
- If adding new public APIs, document them in README and add tests that cover typical usage paths.