Bridge Layout

SPEC_BRIDGE_LAYOUT.md · 2026-04-20

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:

Environmental details:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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