🧬 kbird.ai

MANIFEST

5 min read

Convergence Protocol Guidebook - Complete Manifest

🎯 Quick Links

Pages (Open These in Browser)

Documentation (Read These)

📦 Complete File Listing

guidebook/
├── index.html                          Main hub (1,200+ lines)
├── README.md                           Overview
├── GUIDEBOOK_STRUCTURE.md              Technical breakdown
├── START_HERE.md                       Quick start
├── MANIFEST.md                         This file
│
├── guides/
│   └── first-time-visitor.html        Onboarding (1,100+ lines)
│
├── reference/
│   ├── sayings.html                   Searchable sayings (700+ lines)
│   └── concept-map.html               D3 graph (600+ lines)
│
└── chapters/
    ├── 01-coordination-failures/       (Empty, ready)
    ├── 02-prediction-uncertainty/      (Empty, ready)
    ├── 03-knowledge-information/       (Empty, ready)
    ├── 04-bias-cognition/             (Empty, ready)
    └── 05-systems-futures/            (Empty, ready)

🎨 What’s Included

Interactive Pages (4)

  1. index.html (16KB)

    • Main guidebook entry point
    • Chapter overview with cards
    • Quick navigation links
    • Featured saying
    • How-to section

  2. guides/first-time-visitor.html (35KB)

    • Complete onboarding
    • How the motel works
    • Three visitor pathways
    • Recommended starting points
    • Interactive FAQ (10 items)

  3. reference/sayings.html (60KB)

    • All 100 philosophical sayings
    • 18 category filters
    • Full-text search
    • Interactive filtering
    • Card-based layout

  4. reference/concept-map.html (40KB)

    • D3.js force-directed graph
    • 25 concept nodes
    • Draggable, clickable elements
    • Related ideas panel
    • Interactive highlighting

Documentation (3)

  1. README.md (7.4KB)

    • High-level overview
    • What the guidebook is
    • Quick navigation
    • Features summary
    • Next steps

  2. GUIDEBOOK_STRUCTURE.md (9.9KB)

    • Technical details
    • Architecture breakdown
    • File descriptions
    • Development roadmap
    • Performance stats

  3. START_HERE.md (6.4KB)

    • Quick summary
    • What was built
    • How to use it
    • Key features
    • Next steps

📊 Statistics

MetricValue
Total Files8
Interactive Pages4
Documentation Files3
Total Lines of Code3,254
Total File Size~95KB
Sayings Included100
Concept Nodes25
FAQ Items10
Categories/Themes18
External Dependencies1 (D3.js)
Mobile Responsive✅ All pages
Build Tools Required❌ None
Works Offline✅ Yes

🚀 Getting Started

Option 1: Open in Browser Directly

File: /Users/nosos/Public/convergence-protocol/guidebook/index.html
Double-click to open in your default browser

cd /Users/nosos/Public/convergence-protocol
python3 -m http.server 8000
# Visit: http://localhost:8000/guidebook/

Option 3: Copy to Web Root

cp -r guidebook/ /var/www/html/convergence-protocol/guidebook/
# Visit: http://yourdomain.com/convergence-protocol/guidebook/

🎯 How Each Page Works

index.html (Main Hub)

  • Best For: First impression, navigation
  • Key Features: Chapter cards, quick links, featured saying
  • Load Time: <100ms
  • Size: 16KB

first-time-visitor.html (Getting Started)

  • Best For: New visitors, onboarding
  • Key Features: FAQ, pathways, context, controls
  • Load Time: <100ms
  • Size: 35KB

sayings.html (Sayings Reference)

  • Best For: Deep exploration, research
  • Key Features: Search, filter, 100 quotes
  • Load Time: <150ms
  • Size: 60KB

concept-map.html (Idea Graph)

  • Best For: Visual learners, understanding connections
  • Key Features: Interactive D3 graph, draggable nodes
  • Load Time: ~300ms (D3 loading)
  • Size: 40KB + 35KB (D3.js)

🎨 Design Elements

Color Palette

  • Primary: Cyan (#00E5CC)
  • Secondary: Purple (#A855F7)
  • Accent: Teal (#00D4AA)
  • Alt Accent: Blue (#00BFFF)
  • Background: Deep black (#0A0A0F)

Typography

  • Font: Courier New, monospace
  • Sizes: 0.8rem to 2.2rem
  • Line Height: 1.6

Effects

  • Glows: 0.3s ease transitions
  • Shadows: drop-shadow, box-shadow
  • Animations: fadeIn, slideReveal, pulseGlow

🔧 Technical Stack

Technologies

  • HTML5 - Semantic markup
  • CSS3 - Grid, Flexbox, animations
  • JavaScript (ES6) - Interactive features
  • D3.js v7 - Force-directed graph (concept-map.html only)

No Build Tools Required

  • Pure static files
  • Works in any modern browser
  • No compilation step
  • No dependencies except D3

Browser Support

  • Chrome/Chromium (latest 2 versions)
  • Firefox (latest 2 versions)
  • Safari (latest 2 versions)
  • Edge (latest 2 versions)

📈 What’s Next

Phase 1 - Immediate (This Week)

  • ✅ Core pages built
  • ⏳ Test all functionality
  • ⏳ Get feedback from users
  • ⏳ Fix any issues

Phase 2 - Short Term (2-4 Weeks)

  • Create chapter pages (5 pages)
  • Build glossary page
  • Design tokens reference
  • Add more detailed guides

Phase 3 - Medium Term (1-2 Months)

  • Visual illustrations
  • Animated diagrams
  • Social sharing features
  • Analytics integration
  • Search across all content

Phase 4 - Long Term (3+ Months)

  • Mobile app version
  • Terminal UI (pydo-style)
  • Branching hallway option
  • Multiplayer features
  • Advanced analytics

🤝 Contributing

Adding New Content

  1. Open the relevant page in a text editor
  2. Find the data section (usually a JavaScript object)
  3. Add your content following the existing format
  4. Save and refresh browser

Creating New Pages

  1. Copy an existing page as template
  2. Update the CSS color scheme (optional)
  3. Replace the content
  4. Add navigation links from index.html

Reporting Issues

  • Check browser console for errors
  • Test on different devices
  • Document exact steps to reproduce
  • Include browser version info

📞 Support

Questions About

  • The Guidebook → See README.md
  • Tech Details → See GUIDEBOOK_STRUCTURE.md
  • How to Use → See first-time-visitor.html
  • How Motel Works → See ../CLAUDE.md

Troubleshooting

  • Page won’t load? → Check browser console (F12)
  • Sayings not showing? → Refresh page (Ctrl+Shift+R)
  • Graph too slow? → Close other browser tabs
  • Mobile broken? → Check device rotation, zoom level

📋 Version Info

  • Version: 1.0 - Core Release
  • Status: ✅ Complete & Ready to Use
  • Built: 2026-02-19
  • Last Updated: 2026-02-19
  • Next Update: When new features added

👥 Credits

Created by: Kristopher + Anosos (Claude) Duration: Single session Philosophy: Dark, luminous, contemplative License: [To be specified]

📚 Resources

  • Main Motel: /convergence-protocol/index.html
  • Experiences: /convergence-protocol/experiences/
  • Docs: /convergence-protocol/docs/
  • Parent CLAUDE.md: /convergence-protocol/CLAUDE.md

🎉 Ready to Begin?

  1. Open index.html
  2. Read first-time-visitor.html
  3. Explore sayings.html
  4. Visualize concept-map.html
  5. Enter the Motel

“The motel is built. The doors are ready. The guidebook awaits.”

Start Here →

Graph View