SYSTEM RESTRICTIONS & BOUNDARIES
THE PRIME DIRECTIVE: BIFURCATION
The repository strictly separates Product (Reliability) from Lab (Velocity).
"Product" code (core/agents/) requires strict typing, defensive coding, and auditability ("Slow is Smooth").
"Lab" code (experimental/) allows for rapid prototyping ("Move Fast and Break Things").
COGNITIVE ARCHITECTURE
System 1 (The Swarm): Fast, async, event-driven. Handles perception and news monitoring.
System 2 (The Graph): Slow, deliberative, DAG-based. Handles reasoning, planning, and critique.
TOOLING & USAGE
BUILD SYSTEM
ADAM uses a custom build system to create portable environments.
ENVIRONMENT (uv)
We strictly use uv for lightning-fast, reproducible Python environment management.
DEV NOTES & PATTERNS
MODULAR LOADING
The Modular Data Loading Architecture decouples large datasets from the main application.
ModularDataManager handles async fetching and caching of JSON artifacts (reports, credit memos).
AGENT PROTOCOLS
Communication: All agents communicate via AgentInput and AgentOutput Pydantic schemas.
Tool Use: Agents must prefer Python tools (MCP) over mental math.
Grounding: Every claim must cite a source (10-K line item, URL).
FUTURE BACKLOG & ROADMAP
PHASE 1.5
Synthesizer Dashboard, Agent Intercom, and War Room integration.
PHASE 2 (Q3 2025)
Multi-entity risk aggregation and automated rebalancing engines.
PHASE 3 (Q3 2026)
High-frequency sentiment trading and liquidity provision via Quantum RL.