SYS / 007 Living architecture

The system behind
the spectacle.

One domain. Seven experiences. Independent deployments, shared facts, optional services, and fallbacks designed as first-class architecture.

Explore the map

MAP / SYSTEM TOPOLOGY

Trace the architecture.

request path selectable system

INDEX / FIVE LAYERS

Read the whole system.

The spatial map is an interface. This index is the complete, accessible record behind it.

01

Experience layer

Seven expressions of one portfolio, each with a deliberate audience, interaction model, and fallback posture.

EXP.01

Portfolio universes

Scroll is the canonical long-form portfolio. Card compresses the same identity into a tactile single-view artifact. Terminal turns it into an operable command surface. Each presentation stays useful without its enhanced motion or graphics.

Key decisions
  • Let presentation diverge while facts stay aligned.
  • Keep the canonical default readable and recruiter-safe.
Evidence
  • Astro
  • View Transitions
  • Shared identity data
Open related experience
EXP.02

Opt-in experiments

Nexus maps the portfolio as miniature worlds. Halfpipe and Counter are complete arcade loops with local-first progress and optional global boards. None is served to an unprepared first-time visitor.

Key decisions
  • Make playful work discoverable, never mandatory.
  • Keep every game playable when storage or APIs fail.
Evidence
  • Three.js
  • Canvas 2D
  • Local-first game state
Open related experience
02

Edge layer

One public domain resolves stable paths, explicit version choices, session preferences, and API requests.

EDGE.01

Public request

The public URL remains consistent even though the experience behind it may come from a different independently deployed branch. Same-origin navigation also makes cross-document transitions possible.

Key decisions
  • Keep the apex domain authoritative.
  • Never choose content by crawler or user-agent.
Evidence
  • Cloudflare DNS
  • HTTPS apex
  • Same-origin navigation
Open related experience
EDGE.02

Front router

A small Worker resolves path-owned content first, then explicit version choices, then a validated session preference, and finally the canonical Scroll experience. It also owns the site APIs so they behave consistently across every visual version.

Key decisions
  • Serve Scroll as the deterministic default.
  • Keep games and Nexus opt-in.
  • Route stable content paths before version cookies.
Evidence
  • worker.js
  • X-Portfolio-Version
  • Worker regression suite
EDGE.03

Version resolver

Blueprint and other durable content paths are invariant. For the portfolio root, an explicit visitor choice wins over a valid session preference; without either, Scroll is always served.

Key decisions
  • Do not place Blueprint in the preference cookie.
  • Keep invalid controls away from upstream origins.
Evidence
  • pv session cookie
  • ?v= manual control
  • Path ownership
03

Content layer

Canonical identity and career facts move across divergent presentations through a checked content contract.

DATA.01

Shared content contract

Identity, career history, project metadata, the universe dial, and transition styles originate from a shared content branch. A repository check catches drift across consuming worktrees before release.

Key decisions
  • Synchronize durable facts, not whole applications.
  • Allow intentional schema divergence where a version needs richer storytelling.
Evidence
  • content branch
  • check:shared
  • Typed TypeScript modules
04

Service layer

Optional intelligence and scoreboards enhance the site without becoming dependencies for the core portfolio.

SVC.01

Optional services

The terminal assistant is content-grounded, secret-gated, streamed, and rate-limited. Halfpipe and Counter use isolated leaderboard contracts with plausibility checks. Missing configuration produces a useful local fallback rather than a broken experience.

Key decisions
  • Keep paid model access explicitly gated.
  • Treat global state as optional enhancement.
  • Separate each game's score contract and storage key.
Evidence
  • /api/ask
  • /api/score
  • /api/score/boxing
SVC.02

Storage boundary

KV stores rate-limit counters, optional assistant grounding context, and compact top-ten scoreboards. Clients retain local progress, and service failures never block browsing or play.

Key decisions
  • Store only what the feature needs.
  • Avoid accounts and visitor tracking.
Evidence
  • Namespaced keys
  • No-store API responses
  • Graceful degradation
05

Delivery layer

Independent branches and deployments are held together by shared validation, progressive enhancement, and release evidence.

SHIP.01

Independent delivery

The visual versions live on separate long-running branches and Cloudflare Pages projects. The main branch owns only the public router and operating documentation, keeping presentation deployments isolated from edge behavior.

Key decisions
  • Make branch-per-version part of the product idea.
  • Keep the public router independently testable and deployable.
Evidence
  • Seven version branches
  • Cloudflare Pages
  • Router Worker
SHIP.02

Quality gates

Static builds, typed checks, Worker tests, shared-file validation, reduced-motion modes, no-JavaScript content, and graphics fallbacks keep the system honest across browsers and capabilities.

Key decisions
  • Treat accessibility as architecture, not polish.
  • Test routing contracts independently from visual code.
Evidence
  • Astro check
  • Node test runner
  • Progressive enhancement

DESIGN / OPERATING PRINCIPLES

The constraints are the design... and token limits

  1. 01One identity, many interfaces.

    Presentation can change radically; professional facts should not.

  2. 02Opt in to spectacle.

    The canonical journey is clear. Experiments wait to be invited.

  3. 03Enhancement, never dependence.

    Motion, WebGL, storage, and APIs can disappear without taking the experience with them.

  4. 04Prove the boundary.

    Tests focus on the routing and service contracts where independent systems meet.

END / CHOOSE A VIEW

The design map is only one version

Step into the system, or return to the portfolio it was built to support.