# Work OS V2 - Handoff

Date: August 10, 2026

## Start here

1. Open `prototype/index.html`.
2. Read `docs/07-work-os-v2-implementation-handoff.md`.
3. Read `docs/10-work-os-v2-design-guide.md`.
4. Use `docs/13-work-os-v2-completion-audit.md` to distinguish proven
   prototype behavior from production work that remains.

## Product definition

Work OS is one operating room for consequential work:

`consequence -> proof -> your word -> machine work -> outcome -> receipt`

It is not an AI chat home, dashboard suite, page hierarchy, or a second
orchestration system.

The fixed furniture is:

- the command line;
- Watch;
- the causal field;
- one selected causal line;
- the append-only tape;
- one contextual drawer;
- the mobile machine strip.

## Selected direction

Switchboard structure with Causal Loom focus behavior.

Switchboard supplies stable coordinates and dense parallel scanning. Causal
Loom keeps the complete story of one selected object visible without moving the
rest of the room.

## Production target

Bind this interaction design to the existing `/operator` React tree and the
canonical Work OS contracts. Do not create parallel run, memory, or receipt
models.

Build in this order:

1. Word - durable words, judgments, correction, and receipts.
2. Work - editable efforts, approval, factual progress, stop, replay, rejection.
3. Memory - Dig, sourced deltas, promises, learned arithmetic, corrections.
4. Custody - draft review and placement, provider receipts, close, reopen.
5. Daily driver - real data, keyboard, responsive behavior, observability,
   rollout, and rollback.

## Non-negotiable safety rules

- Fail closed on missing, stale, denied, or conflicting evidence.
- Keep Nathan's words separate from machine interpretation.
- Append corrections and undo; never erase history.
- Show factual stages and units, never invented percentages.
- Prepared is not sent.
- A Gmail draft is not a sent email.
- Mail sending is never automated.
- Every claimed action reaches a trace or receipt.
- Model-composed suggestions never execute themselves.
- Do not add pages, tabs, assistant panes, or permanent navigation.

## Verification

The self-contained prototype currently passes:

- 36 end-to-end browser checkpoints;
- 153 control and safety checks;
- 28 isolated scenarios;
- all 44 declared actions;
- 390, 768, 1200, and 1440px checks;
- both themes and reduced motion;
- keyboard and focus-return paths;
- zero external requests;
- zero browser console errors.

The prototype proves interaction design and local behavior. It does not prove
authenticated persistence, live source freshness, provider effects, production
orchestration, or deployment readiness.
