chore: session-handoff + token-hygiene (slim CLAUDE.md, add STATUS.md)

[Tools00]

Summary

• Slim CLAUDE.md from 86 → 33 lines · auto-loaded every session, was costing ~1000 tokens before any work
• New docs/STATUS.md holds the detail that used to bloat CLAUDE.md (read-on-demand)
• New docs/mockups/README.md flags v1-target-ui.html (104 KB) as no-auto-read
• New docs/decisions/006-session-handoff.html documents the handoff pattern for the user

Why

The previous CLAUDE.md update accidentally bloated the auto-load path. Token usage per session was high because: (a) CLAUDE.md grew to 4 KB, (b) the giant mockup file was a tempting re-read target, (c) decision HTMLs would be candidate for auto-search. This PR fixes all three.

Measured impact

File	Before	After	Δ tokens / session
CLAUDE.md (auto-load)	86 lines / ~1000 t	33 lines / ~355 t	−65%
STATUS.md (on-demand)	–	~625 t	only when relevant

Test plan

• pytest -q still 45/45 green (no code touched)
• ruff check src/ tests/ clean
• CI will run on push — pytest matrix + schema-drift
• Manual: open docs/decisions/000-roadmap.html after merge, confirm links work
• Next session: open in fresh Claude, verify CLAUDE.md is enough bootstrap

Out of scope

• ADR-003 license decision (still late-binding)
• Generator/UI work (paths A/B/C in STATUS.md)

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Updated development guidelines and operating procedures with structured bootstrap steps and behavioral rules.
  • Added project status tracking document with versioning, open paths, and TODO items.
  • Introduced session continuity documentation covering handoff procedures across work sessions.
  • Added guidance for efficiently accessing UI mockup resources without loading entire files.

[coderabbitai]

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Free

Run ID: d9efe239-c967-4730-b696-5929daba0e11

📥 Commits

Reviewing files that changed from the base of the PR and between a59b2da and 9f6b4d5.

📒 Files selected for processing (4)

• CLAUDE.md
• docs/STATUS.md
• docs/decisions/006-session-handoff.html
• docs/mockups/README.md

---

📝 Walkthrough

Walkthrough

Documentation overhauled with a new operating manual for Claude, project status tracker, session handoff decision guide, and asset constraint documentation. Establishes bootstrap procedures, behavioral rules, token hygiene practices, and session continuity patterns. No code changes.

Changes

Cohort / File(s)	Summary
Operating Manual CLAUDE.md	Rewritten from placeholder into structured "Manual für Claude" with bootstrap steps, behavioral rules (visual-first, citation requirements, import separation), token hygiene guidelines, and canonical source references.
Status & Decision Documentation docs/STATUS.md, docs/decisions/006-session-handoff.html	New status tracking document with version table, user-selectable paths (A–D), TODOs, and scope boundaries. New HTML decision page documenting persistence pillars, session bootstrap sequence, Git workflow assessment, and experiment branch patterns for cross-session continuity.
Asset Constraints docs/mockups/README.md	New README documenting usage constraints for mockup HTML, explicitly marking it as excluded from auto-read flows and providing guidance for targeted offset/limit access patterns.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

🐰 A manual born from thoughtful care,
With paths to guide through sessions rare—
Status glows, decisions gleam,
And mockups rest, not an eager dream.
Context preserved, a handoff blessed,
The blueprint's work, now laid to rest.

---

Note

🎁 Summarized by CodeRabbit Free

The PR author is not assigned a seat. To perform a comprehensive line-by-line review, please assign a seat to the pull request author through the subscription management page by visiting https://app.coderabbit.ai/login.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}