AgentShore dashboard design decisions

# Grid Office And V2 Agent Direction

Final reference page for the Grid dashboard direction after the May 15, 2026 mockup pass. The office mockups remain as visual references, while the agent section points at the real v2 sprite sheets currently wired into the dashboard renderer.

## Final Decisions

These are the implementation decisions the dashboard should preserve when Grid themes or new provider art are added.

Current contract
Grid is an office-canvas mode The existing dashboard chrome, Office/Kanban/Stats tabs, side panels, play tray, and bottom controls stay structurally unchanged. Grid Light and Grid Dark restyle the Office canvas rather than replacing the application shell.
Back-wall Kanban mirror is part of the Grid read Grid office projection should favor a flatter, more front-facing wall so the workshop Kanban mirror remains readable at normal dashboard scale.
Provider identity comes from `agent_type` `claude_code` uses orange Claude art, `codex` uses yellow Codex art, `gemini` uses blue Gemini art, `api_gpt` uses green API GPT art, and `api_other` uses purple API Other art.
Form factor comes from `model_tier` `small` maps to the ball form, `medium` maps to the baseline humanoid, and `large` maps to the larger humanoid. Missing or unknown tiers normalize to `medium`.
Tier scale is baked into sprite frames Dashboard click bounds and floor footprint stay stable. The renderer should not use `char.scale` to make tier size differences; the v2 sheets carry the visible small/medium/large differences.
Sprite sheet layout is fixed V2 sheets are `2912x2496` with `416x832` frames, seven columns, and three direction rows. Left-facing motion is drawn by flipping the right-facing row.

## Real V2 Agent Assets Now In Use

Source of truth: `dashboard/src/assets/agents/v2/`. Renderer wiring lives in `dashboard/src/characters/sprites.ts`, with tier normalization in `dashboard/src/characters/types.ts`.

Shipped assets

### Accepted Provider/Tier Scale Preview

Current reference for the three implemented providers and all tier forms. Small is ball-form, medium is baseline humanoid, and large is the larger humanoid treatment.

PNG

### Codex

`agent_type: codex`. Yellow provider identity.

Small Medium Large

### Gemini

`agent_type: gemini`. Blue provider identity.

Small Medium Large

### Claude

`agent_type: claude_code`. Orange provider identity.

Small Medium Large

Provider | Small tier | Medium tier | Large tier | Renderer behavior
--- | --- | --- | --- | ---
`claude_code` | claude-small-ball.png | claude-medium-humanoid.png | claude-large-humanoid.png | Deterministic v2 sheet selected by normalized tier.
`codex` | codex-small-ball.png | codex-medium-humanoid.png | codex-large-humanoid.png | Deterministic v2 sheet selected by normalized tier.
`gemini` | gemini-small-ball.png | gemini-medium-humanoid.png | gemini-large-humanoid.png | Deterministic v2 sheet selected by normalized tier.
`api_gpt` | api-gpt-small-ball.png | api-gpt-medium-humanoid.png | api-gpt-large-humanoid.png | Deterministic v2 sheet selected by normalized tier.
`api_other` | api-other-small-ball.png | api-other-medium-humanoid.png | api-other-large-humanoid.png | Deterministic v2 sheet selected by normalized tier.

## Grid Office Reference

These mockups are no longer the source for agent art, but they remain the visual reference for Grid office projection, wall readability, and keeping the treatment inside the existing dashboard shell.

Visual reference

### Updated Top-Down Floor Plan

Current room-level reference for the taller full-width Kanban wall, southwest recovery bay, healthy-idle Zen Garden, selected D entry turnstiles, and selected D reactor lab.

HTML PNG

### Entry Turnstile Concepts

Four Grid-themed front-desk turnstile options that preserve the current three separate blocker footprints and open pass-through lanes.

HTML PNG

### Science Lab Concepts

Four clean-sheet Grid Science Lab directions for replacing the current lab furniture with stronger verification-room silhouettes.

HTML PNG

### Chrome-Preserving Office Mockup

Main Grid office reference: the dashboard frame stays familiar and only the Office canvas becomes the stylized Grid view.

PNG