CLAUDE.md: dedupe workspace-restated rules, link orphaned agent doc

[millsmillsymills]

Source

The new rules of context engineering for Claude 5 generation models — the guidance on keeping CLAUDE.md lightweight and gotcha-focused, and on consolidating instructions into a single source.

What to build

Small trim — this file is the workspace's best progressive-disclosure example already. Four changes:

• Drop the standards/audit stanza (duplicates workspace-level guidance that local agents already load) — replace with a one-line note. This also stops publishing the ~/Desktop/Projects/... absolute path, which names a checkout that isn't part of this repo.
• The stdout/stderr logging rule restates the workspace file; keep only the repo-specific parts (the _logging.py pointer and the idempotentHint=False rule for state-cycling tools).
• docs/agents/golden-fixtures.md exists but is not referenced from the Agent skills section — add it, or delete the file if it's dead.
• The protobuf pin note is stale: CLAUDE.md says protobuf==6.33.5 / "keep the pin's major.minor at 6.33", but pyproject.toml now pins protobuf==7.35.1 (Dependabot bumped it past the stated invariant). Reconcile the note with the actual pin and confirm the vendored bindings are still valid against 7.x, or regenerate them.

Keep intact: harvest provenance/MIT attribution, hardware-required integration-test notes, and the dual-firmware golden-fixture scheme.

Acceptance criteria

• Standards stanza removed (one-line workspace-conventions note is enough); no local absolute paths remain
• Generic stderr rule deduplicated; repo-specific logging/idempotency notes retained
• golden-fixtures.md either linked from the Agent skills section or removed
• Protobuf pin note reconciled with the actual pyproject.toml pin; vendored bindings confirmed valid or regenerated
• Provenance and hardware-test notes retained

Blocked by

None - can start immediately