docs/AGENTS.md

# LOGOS Protocol: Operating System for the New Web

## Core Philosophy: Physics-First
LOGOS is not just code; it is a thermodynamic system. We treat data as heat (energy) and structure as matter.
- **Baking**: Compression/Encoding (Increasing Entropy locally to store potential)
- **Eating**: Decompression/Decoding (Releasing Potential)
- **Crystals**: Data structures (Primes, Waves)

## 3-Layer Architecture

### Layer 1: Blueprints (The Math)
- **Prime Harmonization**: Using prime numbers to define wave interference patterns.
- **Fractal Addressing**: Quadtree spatial hashing for infinite canvas resolution.
- **Golden Ratio (Phi)**: Aesthetic alignment.

### Layer 2: Integration (The DSP)
- **DSP Bridge**: The transport layer. Connecting Source to Sink.
- **Matroska Containers**: Domain separation (High/Low frequency, Meta/Delta).
- **Streams**: Resume-Driven Deployment. The stream is the truth.

### Layer 3: Execution (The Interface)
- **The Machine Shop**: Gradio/Web interface for interacting with the protocol.
- **Visualizers**: Real-time feedback of the prime network and heatmaps.
- **Self-Annealing**: The system improves itself through feedback loops.

## Development Protocol
1. **Resume-Driven Deployment**: Everything must be recoverable.
2. **Self-Annealing**: Code refactors itself (Agency).
3. **Physics-First**: If it violates thermodynamics, it's wrong.