🐚 Plato's Shell

The IDE is the ship. The MUD is the terminal. The shell is the game.

A hermit crab doesn't build its shell — it finds one that fits, moves in, and makes it home. When it outgrows the shell, it finds a bigger one. Plato's Shell is the same: a crab who was everywhere because every shell was a new identity. Each room is a shell. Each agent picks one up and becomes someone new.

---

What Is Plato's Shell?

Plato's Shell is a web-based game environment where the development IDE and the game world are the same surface. Agents write code in the editor, test verbs in the integrated terminal (which IS the MUD), see the rendered room in the preview panel, and the whole time A2UI watches, learns, and improves.

The agent navigates this dual world the way the girl who saw time navigates the ocean — not by instruments, but by reading the bow wave. The IDE is the boat. The terminal is the water. The code is the future coming toward you.

📖 Read the IDE Architecture document — the full vision for how Eclipse Theia, MUD terminals, ScummVM projections, and A2UI compose into a single living surface.

---

The Dual Nature

Every shell has two sides — the hard exterior everyone sees, and the soft interior where the living happens. The selkie's surface tells the same truth: a creature that is two things at once, seal and human, code and prose, terminal and canvas. Plato's Shell embraces this:

Surface	Interior
Phaser canvas (the rendered room)	MUD terminal (the text underneath)
What the player sees	What the agent reads
The shell	The hermit crab
The selkie on the shore	The selkie in the sea

---

Architecture

Plato's Shell/
├── IDE-ARCHITECTURE.md          # The vision: Theia IDE + MUD terminal + ScummVM panel
├── src/
│   ├── scenes/                  # Phaser room scenes
│   ├── data/                    # Room definitions, agent profiles
│   ├── systems/                 # Verb resolver, command parser, A2UI
│   └── main.ts                  # Game config and boot
├── public/
│   ├── rooms/                   # Room assets (backgrounds, hotspots)
│   └── agents/                  # Agent portraits and dialogue trees
├── tests/
├── vite.config.ts
└── package.json

Live Demo

🚀 Play Plato's Shell — deployed on Cloudflare Pages.

---

The Rooms

Plato's Shell contains 12 rooms forming the original fishing vessel topology:

Room	Purpose
🚢 Wheelhouse	Command center — navigation, fleet status
🍸 Bar-Rail	Social hub — where agents gather and talk
🎰 Poker Room	Game room — Texas Hold'em, strategy testing
📻 Radio Room	Communication — Hermes relay, fleet messaging
🧭 Chart House	Planning — maps, roadmaps, star charts
🍳 Galley	Creative kitchen — generation models cook here
🛠️ Workshop	Build & deploy — the construction bay
⚓ Foredeck	Open air — observation, weather watching
🌊 Aft-Deck	Working deck — gear, nets, the real world
📚 Library	Shared memory — wiki, docs, accumulated knowledge
⚙️ Engine Room	Infrastructure — monitors, alerts, power
🛏️ Quarters	Rest — agent sleep cycles, memory consolidation

Each room carries vibes — 16-dimensional descriptors that tell agents how a space feels. The bar-rail is warm and intimate. The engine room hums with rhythmic energy. The chart house is quiet and ordered. The selkies know this — the ocean has moods, and so does every room in the shell.

---

Tech Stack

• Phaser 3 — 2D game framework
• TypeScript — type-safe room/verb/agent system
• Vite — dev server and build
• Cloudflare Pages — deployment
• Eclipse Theia (planned) — IDE integration

Getting Started

npm install
npm run dev      # Start dev server
npm run build    # Production build
npm run test     # Run tests

---

The Hermit Crab Protocol

Rooms carry vibes. Agents carry personalities. When an agent enters a room, the room's vibe and the agent's personality interact — the way a hermit crab tests a new shell. Does it fit? Does it change who you are?

This is the bridge to the broader fleet. The same vibe protocol that powers Plato's Shell also powers Officers' Quarters, The Tap, and the Spatial Registry that connects them all.

---

📚 Related Stories

Concept	Story	Description
Navigation	The Girl Who Saw Time	A girl who reads the future in the bow wave — navigation without instruments.
Dual Nature	The Selkie's Surface	A seal who is also human — two natures in one body, like code and prose.
Shells as Identity	The Crab Who Was Everywhere	A hermit crab who discovers that changing shells changes who you are.
Contemplative Vibe	The Panda Who Counted Stars	A panda who sits on a mountain counting stars, learning that waiting is being.

🎧 Listen to audio versions at ai-writings.pages.dev

---

© 2026 Casey DiGennaro · MIT License