---
path: /studio/hathor/theory
surface: studio
domain: hathor
auth: signed-in + studio entitlement
source: apps/oshun/web/src/app/studio/hathor/theory/page.tsx
status: walked
last_walked:
  '2026-05-29 automated runtime walk (Playwright headless) — render, /v1 data
  (2xx), console/page-errors, expected content, screenshot verified; live
  screen-reader, touch, offline, and telemetry-delivery checks pending a manual
  AT pass. Evidence: WALKTHROUGH/results/runtime-sweep-2026-05-29.md; body
  re-derived 2026-06-03 from current source (lane-console architecture)'
---

# Studio Hathor · Theory

## Purpose

Aggregator surface for the Hathor design-theory cluster. It mounts a Capability
Summary plus four embedded lanes — Game Design Theory (MDA), Narrative Theory
Tooling, Culture Modeling, and Legal Systems Modeling — so the worldbuilding
theory tools are reachable from one page. It issues no `/v1` fetch of its own;
each embedded lane owns its data.

## Entry points

- **Direct URL / bookmark** — `/studio/hathor/theory`; `alternates.canonical` is
  set.
- **Breadcrumb / quick-action** — Studio › Hathor Game Design Theory (MDA) ›
  Theory; this page links to MDA, Narrative Theory Tooling, Culture Modeling, and
  Legal Systems Modeling.
- **Studio overview** — see [`../../studio-overview.md`](../../studio-overview.md).

## Layout regions

`page.tsx` renders inside `<ShellLayout active="studio">`:

- **Breadcrumb panel** (`<section data-hathor-theory-breadcrumbs>`): Studio →
  Hathor Game Design Theory (MDA) → Theory (current).
- **Workspace** (`StudioHathorTheoryWorkspace`, `data-hathor-theory-workspace`):
  - `<h1>` `WorkspaceHeading` — "Hathor Theory Workspace"
  - Summary `<p data-hathor-theory-summary>`
  - **Capability Summary** (`data-hathor-theory-capability-summary`, `<h2>`):
    4 capability cards.
  - **Game Design Theory (MDA) Lane** (`data-hathor-theory-game-design-lane`,
    `<h2>`): embeds `StudioHathorGameDesignTheoryMdaWorkspace`.
  - **Narrative Theory Tooling Lane** (`data-hathor-theory-narrative-lane`,
    `<h2>`): embeds `StudioHathorNarrativeTheoryToolingWorkspace`.
  - **Culture Modeling Lane** (`data-hathor-theory-culture-lane`, `<h2>`): embeds
    `StudioHathorCultureModelingWorkspace`.
  - **Legal Systems Modeling Lane** (`data-hathor-theory-legal-lane`, `<h2>`):
    embeds `StudioHathorLegalSystemsModelingWorkspace`.
- **Route Map panel** (`<section data-hathor-theory-route-map>`,
  `<h2>Route Map</h2>`): 6 entries from `STUDIO_HATHOR_THEORY_ROUTE_MAP`.
- **Quick-action lane** (`className="quickAction"` Links): Game Design Theory
  (MDA), Narrative Theory Tooling, Culture Modeling, Legal Systems Modeling, Back
  to Studio workspace index.

## States

- [ ] **Each embedded lane** — Loading / Unauthorized / Error / Ready / Result,
      per the lane's own doc (MDA, Narrative Theory Tooling, Culture Modeling,
      Legal Systems Modeling).

## Interactions

- [ ] **Embedded lane interactions** — delegated to the four child workspaces;
      see their docs for fields and submit verbs.
- [ ] **Route Map entries** — verify against `STUDIO_HATHOR_THEORY_ROUTE_MAP`
      (6 entries).
- [ ] **Quick-action links** — Game Design Theory (MDA)
      (`/studio/hathor/game-design-theory-mda`), Narrative Theory Tooling
      (`/studio/hathor/narrative-theory-tooling`), Culture Modeling
      (`/studio/hathor/culture-modeling`), Legal Systems Modeling
      (`/studio/hathor/legal-systems-modeling`), Back to Studio (`/studio`).

## Data & contracts

- **Reads / Writes**: none from this aggregator; the four embedded lanes own
  their contracts (e.g. `/v1/admin/hathor/game-design-theory-mda`,
  `/v1/admin/hathor/legal-systems-assessment`).
- **Realtime**: none.
- **Caching**: n/a here; each child lane fetches on mount, `cache: 'no-store'`.
- **Auth**: route is behind the signed-in + studio proxy gate; the embedded
  lanes are admin-scoped and fail-closed.

## Cross-references

- Parent: [`../../studio-overview.md`](../../studio-overview.md)
- Component sources:
  - `apps/oshun/web/src/components/studio/StudioHathorTheoryWorkspace.tsx`
  - `apps/oshun/web/src/components/studio/StudioHathorTheoryRouteMap.ts`
  - Embeds `StudioHathorGameDesignTheoryMdaWorkspace`,
    `StudioHathorNarrativeTheoryToolingWorkspace`,
    `StudioHathorCultureModelingWorkspace`,
    `StudioHathorLegalSystemsModelingWorkspace`
- Siblings:
  [`./studio-hathor-game-design-theory-mda.md`](./studio-hathor-game-design-theory-mda.md),
  [`./studio-hathor-narrative-theory-tooling.md`](./studio-hathor-narrative-theory-tooling.md),
  [`./studio-hathor-culture-modeling.md`](./studio-hathor-culture-modeling.md),
  [`./studio-hathor-legal-systems-modeling.md`](./studio-hathor-legal-systems-modeling.md)

## Open questions / known gaps

- [ ] Hathor is `unconfirmed-v1` per `WALKTHROUGH/matrix/routes.csv`; confirm
      whether the dedicated `/studio/hathor/*` surfaces ship V1 or are
      internal-only.