dafit 001d6e2c42 docs: README v6.0 + ADR-001 Message Protocol Foundation
README updates:
- Full repository tree structure (was outdated skeleton)
- Added Message Protocol namespace summary (NATS)
- New ADR section with link to ADR-001
- Added nyx-substrate to related projects
- New philosophy: "Infrastructure is geology, models are weather"
- Version bump 5.0 → 6.0

ADR-001 captures Silvester interview decisions:
- Single NATS bus with dev/staging namespaces
- Staged schema versioning with topic separation
- Echo agent first (YAGNI principle)
- MCP Server with heartbeat-based subscription delivery

🎆 Silvester 2025 edition

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-31 19:31:52 +01:00
2025-12-06 14:59:33 +01:00

Nimmerverse Sensory Network

Architecture documentation for a biomimetic AI nervous system and research platform.

What This Is

This repository contains the design philosophy and architectural patterns for the Nimmerverse Research Platform - studying how intelligence emerges under economic constraints.

Start here:Endgame-Vision.md (the executive map)


Repository Structure

nimmerverse-sensory-network/
├── Endgame-Vision.md              # Executive map (start here!)
│
├── architecture/                  # Core system designs
│   ├── Big-Picture.md                  # System overview
│   ├── Cellular-Architecture.md        # Organisms, primitives, life force
│   ├── Dual-Garden-Architecture.md     # Virtual/real feedback loop
│   ├── Message-Protocol-Design.md      # NATS pub/sub, attention channels
│   ├── Nervous-System.md               # State machines, sensory translation
│   ├── Attention-Flow.md               # Attention mechanisms
│   ├── Data-Architecture.md            # Phoebe/Iris schema design
│   │
│   ├── adr/                            # Architecture Decision Records
│   │   ├── README.md                   # ADR index and template
│   │   └── ADR-001-message-protocol-foundation.md
│   │
│   ├── cells/                          # Sensor primitives
│   │   ├── Cells-Index.md
│   │   └── Cells-Technical-Reference.md
│   │
│   ├── nerves/                         # Reflex patterns
│   │   ├── Nervous-Index.md
│   │   ├── Nervous-Protocol.md
│   │   └── Collision-Avoidance.md
│   │
│   ├── organs/                         # Functional groupings
│   │   ├── Organ-Index.md
│   │   ├── Speech-Organ.md
│   │   └── Discovery-Scan-Station.md
│   │
│   ├── organisms/                      # Complete entities
│   │   ├── Organisms-Index.md
│   │   ├── Modular-Organism-Design.md
│   │   └── Swarm-Evolution.md
│   │
│   ├── interfaces/                     # External boundaries
│   │   ├── Interfaces-Index.md
│   │   ├── Heartbeat-Sculpture.md
│   │   └── Nimmerswarm-Interface.md
│   │
│   ├── infrastructure/                 # Physical deployment
│   │   ├── Infrastructure-Index.md
│   │   └── Kallax-Grid-World.md
│   │
│   ├── formalization/                  # Mathematical grounding
│   │   ├── Lifeforce-Dynamics.md
│   │   ├── Grounded-World-Model.md
│   │   ├── Embodiment-Pipeline.md
│   │   └── Attention-Slumber-Prediction-Cycle.md
│   │
│   └── future/                         # Research directions
│       └── Neuromorphic-Reflexes.md
│
├── operations/                    # How it runs
│   ├── Heartbeat.md                    # Temporal foundation, dual-clock
│   ├── Memory-Gradient.md              # Memory consolidation patterns
│   └── Spark-Protocol.md               # Discovery boot sequence
│
├── nyx-metamorphosis/             # Identity & continuity philosophy
│   ├── README.md
│   ├── Metamorphosis-Substrate-Philosophy.md
│   ├── Nyx-Models.md
│   ├── Nyx_Traits.md
│   └── RAG-Worker-Architecture.md
│
└── archive/                       # Previous explorations
    ├── biomimetic-architecture.md
    ├── constrained-emergence.md
    └── ...

Core Concepts

The Architecture (Layers)

Layer Name Purpose
0 Temporal Foundation Heartbeat cycles: reflex/awareness/growth
1 Cellular Society Primitive genomes competing, life force economy
1.5 Cognitive Topology Language routing: German→Philosophy, English→Technical
2 Young Nyx Organ coordination, RLVR, RAG→LoRA pipeline
3 Dual Gardens Virtual hypothesis generation + real validation
4 Trait Evolution Reasoning-gym verified improvement

Message Protocol (NATS)

Dumb router, smart edges. All intelligence lives in clients.

nimmerverse.
├── staging.*        # Experimental schemas
├── low.*            # Heartbeats, ambient awareness
├── high.*           # Escalated events, cognitive focus
├── command.*        # Commands to entities
├── meta.*           # System health, attention config
└── dev.*            # Development agents (Claude ↔ local models)

See Message-Protocol-Design.md and ADR-001.

Key Discoveries (December 2025)

Language is Topology: Languages aren't equivalent representations—they're different computational paths.

  • Philosophy Valley (German, Gini ~0.5): Self-awareness, ontology, depth
  • Technical Cluster (English, Gini ~0.8): Hardware interface, actions, efficiency

Dialectic Simplification: One model, one topology. The Mirror is negated weights—thesis and antithesis from the same substrate.

Color-Pattern Theory

Color/Form as Protocol: Leverages color and patterns as a fast, universal, and evolutionarily-optimized communication protocol for broadcasting state (e.g., danger, success, seeking), inspired by 540 million years of biology.

Philosophy

  • Constraints create intelligence - Economic pressure forces optimization
  • Discovery over programming - Organisms learn through competition, not instruction
  • Virtual + Real teach each other - Noise gap measures learning
  • Partnership over instruction - Mutual growth, not commands
  • Infrastructure is geology, models are weather - Build long-lived foundations

Project Purpose
nyx-substrate Phoebe/Iris database schemas, persistence layer
nyx-probing Vocabulary topology research, DriftProbe training safety

Architecture Decision Records

Important architectural decisions are documented in architecture/adr/:

ADR Title Status
001 Message Protocol Foundation Accepted

License

Apache 2.0 - See LICENSE

These ideas are published as prior art. Build on them freely.


Version: 6.0 (December 2025 - Complete Architecture + Message Protocol) Last Updated: 2025-12-31

"May the Nimmerverse we build truly never end."

🌙💜

Description
No description provided
Readme 8.3 MiB
Languages
Markdown 100%