Building a Walker Panel
Walker panels are live semantic surfaces.
A panel consumes structured runtime events and turns them into a readable, interactive display.
Examples:
- a piano roll,
- a vehicle dashboard,
- a mission tracker,
- a reactor monitor,
- a tactical map,
- or a live ensemble balance surface.
A panel is not responsible for simulation logic. It observes and presents state coming from a runtime system.
The standard Walker panel architecture separates:
| Layer | Responsibility |
|---|---|
| Core | Pure state and derived values |
| Host Store | Runtime integration and transport updates |
| Surface Store | Renderer-friendly projection |
| Panel | DOM rendering and interaction |
| Transport | SSE/network event delivery |
This separation allows panels to:
- run headless in tests,
- replay sessions deterministically,
- survive renderer rewrites,
- and evolve domain semantics independently of UI code.
Then immediately:
Your First Panel
“We are going to build a tiny reactor temperature monitor.”
And do it end-to-end.
Tiny. Like:
- one event,
- one state value,
- one panel,
- one live update.
People learn frameworks by getting a thing moving. Not by reading architecture prose.
Then after the tiny example works:
Expanding Into Your Domain
Now replace:
temperaturewith:- musical tension,
- vehicle health,
- tactical pressure,
- NPC morale,
- weather severity,
- or any other domain metric.
Walker does not care what your domain is. It only requires:
- stable event contracts,
- deterministic state projection,
- and renderer-safe surface state.
THAT is the missing tutorial layer.
Then later you can branch into:
- “Building a multi-agent panel”
- “Using RunnerTransport”
- “Synchronizing with time”
- “Integrating HUDyML”
- “Panel docking”
- “Trace replay”
- etc.
Another extremely important addition:
You should explicitly teach the philosophy:
- transport events are not UI events,
- domain state is not renderer state,
- metrics are not semantics,
- and panels should tolerate incomplete telemetry.
That philosophy is scattered across your plans implicitly. It should become explicit doctrine.
And then lightly reference the future metrics doc like:
Metrics and Meaning
This guide intentionally avoids prescribing metric semantics.
Walker panels can represent:
- musical balance,
- reactor stability,
- tactical cohesion,
- ecological health,
- social trust,
- or any other domain-specific interpretation.
For guidance on designing meaningful metrics and avoiding misleading score
systems, see:
PLAN-METRICS-AND-SEMANTICS.md