Book companion · executable workshop project

Try it first. Then build it yourself.

Mara writes. Lea responds. Switch perspectives and experience what a platform connects. Then keep building with your AI agent.

The demo needs no account or installation. The starter takes you into the local project; real authentication, a database and cloud deployment follow in the German-language book.

One proposal. Three perspectives.

Start a draft as Mara. Then switch to Lea – before submitting it.

MARA ·

Mara has an idea. For now, it belongs to her alone.

One click creates a draft, not a submission.

What if the reading rule vanished?

Only in this simulation: let an outsider see the text and observe the difference. The download remains unchanged.

Start a draft, switch to Tobias and suspend the reading rule here.

Technical view

This demo illustrates a browser-side rule. Real permissions must be enforced on the server and, where appropriate, in the database. In chapter 12, you remove a condition in a local test project and see the matching test fail.

Browser simulation · fictional data · no sign-in. Nothing is saved or sent.

Chapters 2 + 11 · the complete core flow

Watch one real browser walkthrough.

Five captures from the local workbench. No animation or recreated terminal: move at your own pace. The workshop UI is in German.

Local workbench: Mara with a private draft and submit action

View 1 / 5

Mara starts. Nobody else reads along.

Select Mara, then start a draft. There is text, but no message to Lea yet. Writing and submitting are different actions.

Open full-size capture ↗
About the capture

Captured on 7 September 2026 in the in-app browser at 1280 × 960 pixels. Synthetic accounts and server-side in-memory state; no real sign-in or persistent database. This is an image sequence, not a video recording.

Replay it in your own starter →

Chapter 2 · one bounded UI iteration

A good instruction leaves a visible difference.

Real browser captures from Vorhabenraum. The initial fault is deliberately introduced, not claimed as a particular agent’s mistake.

01 · Before

The action comes before the project. Mara is asked to decide before understanding the context.

Initial fault: action before context at 390 pixels

02 · Your intervention

Keep the copy, colours and desktop layout. At 390 pixels, Mara should understand the project before reaching the main action. Prevent horizontal overflow.

Build it with AI →

03 · After

Context precedes action. The long title stays readable. Check the wide layout as well.

Corrected mobile order with readable heading

The agent delivered. Did it meet your goal?

Three example corrections for your next iteration. These are not conversation transcripts.

Looks good. Wrong problem.

New colours, new cards, same obstacle.

In the German book: chapter 3 + 8
Steer it back
A redesign was not requested. Keep the existing design. Fix only mobile order and title wrapping; show the same content before and after.

Green is not a product decision.

A test fails. The agent wants to change the expectation.

In the German book: chapter 12
Steer it back
The privacy rule stays. Reproduce the failure and fix the implementation. The test must fail on foreign access before the fix and reject that same access afterwards.

The page works. The sentence misleads.

The interface addresses the wrong person.

In the German book: chapter 14
Steer it back
Read the text from the perspective of the person who owns the record. Correct only the viewpoint. Keep layout, roles and approval rules intact.

The first win

Now the workbench is yours.

Download the fixed starting point and run it locally. Your coding agent can now read and change the actual project files.

  1. 01

    Unpack the project

    Open the vorhabenraum directory in a terminal. Keep the unchanged ZIP as your recovery point.

  2. 02

    Run it locally

    Install dependencies and start the development server.

  3. 03

    Exercise the user journey

    Open the workbench and run through drafting, submission, decision, and blocked third-party access.

  4. 04

    Request the first change

    Give your agent docs/quickstart-agent-task.md. Compare mobile and desktop, then have it run lint and build. Keep the seven product-rule tests for subsequent changes.

Commands for your terminalvorhabenraum
npm install
npm run dev

npm test
npm run lint
npm run build
Then openhttp://localhost:3000/workbench

The through-line

Four workshop stages, one growing platform

The first three states are included in the download. The pilot deliberately lives in your own isolated development environment.

  1. Starting state

    in the package

    The published project view runs locally and the agent first describes only the visible user journey.

    Evidence: The page loads, project rules have been read, and no file has been changed yet.

    Chapter 2/
  2. First agent loop

    in the package

    A reproducible mobile obstacle is created with npm run workshop:start, fixed within scope, and restored with npm run workshop:refined.

    Evidence: Before/after screenshots, diff, lint, and production build.

    Chapter 2–4/
  3. Two-role slice

    in the package

    Drafting, submission, decision, and blocked third-party access can be exercised with three synthetic accounts.

    Evidence: Seven product-rule tests and a visible event log.

    Chapter 9–12/workbench
  4. Isolated pilot

    your environment

    Authentication, persistent data, preview, observability, and release are added in the reader's own development project.

    Evidence: A private preview URL, role counter-checks, deployment evidence, and a repair trail.

    Chapter 13–16

Tool selection

Who takes the next task?

This matrix is a dated division of labour, not a permanent model ranking. One agent is enough; a second perspective makes a counter-check more independent.

Codex

last reviewed 2026-09-05

Read the repository, plan changes, implement one vertical slice, and run a fresh counter-review.

Plan, bounded diff, tests, and build

Core path

Boundary: External effects such as deployment, migrations, or messages still require explicit approval.

Claude Code

last reviewed 2026-09-05

Refine interfaces visually and atomically, especially with a screenshot and the included frontend-design skill.

The same state at 390 and 1440 pixels, keyboard path, and diff

Core path

Boundary: Design tokens, product rules, and permissions are constraints, not raw design material.

Browser & DevTools

last reviewed 2026-09-05

Inspect the actual user journey, responsive states, console, network, and overflow.

Browser journey, screenshots, and a clean console

Core path

Boundary: A polished screenshot replaces neither permission checks nor product-rule tests.

Git

last reviewed 2026-09-05

Secure a known starting point, understand changes, and discard failed iterations without losing work.

Clean status, readable diff, and a named workshop state

Core path

Boundary: Never silently overwrite someone else's or uncommitted work.

Supabase

last reviewed 2026-09-05

Add authentication, PostgreSQL, migrations, and row-level security in a private pilot project.

Migrations plus positive and negative role checks

Extension

Boundary: Use isolated development data only; never paste production accounts or keys into agent tasks.

Vercel

last reviewed 2026-09-05

Provide a private preview for the bounded pilot and expose build failures.

Preview URL, build log, and tested recovery path

Extension

Boundary: A preview is not a production release. Environment variables remain separated.

Stripe Sandbox

last reviewed 2026-09-05

Exercise the optional paid-access path with test products, webhooks, and explicit states.

Signed test webhook, idempotency check, and visible access status

Extension

Boundary: No live keys and no real charge during the book exercise.

Sentry

last reviewed 2026-09-05

Observe and reproduce pilot failures, then connect them to an approved repair.

Reproducible event, linked fix, and controlled release

Extension

Boundary: Use a data-minimised development environment and filter sensitive payloads before transmission.

Only one coding agent available?

Stay with the same tool and start the counter-review in a fresh context. The independent question matters more than a second logo.

Two agents available?

Use the proven division of labour: Claude Code for atomic visual iteration, Codex for structured repository work and counter-checks. The observable result still decides.

Traceable

A release, not a moving example

The book, download, and workshop state name the same version. The checksum reveals whether the archive arrived unchanged, while the included START-HERE file keeps the path usable without this website.

Fixed starting point · 0.3.1
Included
Workshop stages 01–03
Data
fully synthetic
SHA-256
7ac7e9a4c876840c4c63d3bf268d499d3a0355f5303e009b28134951c4eaa17c

Starter: version 0.3.1, 8 September 2026, with expanded setup guidance and isolated fault exercises. The tool matrix has its own review dates.