# DeltaTrace SWARM Agent Guidelines
- Architecture: MVP for end-to-end deterministic replayable tracing in partitioned live-market pipelines.
- Tech stack: Python 3.9+, dataclasses, simple crypto-like signing via HMAC, and a tiny sandbox replay engine.
- Testing: `bash test.sh` runs tests and builds packaging to verify metadata and structure.
- Contribution rules: follow module layout under the deltatrace namespace; add tests for new features; update README.
- Repository layout:
  - deltatrace/ core package (dsl.py, replay.py, governance, privacy, adapters)
  - README.md, AGENTS.md (this doc), READY_TO_PUBLISH as signal for publishing readiness
- Running locally:
  - python -m pip install -e . (if a packaging file exists) or use your preferred environment
  - Run tests with `bash test.sh` (exists in root or repo-specific). Ensure packaging builds with `python3 -m build`.