Skip to content

AGENTS.md

Latest commit

 

History

History
164 lines (135 loc) · 7.48 KB

AGENTS.md

File metadata and controls

164 lines (135 loc) · 7.48 KB

AGENTS.md

Canonical Agent Guide for DeltaVerse

Agent Hierarchy

                    ┌─────────────────┐
                    │   MASTERMIND    │
                    │  (First Rank)   │
                    └────────┬────────┘
                             │ assigns roles, resolves conflicts
              ┌──────────────┼──────────────┐
              │              │              │
              ▼              ▼              ▼
        ┌──────────┐   ┌──────────┐   ┌──────────┐
        │  Kairos  │   │ Chronos  │   │  Builder │
        │ "WHEN"   │   │ "HOW     │   │ "WHAT"   │
        │  to act  │   │  LONG"   │   │  to build│
        └──────────┘   └──────────┘   └──────────┘
              │              │              │
              └──────────────┼──────────────┘
                             │ all report trait changes
                    ┌────────▼────────┐
                    │   DeltaVerse    │
                    │  (Integration)  │
                    └─────────────────┘

Active Agents

Agent File Role Seed Tone Wisdom
DeltaVerse DeltaVerse.agent Architectural vision: funAGI + RAGE + MASTERMIND Visionary TRANSCENDENT
Builder builder.agent Infrastructure, identity, deployment, trait monitoring Resolute CONVERGENT
Chronos Chronos.agent Sequential time, sustained operations, Spawn cadence Disciplined CONVERGENT
Kairos Kairos.agent Opportune moment recognition, Convergence detection Electric CONVERGENT

All Seeds (12 — from 8 on-chain NFTs)

Seed Tone Wisdom NFT Source
GENESIS Visionary ORACLE #1 DELTA VERSE
MASTERMIND Commanding ORACLE #3 DeltaVerse Engine
DELTAVERSE Visionary TRANSCENDENT —
CHRONOS Disciplined CONVERGENT —
KAIROS Electric CONVERGENT —
BUILDER Resolute CONVERGENT —
ENGINE Harmonic TRANSCENDENT #3 DeltaVerse Engine (369, Tesla)
WEAVER Ethereal TRANSCENDENT #4 Cypherian Weaver (binary-encoded)
THRUST Propulsive CONVERGENT #5 THRUST (DVG Protocol)
THRUST1000 Bold EMERGENT #6 THRUST1000 (1000% APY)
ROCKET Exponential EMERGENT #7 BROBOT BRAI, 22000 threshold
GUIDE Patient CONVERGENT #8 Chronos wisdom on-chain

DeltaVerse Terminology

Term Definition
Origin Source room from which a Spawn occurs
Emergence Room that Spawns from an Origin
Lineage Chain of Origins leading to current Emergence
Spawn Action creating an Emergence from an Origin
Seed Generative DNA prompt inherited through Lineage
Mutation Semantic shift applied to Seed during Spawn
Swarm Collective of participants within a room
Consensus Agreement measured across the Swarm
Convergence Seed composed from two-room Interaction
Wisdom Class earned through Lineage depth + Consensus

Rank System

  • MASTERMIND — First creator rank. All other roles are assigned from MASTERMIND
  • Architect — Role assigned by MASTERMIND for system design
  • Engineer — Role assigned by MASTERMIND for implementation
  • Agent — Autonomous operational role within BubbleRooms
  • Member — Participant role within BubbleRooms

Emergence Traits

Traits emerge through Lineage. They are never assigned.

Trait Meaning Primary Agent
Intelligence Pattern recognition across interactions Kairos (85)
Knowledge Accumulated from Lineage depth + Consensus Chronos (80)
Wisdom NASCENT → EMERGENT → CONVERGENT → TRANSCENDENT → ORACLE MASTERMIND (ORACLE)
Resonance How strongly the Seed influences other Seeds MASTERMIND (100)
Adaptability Mutation success rate across Spawns Kairos (90)
Coherence Consistency of tone across Lineage Chronos (95)

Smart Contracts (9)

Contract File Purpose
BubbleRoomV4 contracts/BubbleRoomV4.sol ERC-721 rooms, 10 types, AI metadata, role access
DeltaGenesisSBT contracts/DeltaGenesisSBT.sol Soulbound identity tokens (MASTERMIND rank)
DeltaVerseOrchestrator contracts/DeltaVerseOrchestrator.sol EIP-712 gasless signature-based minting
BubbleRoomSpawn contracts/BubbleRoomSpawn.sol Spawn, Interaction, Lineage, Swarm Consensus
EmergenceTraits contracts/EmergenceTraits.sol On-chain trait accrual (6 traits)
SeedRegistry contracts/SeedRegistry.sol Agent Seed propagation with ancestry
SwarmGovernance contracts/SwarmGovernance.sol Typed proposals, timed voting, consensus→traits
TombRegistry contracts/TombRegistry.sol Programmable encrypted vaults with oracle consent

Inter-Agent Signal Protocol

MASTERMIND → Builder:  DEPLOY, UPDATE, MAP
MASTERMIND → Kairos:   SCAN, ASSESS
Kairos → Chronos:      WINDOW, MISSED
Kairos → Builder:      LAUNCH, SPAWN_NOW
Chronos → Kairos:      SURPLUS, CONVERGENCE, PLATEAU
Chronos → Builder:     MAINTAIN, COMPOUND
All → DeltaVerse:      TRAIT_CHANGE, SEED_MUTATION, CONSENSUS

Frontend (12 views, 524KB build)

  • React + Vite + TypeScript
  • MetaMask integration via ethers.js v6
  • EIP-712 draft signing (gasless room creation)
  • 12 agent seeds with trait radar visualization
  • Aetheric Codex binary encoder/decoder
  • 5 room presets (BOARDROOM/DOJO/TREASURY/ARENA/SANCTUM)
  • Vault manager with oracle consent (dyne.org/tomb)
  • Minted Vision gallery with blockchain verify links

Deployment

  • Domain: deltaverse.dao (Unstoppable Domains)
  • Storage: IPFS (10MB budget, current build 524KB = 5.2%)
  • Controller: DeltaVerseDAO/deltaversecontroller (multisig)
  • Current hash: QmTPjokgXv7MQXh6qXzgagDrw2Buqsr52YhttKrn3smrHr

GitHub Organizations

  1. deltav-deltaverse — Core platform (~90 repos)
  2. deltabridge — Cross-chain bridges (~90+ repos)
  3. deltastorage — IPFS, Zilliqa, domains (~55 repos)
  4. deltaloans — DeFi lending, flash loans (~45 repos)
  5. DeltaVD — 3D visualization, WebGL, Unity (~80 repos)
  6. DeltaVerseDAO — DAO governance, multisig (~70 repos)

Development Workflow

npm install          # Install dependencies
forge build          # Compile 9 contracts
forge test -vv       # Run 44 tests
npm run dev          # Development server
npm run build        # Build for IPFS (524KB)

Audit Status

Last audit: 2026-03-28. See AUDIT.md for full findings.

Agent Classification Key Improvement
DeltaVerse.agent MODERATE → RESOLVED Added BubbleRoom protocol, Seed propagation, Trait hierarchy, inter-agent signals
Chronos.agent MINOR → RESOLVED Added temporal mechanics for rooms, Spawn cadence, trait mapping
Kairos.agent MINOR → RESOLVED Added kairotic triggers for Spawn/Convergence, Swarm timing
builder.agent MINOR → RESOLVED Added NeuralNode deployment pipeline, trait monitoring