# AGENTS

- This repository contains a lightweight, test-driven Python prototype for ArbSphere's federated cross-arbitrage primitives.
- Core concepts provided: LocalArbProblem, SharedSignals, and a deterministic admm_step that outputs a PlanDelta.
- Tests verify deterministic plan generation and basic structure.
- How to run:
  - bash test.sh
- Important: This document is a stub for onboarding agents and does not describe a full production architecture.