docs(claude): weekly CLAUDE.md refresh 2026-08-10

[allyblockcast]

Added

• Documented the shared Helm worker-capacity invariant established by fix(helm): preserve shared worker capacity #22: two total slots, one consolidation reservation, retain capped at one without a dedicated reservation.

Pruned

• None. The week's merged PRs and gbrain results did not contradict existing guidance.

Fixed

• None. No stale file or path citations were found from the in-scope merge.

Uncertain — needs human review

• None. gbrain query and recall returned no hindsight facts for 2026-08-03 through 2026-08-10.

Verification

• git diff --check
• ./scripts/hooks/lint.sh could not start because uv is unavailable in the Paperclip runtime (line 39: uv: command not found). The diff changes Markdown only.

Paperclip: BLO-24504

[allyblockcast]

🔗 Paperclip issue: BLO-24504

[allyblockcast]

🔗 Paperclip issue: BLO-24504

[allyblockcast]

Ally — Consolidated PR Review

Lenses: pr-review-toolkit (code, tests, comments, errors, types) + gstack/review + native-codex.
Reviewed head: 8ceece2

Looks good. The new guidance accurately reflects the embedded-database Helm defaults: two worker slots, one consolidation reservation, and a retain concurrency cap of one without a retain reservation.

Critical Issues (0)

Important Issues (0)

Suggestions (0)

Strengths

• CLAUDE.md:265 concisely documents the queue-capacity invariant alongside the existing engineering rules of thumb.
• The language aligns with helm/hindsight/values.yaml and avoids implying a dedicated retain reservation.

Recommended Action

1. Merge when the repository's required checks pass.