New sections created: - organisms/ - Modular robot design (CAN bus + magnetic pogo connectors) - infrastructure/ - Kallax Grid World (40×40×40cm standardized cells) Core documents added: - Swarm-Evolution.md - Ternary clasp rules, escalation ladder (L0-L5), Mount Olympus council - Modular-Organism-Design.md - ESP32 modules, universal connector spec, Phase 0 BOM - Memory-Gradient.md - Metacognitive routing (renamed from RAG-as-Scaffold.md) - Kallax-Grid-World.md - Sim-to-real substrate, "schrotti cyberpunk" aesthetic Enhanced: - Nimmerswarm-Interface.md - Dual-spectrum architecture (IR position + visible state) - Attention-Slumber-Prediction-Cycle.md - Blend marker predictions extension Key insights: Decision markers (mark+continue+predict), Low-Cost-Mocap integration 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
4.5 KiB
Organisms Index
The little ones — physical robots that inhabit the Nimmerverse.
Overview
Organisms are the physical embodiment of Nimmerverse intelligence. Built from modular components, communicating via CAN bus internally and NATS externally, they navigate the Kallax Grid World, form reflexes, and learn through interaction.
Philosophy: One function, one module. Same connector everywhere. Snap together, communicate, evolve.
Core Documents
Modular-Organism-Design.md
The foundational hardware architecture.
- CAN bus backbone
- Magnetic pogo connectors
- Module types (Brain, Motor, Sensor, LED, Power, Gripper)
- Clasp protocol (organism↔organism)
- Phase 0 Box Robot (~113 CHF)
- Status: Core concept, ready to prototype
Swarm-Evolution.md
How the hivemind learns, evolves, and resolves conflict.
- Temporal-Ternary clasp rules (gradient-based transfer)
- Escalation ladder (Level 0-5: Reflex → Mount Olympus)
- Organism hierarchy (Love children, Elders, Adults, Young)
- Blend escalation protocol (ties → wait state → higher mind)
- Mount Olympus council mode (dafit + Chrysalis + Nyx)
- Status: Core evolutionary dynamics
Planned Documents
Connector-Specification.md (planned)
Detailed specification for the universal magnetic pogo connector.
- PCB layout files
- Magnet specifications
- Pogo pin sourcing
- Assembly instructions
Phase-0-Box-Robot.md (planned)
Build guide for the simplest organism.
- Bill of materials with links
- Assembly steps
- Firmware flashing
- First test procedures
Module-Firmware.md (planned)
Common firmware architecture for all modules.
- CAN message handling
- Heartbeat protocol
- OTA update mechanism
- Power management
Clasp-Protocol-Detail.md (planned)
Deep dive into organism-to-organism communication.
- Physical docking sequence
- CAN bus bridging
- Data transfer formats
- Error handling
Design Principles
- Modularity — One function per module, hot-swappable
- Universal Connector — Same interface for all connections
- CAN Inside, NATS Outside — Local bus, global network
- Magnetic Alignment — Self-aligning, idiot-proof
- Cellular Mapping — Software cells → hardware modules
- Economic Incentives — Clasp rewards sharing (+13.5 LF)
- Progressive Complexity — Box → Platform → Articulated
Connection to Other Sections
| Section | Relationship |
|---|---|
cells/ |
Software cells map to hardware modules |
nerves/ |
Reflexes run on organism hardware |
interfaces/ |
LED matrix, IR positioning |
infrastructure/ |
Kallax Grid World habitat |
organs/ |
Organisms interact with organs |
Hardware Stack
ORGANISM LAYERS
┌─────────────────────────────────────┐
│ NATS (Nimmerverse) │ ← Global communication
├─────────────────────────────────────┤
│ WiFi (Brain module) │ ← External interface
├─────────────────────────────────────┤
│ CAN BUS (internal) │ ← Module backbone
├─────────────────────────────────────┤
│ ┌───────┐ ┌───────┐ ┌───────┐ │
│ │ BRAIN │ │ MOTOR │ │ LED │ ... │ ← Modules
│ │ ESP32 │ │ ESP32 │ │ ESP32 │ │
│ └───┬───┘ └───┬───┘ └───┬───┘ │
│ │ │ │ │
│ 🧲●●●●🧲 🧲●●●●🧲 🧲●●●●🧲 │ ← Magnetic pogo connectors
└─────────────────────────────────────┘
File: Organisms-Index.md Version: 1.0 Created: 2025-12-29 Status: Section established Philosophy: "From code to metal, each layer has a home."
🤖🧲⚡ The little ones are coming.