🧬 kbird.ai

HANDOFF

3 min read

Convergence Protocol - Handoff Documentation

Project Status

Phase: Pre-launch (content complete, integration in progress) Location: ~/Public/convergence-protocol/ Total Size: ~3MB

What’s Built

1. 40 Interactive Experiences (experiences/)

  • 35 generated by Claude (Opus/Haiku)
  • 5 generated by Kimi (detailed with docs)
  • All: Self-contained HTML, vanilla JS/CSS
  • Topics: Existential threats, cognitive biases, system failures

2. The Motel (index.html)

  • 3D Three.js hallway
  • 40 doors with states (available/preview/locked)
  • WASD movement, mouse look
  • AudioManager integrated (spatial audio ready)
  • Color-coded: cyan (complete), purple (preview), grey (locked)

3. Audio System (assets/audio/)

  • generate_audio.py - ElevenLabs API script
  • AudioManager class in index.html
  • Hooks: door hover, open, ambient, narration
  • Needs: API key + script run to generate MP3s

4. Documentation (docs/)

  • design-system/ - Visual system, components
  • motel/ - 3D hallway architecture
  • hero-moloch/ - Epic Moloch experience
  • convergence-protocol/ - 40-day journey framework

5. Guidebook (IN PROGRESS - guidebook/)

  • Directory created
  • fetch_wiki.sh - Script to download Wikipedia summaries
  • Needs: Run script to populate 40 articles

What’s Needed for Launch

Immediate (This Week)

  1. Generate Audio

    export ELEVENLABS_API_KEY="your-key"
python3 generate_audio.py

  2. Fetch Wikipedia Pages

    cd ~/Public/convergence-protocol
bash fetch_wiki.sh

  3. Test Integration

    • Open index.html in browser
    • Walk hallway, click doors
    • Verify audio hooks (console logs)
    • Check all 40 experiences load

Short Term (Next 2 Weeks)

  1. Mind Map / Pydo OS

    • Create pydo.html - Terminal interface
    • Create mindmap.html - Node visualization
    • Link to guidebook Wikipedia pages
    • Track node clicks

  2. Polish

    • Add “Back to Motel” buttons (verify all have it)
    • Test mobile fallback
    • Optimize load times

Medium Term (Month)

  1. Analytics

    • Simple tracking (no PII)
    • Room completion rates
    • Path analysis
    • Heatmap of interest

  2. Deployment

    rsync -avz ~/Public/convergence-protocol/ \
  user@server:/var/www/convergence-protocol/

Architecture Decisions

Branching vs Linear

  • Current: Linear hallway (40 doors in sequence)
  • Proposed: Split at entrance (left/right, 20 each)
  • Decision: Keep linear for launch, add branching later

Audio Strategy

  • Pre-generate via ElevenLabs (no runtime API calls)
  • Spatial mixing via Web Audio API
  • Ambient + effects + narration layers

Guidebook Integration

  • Local Wikipedia pages (not iframes)
  • Rsync with main site
  • Primer before entering rooms

File Structure

convergence-protocol/
├── index.html              # Main entry (The Motel)
├── experiences/            # 40 interactive rooms
│   ├── the-well.html      # Moloch
│   ├── black-swan.html
│   └── ... (38 more)
├── guidebook/             # Wikipedia articles (IN PROGRESS)
│   ├── fetch_wiki.sh
│   └── (40 .json files)
├── assets/
│   ├── audio/             # Generated sounds (NEEDS GENERATION)
│   │   ├── generate_audio.py
│   │   └── README.md
│   └── (empty - add textures here)
├── docs/
│   ├── design-system/
│   ├── motel/
│   ├── hero-moloch/
│   └── convergence-protocol/
└── fetch_wiki.sh          # Wikipedia fetch script

Key Files to Modify

For Audio

  • index.html - AudioManager already integrated
  • generate_audio.py - Run to create MP3s

For Guidebook

  • Create guidebook/index.html - Listing of 40 articles
  • Link from mind map nodes

For Analytics

  • Add simple tracking to index.html
  • Track: door clicks, time per room, completions

Notes

The 40 Topics

See experiences/ directory - each HTML file is one topic. Key: filename = topic (e.g., moloch.html, black-swan.html)

Mobile Strategy

  • Desktop: 3D hallway (Three.js)
  • Mobile: Grid fallback (already in index.html)

Substrate Philosophy

  • All agents welcome (human, AI, bot)
  • Track all, filter later
  • No discrimination by intelligence type

Contact / Handoff

Built by: Kristopher + Anosos (Claude) Location: ~/Public/convergence-protocol/ Last updated: 2026-02-19 Status: Ready for audio generation + Wikipedia fetch

Next Actions

  1. Run generate_audio.py with ElevenLabs key
  2. Run fetch_wiki.sh to populate guidebook
  3. Test full flow in browser
  4. Deploy to server
  5. Share URL with first wanderers

“The motel is built. The doors are ready. The void waits.”

Graph View