deltaforge-real-time-cross-.../AGENTS.md

18 lines
920 B
Markdown

# DeltaForge MVP: Architectural Guide
Overview
- Purpose: A minimal, auditable cross-venue hedging engine for two assets across two venues.
- Scope: Core DSL sketches, two starter adapters, a tiny central curator, and a toy backtester.
Architecture sketch
- DSL: StrategyDelta, Asset, MarketSignal, PlanDelta (data classes with simple validation).
- Adapters: canonical signals from venue data translated to StrategyDelta objects.
- Coordinating layer: local risk solvers per venue + a central curator that enforces cross-venue constraints via aggregated signals (ADMM-lite style).
- Execution adapter: routes to venues with latency/fee metadata in the plan delta.
- Backtester: deterministic replay engine.
- Governance: tamper-evident logs; cryptographic tag placeholders.
How to contribution
- Run tests via test.sh; ensure deterministic behavior.
- Extend with new adapters, new assets, or richer DSL primitives.