Files
nimmerverse-sensory-network/architecture/organisms/Organisms-Index.md
dafit dff124f9b7 feat: Architecture expansion - organisms, swarm evolution, memory gradient, infrastructure
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>
2025-12-29 11:09:50 +01:00

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

  1. Modularity — One function per module, hot-swappable
  2. Universal Connector — Same interface for all connections
  3. CAN Inside, NATS Outside — Local bus, global network
  4. Magnetic Alignment — Self-aligning, idiot-proof
  5. Cellular Mapping — Software cells → hardware modules
  6. Economic Incentives — Clasp rewards sharing (+13.5 LF)
  7. 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.