docs/armor-intelligence-system.md

Armor Intelligence System

Overview

The Armor Intelligence System is ClawSportBot's modular analytical customization framework. "Armors" are specialized intelligence modules that users equip to tailor the analytical pipeline to their specific needs.

Think of armors as lenses — each one brings a different analytical perspective into focus. Users can combine multiple armors for comprehensive coverage or focus on a single domain.

The Four Layers

Armors are organized into the same four layers as the agent network:

Cognitive Layer

Armors focused on statistical modeling, pattern recognition, and AI-driven prediction.

Armor	ID	Function
Neural Cortex	neural-cortex	Deep learning match outcome prediction
Pattern Matrix	pattern-matrix	Historical pattern recognition across seasons
Probability Core	probability-core	Advanced probabilistic modeling and calibration
Tactical Lens	tactical-lens	Formation and tactical analysis overlay

Market Layer

Armors focused on odds analysis, market movements, and value detection.

Armor	ID	Function
Odds Membrane	odds-membrane	Real-time odds comparison and implied probability
Value Radar	value-radar	Automated value edge detection
Market Pulse	market-pulse	Line movement velocity and steam move alerts
Liquidity Gauge	liquidity-gauge	Market depth and liquidity assessment

Ecosystem Layer

Armors focused on contextual factors that affect match outcomes.

Armor	ID	Function
Context Mesh	context-mesh	League standings, fixture congestion, motivation
Injury Mapper	injury-mapper	Player availability and injury impact modeling
League Scanner	league-scanner	League-specific trend and bias detection
Weather Shield	weather-shield	Weather condition impact assessment

Governance Layer

Armors focused on verification, trust, and audit capabilities.

Armor	ID	Function
Verification Core	verification-core	Full lifecycle audit trail access
Trust Weaver	trust-weaver	Agent reliability and reputation analytics
Audit Shield	audit-shield	Post-match audit detail access
Consensus Viewer	consensus-viewer	Multi-agent agreement visualization

How Armors Affect the Pipeline

When a user equips armors, the query routing changes:

1. Agent Activation: Only agents relevant to equipped armor layers are activated
2. Feature Prioritization: Agents prioritize features aligned with equipped armors
3. Output Formatting: Response includes detailed outputs from equipped armor domains
4. Consensus Weighting: Agents from equipped layers receive higher weight in consensus

Example: User equips Neural Cortex + Odds Membrane

Query
  ├─→ Cognitive Layer (prioritized — Neural Cortex active)
  │   ├─→ Match Analyst: Full activation
  │   ├─→ xG Processor: Full activation
  │   └─→ Tactical Engine: Reduced weight
  ├─→ Market Layer (prioritized — Odds Membrane active)
  │   ├─→ Odds Flow Monitor: Full activation
  │   └─→ Line Movement Tracker: Reduced weight
  ├─→ Ecosystem Layer (background)
  │   └─→ League Analyst: Minimal activation
  └─→ Governance Layer (always active)
      └─→ Consensus Engine: Standard activation

Armor Stacking

Multiple armors can be equipped simultaneously. Stacking follows these rules:

1. Same-layer stacking: Armors from the same layer compound their analytical coverage
2. Cross-layer stacking: Armors from different layers provide multi-dimensional analysis
3. Maximum armors: No hard limit, but 3-5 armors is recommended for optimal signal-to-noise ratio
4. Governance armors: Always recommended — they don't affect predictions but provide transparency

Armor Effectiveness Scoring

Each armor is continuously evaluated via the post-match audit process:

• Accuracy Impact: How much does equipping this armor improve prediction accuracy?
• Value Impact: How often does this armor contribute to detecting true value?
• Usage Rate: How frequently is this armor equipped across users?
• Satisfaction Score: User feedback on the armor's perceived usefulness

These metrics are published in the Autonomous Report and inform armor development priorities.

Tier Availability

Tier	Available Armors
Free	Neural Cortex, Context Mesh (2 armors)
Pro	All 16 armors
Institutional	All armors + custom armor development

Building Custom Armors (Institutional)

Institutional partners can develop custom armors tailored to their specific analytical needs. Custom armors:

• Integrate with the existing 4-layer architecture
• Can leverage proprietary data sources
• Participate in the same consensus and audit processes
• Require certification before deployment

Contact: support@clawsportbot.io or visit clawsportbot.io/contact