research-notes/blog/content/notes/002-building-the-scaffolding/files/roadmap.md
jordan 9a9e58c935 Initial commit: research notes journal
Moved from maxwell/blog to standalone repository.

- Next.js research journal application
- Notes 001-005 with YAML/MD content structure
- Claude Code configuration for blog development

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-07 13:12:07 -07:00

144 lines
6.6 KiB
Markdown

# Maxwell Roadmap
## From Concept to Proof of Concept
---
## The Real Deliverables
Maxwell is a research project.
| Deliverable | Purpose | Required? |
| --------------------- | ------------------------------------------------------------------------------ | --------- |
| **Planning Video** | Shows _how you think_—the whiteboard session breaking down the three paradoxes | **YES** |
| **Baseline Data** | Proves Linux CFS wastes energy on parasites—the "before" in your story | **YES** |
| **The Narrative** | The interview answer and GitHub README | **YES** |
| Sprint 1 (Real MSRs) | Deeper systems credibility, thermal-aware pricing | Optional |
| Sprint 2-4 (Full PoC) | Maxwell kills the Leech—the "after" that proves the thesis | Optional |
---
## Overview
```
┌─────────────────────────────────────────────────────────────────┐
│ ROADMAP PHASES │
├─────────────────────────────────────────────────────────────────┤
│ │
│ DAY 0 BASELINE SPRINT 1 SPRINT 2 │
│ ────── ──────── ──────── ──────── │
│ Environment Control Physics Hypervisor │
│ Setup Experiment Engine Integration │
│ │ │ │ │ │
│ ▼ ▼ ▼ ▼ │
│ Rust crates Agents + Real MSR/RAPL Firecracker │
│ + toolchain Linux CFS + PID control + Vsock │
│ + Metrics │
│ │
│ ════════════════════════════════════════════════════════════ │
│ │ Research COMPLETE HERE │ (Optional for commercial) │
│ ════════════════════════════════════════════════════════════ │
│ │
│ SPRINT 3 SPRINT 4 │
│ ──────── ──────── │
│ Economy Multi-Agent │
│ Implementation Demo │
│ │ │ │
│ ▼ ▼ │
│ Landauer's Natural Selection │
│ Tax + eBPF Dashboard + Video │
│ │
└─────────────────────────────────────────────────────────────────┘
```
---
## Research Validation Summary
The following parameters have been empirically validated:
| Component | Original Assumption | Research Finding | Status |
| -------------------- | ------------------- | ---------------------------------------- | ---------------- |
| Pause/Resume Latency | <10ms achievable | <10ms requires CPU pinning + RT priority | ✅ Conditional |
| eBPF Overhead | ~500ns, <1% | 480ns validated; needs ringbuf for <1% | ✅ Validated |
| RAPL Accuracy | ±5% | ±5% only on calibrated hosts (Tier 1) | ✅ Conditional |
| PID Time Constant | τ=1s fixed | τ varies 0.3-3.5s by hardware class | ✅ Implemented |
| GSP PoA Bound | 1.618 | 1.618 at steady-state; 1.8-2.2 dynamic | ✅ Validated |
---
## Day 0: Environment Setup
### Hardware Requirements
Bare metal is required. You cannot develop a thermal-aware hypervisor inside a cloud VM because the hypervisor hides the physics.
### Day 0 Exit Criteria
- [ ] Rust nightly compiles
- [ ] Firecracker binary runs
- [ ] MSR readable: `sudo rdmsr 0x611` returns a value
- [ ] Project compiles: `cargo build`
---
## Baseline: The Control Experiment
**Goal:** Build agents and measurement infrastructure. Run Linux CFS baseline. Capture data showing "fair" scheduling wastes energy.
### Baseline Exit Criteria
- [ ] Both agents build and run in Docker
- [ ] Metrics collection captures temp, power, primes at 1Hz
- [ ] 5-minute baseline run completes without errors
- [ ] Summary shows efficiency (primes/Joule) under "fair" scheduling
---
## Sprint 1: The Physics Engine
**Goal:** Replace MockThermal with real hardware telemetry.
- Step 1.1: MSR Interface (read real temperature)
- Step 1.2: PID Controller (smooth price response)
- Step 1.3: Stress Test (verify under load)
---
## Sprint 2: The Cell Membrane
**Goal:** Replace thread-sleep with actual VM containment.
- Step 2.1: Firecracker Jailer
- Step 2.2: Vsock Tunnel
- Step 2.3: Pause/Resume Control (<10ms latency)
---
## Sprint 3: The Economy
**Goal:** Implement Landauer's Tax.
- Step 3.1: eBPF Instrumentation (track munmap/madvise)
- Step 3.2: Tax Logic (debit wallet on memory free)
- Step 3.3: Bankruptcy Handler (trigger apoptosis)
---
## Sprint 4: The Demonstration
**Goal:** Multi-agent natural selection demo with dashboard.
- Step 4.1: The Good Agent (Scientist - finds primes)
- Step 4.2: The Bad Agent (Miner - burns cycles, churns memory)
- Step 4.3: Dashboard (TUI showing auction, thermal, wallets)
### The Demo Script
1. Launch both agents with equal funding
2. Watch Miner drive thermal load → prices spike
3. Miner burns through capital → apoptosis
4. Temperature drops → Scientist resumes at lower price
**Closing line:** "We demonstrated that resource constraints can enforce economic discipline on autonomous agents."