Skip to content

The Field Manual is a page in the app - #170

Merged
wschenk merged 1 commit into
mainfrom
claude/walking-thoughts-org-g0qlvt
Aug 8, 2026
Merged

The Field Manual is a page in the app#170
wschenk merged 1 commit into
mainfrom
claude/walking-thoughts-org-g0qlvt

Conversation

@wschenk

@wschenk wschenk commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

Summary

The walk-to-filed loop, written down where the walker can actually reach it: /manual, in the app's own Quadrangle voice rather than as an external doc — condensed mastheads, the walker's words in the serif italic, and the Route legend coloured by the same strict roles the desk uses.

It reads start to finish: on the trail (Capture, offline, one Thread each) → on the way home (title, Kind, Project guess, report, or a question back) → at the desk (the three-step flow) → the legend → where things end up → the backlog → what still needs setup.

The legend is derived, not transcribed. The Kinds proposing each Route come from routeForKind and KIND_LABELS; the rows come from THREAD_ROUTES. Adding a Kind or a Route updates the manual on its own, so it cannot drift from the vocabulary it documents.

It states what is not live. Spec is marked Needs a token (SPEC_HANDOFF_GITHUB_TOKEN, per ADR 0018) and To-do Landing next (#160 is still open), rather than describing an aspiration as though it worked.

Reachable from the desk header beside Interview, and from the foot of the Interview page.

Test plan

  • Renders at /manual and was reviewed in a real browser at three scroll positions — masthead, the three step cards, and the full legend — inside the app's own chrome and tab bar
  • Every fact checked against merged main, not the prototype: the keys (⏎ s t n p x r j) against components/day-flow.tsx, the ~25 m spot clustering, /journal/notebook, and the spec-handoff messages
  • pnpm exec tsc --noEmit clean; eslint clean on every file this PR adds or touches (the pre-existing desk-workspace.tsx:860 error on main is untouched)

No-ticket: true

🤖 Generated with Claude Code

https://claude.ai/code/session_01Mm4zPLAX77USAqyk12jgc1


Generated by Claude Code

The walk-to-filed loop, written down where the walker can reach it:
/manual, in the app's own Quadrangle voice — condensed mastheads, the
walker's words in the serif italic, and the Route legend coloured by
the same strict roles the desk uses.

The legend is derived, not transcribed: the Kinds proposing each Route
come from routeForKind and KIND_LABELS, and the rows from
THREAD_ROUTES, so the manual cannot drift from the vocabulary it
documents. Where a destination is not live it says so plainly — Spec
needs SPEC_HANDOFF_GITHUB_TOKEN, the task list lands with #160 —
rather than describing an aspiration.

Reachable from the desk header beside Interview, and from the foot of
the Interview page.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Mm4zPLAX77USAqyk12jgc1
@vercel

vercel Bot commented Aug 8, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
walking-thoughts Ready Ready Preview Aug 8, 2026 9:23am

Request Review

@wschenk
wschenk merged commit b829463 into main Aug 8, 2026
3 checks passed
wschenk added a commit that referenced this pull request Aug 8, 2026
The To-do merge left .todo-tally unterminated, so from that line to the end of the file every rule was parsed as declarations of that block and silently discarded — .day-flow (#168) and all 39 .manual-* rules (#170) included. Nothing errored: the build passed, the pages rendered, the CSS sat right there in the file. It just never applied, and /days shipped unusable.

Restores the brace, and adds tests/globals-css.spec.ts so this cannot recur invisibly: the braces must balance, and each surface's rules (.manual-sheet, .day-flow, .todo-items, .shell) must sit at the top level rather than nested inside an earlier block or a media query. CSS is the one part of this app with no type checker, and HTTP 200s and passing suites are both blind to a dead stylesheet.

No-ticket: true
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants