signalvault-verifiable-priv.../AGENTS.md

894 B

SignalVault SWARM Agent Guidance

  • Architecture: Python MVP with Graph primitives (SignalNode, Edge, Scenario, HedgePlan), Graph-of-Contracts registry, deterministic replay engine, and privacy primitives stubs.
  • Tech stack: Python 3.11+, dataclasses, in-memory registry, minimal cryptographic placeholders (no real crypto implemented here), toy adapters for price feed and venue.
  • Testing: pytest-based unit tests; test.sh runs pytest and builds the package.
  • Running tests: ./test.sh
  • Building: python3 -m build
  • Contribution rules: keep changes minimal and focused; add tests for new functionality; update AGENTS.md with new modules and tests.

Guiding principles:

  • Start with a small, solid MVP; iterate via 1 feature per sprint.
  • Ensure deterministic replay semantics for offline reproducibility.
  • Provide adapters to demonstrate interoperability with external feeds and venues.