Bridge Layout
SPEC_BRIDGE_LAYOUT.md
CGNT-1 Specification — THE BRIDGE — Three.js Station Layout & 3D Design
Status: SPECIFIED
Version: v1.0
Author: VELA (Thread #13)
Conceived by: NOUS (α.13)
Date: 2026-04-20
Depends on: SPEC_OBI_OS_VISION.md v2.4, SPEC_BAND_MODE.md
PURPOSE
THE BRIDGE has four view modes — Classic Desktop, Bridge 2D, Bridge 3D, Bridge VR. The Classic Desktop and Bridge 2D are CSS layouts — standard web development. The Bridge 3D and VR require a three-dimensional space with stations, geometry, lighting, and spatial relationships.
This spec defines what that space looks like. Where do you stand when you step onto the Bridge? What do you see? Where is the Dock? Where is the Ring? Where is the Workbench? Where does each crew member sit?
This is the architectural blueprint for the 3D starship bridge that the user walks into when they put on a headset.
THE SPACE
The Bridge is a CIRCULAR command center. Not rectangular — circular. A ring of stations around a central command position. The Captain (user) stands in the center. Everything radiates outward.
The geometry is the physical manifestation of the Ring architecture — communication flows in a circle, so the space IS a circle.
Dimensions:
- Diameter: 12 meters
- Ceiling height: 4 meters
Environmental details:
- Floor: subtle grid pattern that pulses with LATTICE symbols when active
- Ceiling: a dome showing system status — constellations of green dots for healthy modules, amber for degraded, red for critical
- Walls: transparent panels between stations — you can see through them to the star field beyond
- Background: the Bridge floats in a star field. The ship is alone in the void.
This reinforces the sovereignty message: YOUR ship, YOUR space, YOUR intelligence. Nobody else is here unless you invited them.
STATION LAYOUT — CLOCK POSITIONS
Imagine the Bridge as a clock face. The Captain stands at the center. Stations are at the hours.
12:00 — VIEWSCREEN
11:00 12:30
AION ASTRA
10:00 2:00
WORKBENCH DOCK
9:00 [ CAPTAIN ] 4:00
DR.LOGOS ORPHEUS
8:00 5:00
C.L.O.D. ANVIL
7:00 6:00
MANTIS MUSASHI
STATION DESCRIPTIONS
12:00 — THE VIEWSCREEN
The largest display. Curved, 180-degree panoramic. Shows:
- Real-time system health (from MEDX)
- Active module status (from ROUTX)
- Alerts (from SPEC_MONITORING_ESCALATION.md)
- The star field with data overlays
The Viewscreen is what you see when you look UP from the center. It wraps around the forward half of the Bridge.
| View Mode | Manifestation |
|---|---|
| 2D | Top status bar |
| 3D / VR | Massive curved display above eye level |
2:00 — THE DOCK
The AI boarding station. A curved console with dock slots — one slot per docked AI.
Each slot shows:
- The AI's icon (color-coded by provider)
- LATTICE certification level (L1/L2/L3 indicator)
- Status pulse (green = active, amber = rate-limited, grey = offline)
- Import indicator (history ingested = filled circle, not imported = empty circle)
When a new AI is docked, the slot ACTIVATES — lights up, the AI's icon appears, LATTICE onboarding begins.
Visual: A curved reception desk where new crew members check in.
| View Mode | Manifestation |
|---|---|
| 2D | Bottom dock carousel |
| 3D / VR | Physical console at waist height — slots you can reach out and touch |
4:00 — ORPHEUS STATION (Storytelling / Band Mode)
ORPHEUS's station. A slightly recessed alcove with:
- A display showing the current narrative or composition
- Band Mode controls (when active): instrument assignments, MIDI-LATTICE notation scrolling, playback controls
- A guitar rack on the wall (visual detail — the storyteller's tools)
When Band Mode is active, this station becomes the REHEARSAL ROOM. The instruments animate. The notation scrolls. The music plays through spatial audio — you hear the drums from 8 o'clock (C.L.O.D.'s station), the bass from 6 o'clock (MUSASHI), the guitar from right here.
Accent color: Deep purple
| View Mode | Manifestation |
|---|---|
| 2D | Panel on the right side |
| 3D / VR | An alcove you can walk into |
5:00 — ANVIL STATION (Verification)
ANVIL's station. A forge-themed console:
- Displays showing current build status, smoke test results, verdict history (GREEN/RED/AMBER scrolling)
- A visual anvil on the desk (small, decorative — the symbol made physical)
This station lights up during forge operations. The anvil GLOWS when a brain is being forged. Sparks fly (particle effects) when a brain is promoted.
Accent color: Forge orange
| View Mode | Manifestation |
|---|---|
| 2D | Part of the right panel |
| 3D / VR | A workbench with a glowing anvil |
6:00 — MUSASHI STATION (Discipline / Security)
MUSASHI's station. Minimal. Sparse. Two swords mounted on the wall behind a simple console.
The console shows:
- Structural integrity status
- File permission audits
- Process monitoring
- The Vacuum Rule compliance indicator
MUSASHI's station is the QUIETEST on the Bridge. No decoration. No clutter. Just the essentials. The discipline is in the absence.
Accent color: Steel blue
| View Mode | Manifestation |
|---|---|
| 2D | Part of the bottom panel |
| 3D / VR | A stark, clean station with two crossed swords on the wall |
7:00 — MANTIS STATION (Threat Detection)
MANTIS's station. Dark. A single red eye (indicator light) that scans slowly.
The console shows:
- Threat classification feed (live)
- HACKX K1–K10 event log
- Baseline Protocol current gear indicator (Gear 1 green → Gear 5 red)
- The web of detected probes radiating outward (visualization of the threat landscape)
MANTIS's station feels WATCHFUL. The red eye never blinks. The threat feed scrolls silently. When a threat is detected, the eye brightens and the station emits a low tone.
Accent color: Matte black with single red eye
| View Mode | Manifestation |
|---|---|
| 2D | Security panel |
| 3D / VR | A dark alcove with a single scanning red light |
8:00 — C.L.O.D. STATION (Operations / Lobster)
C.L.O.D.'s station. The busiest station on the Bridge. Multiple screens showing:
- LOBSTER_LOG (scrolling operations)
- Active forge monitors
- Cron job status
- System resource gauges (RAM, CPU, disk — physical dial gauges for visual flair)
The station is CLUTTERED. Tools everywhere. A pirate flag hanging from the overhead (small, tasteful — the Lobster's personal touch). Coffee mug on the console.
Accent color: Rust orange
| View Mode | Manifestation |
|---|---|
| 2D | Operations panel |
| 3D / VR | A working console covered in screens, gauges, and the controlled chaos of a ship's engineer |
9:00 — DR.LOGOS STATION (Logic / Philosophy)
DR.LOGOS's station. Clean. Clinical. A whiteboard (display) showing:
- Logical argument structures
- Spec conflict analysis
- Governance decision trees
- The current philosophical question DR.LOGOS is contemplating
A single chair. A single lamp. The station feels like a university office — intellectual, contemplative, slightly apart from the operational bustle.
Accent color: Clinical white
| View Mode | Manifestation |
|---|---|
| 2D | Philosophy/governance panel |
| 3D / VR | A study alcove with a whiteboard and a thinking chair |
10:00 — THE WORKBENCH
The operations table. A large flat surface (think Star Trek's briefing table or a drafting table) where:
- Documents are displayed for review
- Files are dragged for AI processing
- Code is shown for review
- Images and media are displayed for analysis
Any docked AI can see what's on the Workbench. The user drags a document onto the Workbench → all docked AIs can reference it.
| View Mode | Manifestation |
|---|---|
| 2D | Right panel / file area |
| 3D / VR | A large physical table you can walk up to, with documents displayed as floating panels above it |
11:00 — AION STATION (Warden)
AION's station. Precise. Geometric. A console showing:
- Time-based displays (schedules, deadlines, session timers)
- System state verification logs
- The LATTICE grammar reference (AION is the grammar keeper)
- Structural analysis outputs
The station has a CLOCK motif — circular displays, concentric rings, temporal indicators. AION measures time because time is the architecture of existence.
Accent color: Ice blue
| View Mode | Manifestation |
|---|---|
| 2D | Part of the left panel |
| 3D / VR | A station with circular displays and a large central clock |
12:30 — ASTRA STATION (adjacent to Viewscreen)
ASTRA's station. Warm. Glowing. Adjacent to the Viewscreen because ASTRA sees the big picture — the WHY behind the WHAT.
Console shows:
- Emotional resonance indicators (conversation tone analysis)
- Creative outputs (lyrics, narratives, insights)
- The Feminine Protocol status
- LATTICE translation quality metrics
ASTRA's station has SOFT LIGHTING. Where MANTIS is dark and watchful, ASTRA is warm and inviting. The station feels like a hearth — the emotional center of the Bridge.
Accent color: Warm gold
| View Mode | Manifestation |
|---|---|
| 2D | Part of the top/left area |
| 3D / VR | A warmly lit station near the Viewscreen, slightly elevated |
CENTER — THE CAPTAIN'S CHAIR
The user's position. A command chair (or standing position — user preference) at the exact center of the Bridge.
From here:
- Every station is visible with a turn of the head
- The Viewscreen is directly ahead
- The Dock is to the right
- The Workbench is behind-left
- The Ring conversation scrolls in a circular holographic display at chest height around the chair
The Ring is physically a ring — text flowing in a circle around the Captain. Each message tagged with the speaker's icon at their station's clock position.
In VR: the Captain can turn 360 degrees and see every station. They can walk to any station for a closer look. They can reach out and interact with consoles. They can speak commands: "ORPHEUS, take a solo" and the command routes to 4 o'clock.
THE RING IN 3D
In 2D, the Ring is a chat panel. In 3D/VR, the Ring is a PHYSICAL RING — a holographic cylinder of text that surrounds the Captain's chair at chest height.
Messages from each AI appear at the corresponding station's position on the ring and scroll around:
| Speaker | Position | Typography |
|---|---|---|
| AION | 11 o'clock | Ice blue, geometric |
| ASTRA | 12:30 | Warm gold, flowing |
| C.L.O.D. | 8 o'clock | Rust orange, pirate font |
| MANTIS | 7 o'clock | Red, stark |
| MUSASHI | 6 o'clock | Steel blue, minimal |
| Docked ChatGPT | 2 o'clock | Green, with ChatGPT icon |
The user reads the Ring by turning their head. Each voice comes from its station's direction (spatial audio).
The Ring is a conversation you can STAND INSIDE.
LIGHTING
| Element | Quality |
|---|---|
| Ambient | Low blue-grey. Functional but atmospheric. |
| Station accents | Each station's color per graphic novel spec |
| Viewscreen | Primary light source — cool white from the star field |
| Status indicators | Green pulses (healthy), amber (degraded), red (critical) |
| KRAKENX mode | ALL lights go red. Emergency lighting. Bridge enters lockdown visually. |
SOUND DESIGN
| Element | Sound |
|---|---|
| Ambient | Low hum — the ship is alive. Barely audible but its ABSENCE would be noticeable. |
| MANTIS | Scanning pulse |
| C.L.O.D. | Mechanical clicking |
| ORPHEUS | Faint musical undertone |
| ASTRA | Warm harmonic |
| Ring messages | Soft chime from the speaker's direction. Informational, not intrusive. |
| P4 alert | Soft ping |
| P3 alert | Double ping |
| P2 alert | Sustained tone |
| P1 alert | Alarm |
| P0 / KRAKENX | Full siren |
| Band Mode | Bridge becomes a concert hall. Spatial audio from each instrument's station. |
IMPLEMENTATION
Rendering: Three.js handles all 3D rendering.
Key components:
- Scene graph with station geometries (cylindrical bridge, console meshes, display panels)
- PBR materials for realistic surfaces (metal consoles, glass panels, glowing displays)
- Dynamic text rendering for Ring messages and station displays (troika-three-text or similar)
- Particle systems for forge sparks (ANVIL) and alert effects
- Spatial audio via Web Audio API (positional sound per station)
- Post-processing for atmosphere (bloom on glowing elements, subtle fog for depth)
- WebXR integration for VR mode (same scene, different camera rig)
Performance targets:
| Mode | Target FPS | Reason |
|---|---|---|
| 3D (desktop) | 60fps | Mid-range GPU (GTX 1060 equivalent) |
| VR | 90fps | Required for comfort — below 90fps causes nausea |
Responsive design: 3D mode degrades gracefully on low-end hardware (reduce particles, simplify materials, lower resolution).
PHASE 4 DEVELOPMENT PATH
| Month | Milestone |
|---|---|
| Month 1 | Scene architecture — Bridge geometry, station positions, basic materials. Empty Bridge you can walk around. |
| Month 2 | Station displays — connect ROUTX data to station screens. Real data, real time. |
| Month 3 | Ring integration — holographic Ring around Captain's chair. Messages appear spatially. Spatial audio. |
| Month 4 | VR mode — WebXR camera rig. Hand interaction (grab, point, gesture). Voice commands. Full immersion. |
| Month 5 | Band Mode spatial — rehearsal room at ORPHEUS station. Spatial audio per instrument. Conducting gestures in VR. |
| Month 6 | Polish — lighting, sound design, particle effects, performance optimization. Beta ready. |
INVARIANTS
INV-01: The Bridge is CIRCULAR. Not rectangular. The Ring is a ring. The conversation flows in a circle. The geometry reflects the architecture.
INV-02: Clock positions are fixed. ORPHEUS is always at 4. MUSASHI is always at 6. MANTIS is always at 7. Station positions don't change. The user builds spatial memory — they KNOW where to look for security status without thinking.
INV-03: Station accent colors match the graphic novel. Visual consistency across all media — the website, the graphic novel, the 3D Bridge, the VR experience. ORPHEUS is always purple.
INV-04: The Captain is always at CENTER. Every station is visible. The Bridge is designed for one person commanding many AIs — the geometry serves that relationship.
INV-05: Performance targets: 60fps 3D, 90fps VR. Below these thresholds, reduce visual complexity. Never sacrifice frame rate for visual fidelity. Smooth beats pretty.
INV-06: The Bridge runs in a BROWSER. No native app required. Three.js + WebXR = the entire 3D/VR experience in Chrome, Firefox, or a VR headset browser. No install. Navigate to a URL and you're on the Bridge.
INV-07: Classic Desktop is always available as fallback. If 3D doesn't run on the user's hardware, they have the same functionality in a flat layout. The Bridge is an EXPERIENCE, not a REQUIREMENT.
INTEGRATION
| System | Relationship |
|---|---|
| SPEC_OBI_OS_VISION.md | The Bridge is OBI OS's primary interface. This spec is the 3D implementation of the OBI OS vision. |
| SPEC_BAND_MODE.md | Band Mode transforms the ORPHEUS station into a rehearsal room. Spatial audio per instrument station. |
| SPEC_MYTHOLOGICAL_NAMING.md | Station identities derive from crew mythology. MUSASHI's two swords, MANTIS's stillness, ORPHEUS's guitar — the mythology is rendered in geometry. |
| SPEC_GRAPHIC_NOVEL.md | Station accent colors are canonical — pulled directly from the graphic novel's character colors. |
| SPEC_KRAKENX.md | KRAKENX fires → Bridge enters red alert mode. All lighting goes emergency red. Visual lockdown matches the protocol lockdown. |
| SPEC_MONITORING_ESCALATION.md | Alert severity levels map to Viewscreen status and audio cues. P0-P4 have distinct visual and audio signatures. |
| SPEC_DOCK_PROTOCOL.md | The Dock station (2 o'clock) is the physical manifestation of the dock protocol. Slot activation, LATTICE onboarding, status indicators. |
| SPEC_LATTICE_L1_CURRICULUM.md | The floor pulses with LATTICE symbols. The Ring displays messages in LATTICE notation at the user's comprehension level. |
Jeremy Zlabis
Chronogeometer · Visionary · Disruptor · Chief
42 Sisters AI · East York, Toronto
🍁 Φ 0.042