# REPORT — docs: CLAUDE.md refresh (stable orientation)

**Date:** 2026-07-03 · **Class:** docs-only (no code, no version bump, no deploy)
**Baseline:** `main` @ `eda33400da` (v0.98.3 live on 9201 — unchanged)

CLAUDE.md rewritten 338 → ~160 lines (diffstat: +119/−294):
- Full 30-package `controller/internal/` map (verified against the tree; old file listed 7).
- Stale bare-metal `/opt/docker` compose deploy steps for the demo node **replaced** with the
  verified 9201 bootstrap mechanism (`/etc/felhom-controller-image` +
  `felhom-controller-bootstrap.service` — confirmed live: enabled, running 0.98.3). felhotest noted
  as the legacy compose mechanism.
- Embedded hub build/deploy section deleted (owned by felhom.eu); build/deploy compressed to a
  4-row summary table + `felhom-build-deploy` skill pointer.
- "Key patterns" (~20 bullets) pruned to 6 session-critical invariants; the rest live in REUSE.md.
  "Lessons learned" absorbed likewise. No version-pinned state remains (standing rule).

Verified-live commands recorded: build (with the load-bearing explicit `git pull`), 9201 deploy
chain, verify. Consolidated cross-repo report: `felhom.eu/REPORT.md`.