Skip to content

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:

  • temperature with:
  • 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