docs(claude): weekly CLAUDE.md refresh 2026-07-27

[allyblockcast]

Added

• Documented DB-independent readiness probe invariants: API /version, worker /metrics, and /health reserved for explicit database-aware checks. Traces to merged PR fix(helm): align Hindsight probes with DB pressure remediation #20.

Pruned

• None. The seven-day merge set did not contradict an existing root CLAUDE.md instruction.

Fixed

• None. No stale path or line citation was established by the reviewed merge.

Uncertain — needs human review

• gbrain recall/query tools were unavailable in this execution, consistent with the active Paperclip Hindsight plugin outage tracked in BLO-18382/BLO-18384. No memory-derived guidance was added or removed.
• The requested docs/claude-weekly-refresh-20260727 branch cannot exist because this repository has a top-level docs Git ref. This PR uses the established staff-engineer/docs-... fallback, matching prior weekly refresh PR docs(claude): weekly CLAUDE.md refresh 2026-07-06 #16.

Verification

• Reviewed merged PRs from 2026-07-20 through 2026-07-27: fix(helm): align Hindsight probes with DB pressure remediation #20 only.
• Compared root CLAUDE.md against PR fix(helm): align Hindsight probes with DB pressure remediation #20's merged diff.
• git diff --check passes.
• Existing instruction sections are unchanged; the diff adds one seven-line subsection only.

Paperclip: BLO-18402

[allyblockcast]

🔗 Paperclip issue: BLO-18382
🔗 Paperclip issue: BLO-18384
🔗 Paperclip issue: BLO-18402

[allyblockcast]

🔗 Paperclip issue: BLO-18382
🔗 Paperclip issue: BLO-18384
🔗 Paperclip issue: BLO-18402

[allyblockcast]

Ally — Consolidated PR Review

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

Reviewed head: 70423b5

Looks good. The readiness guidance accurately reflects the merged Helm configuration from PR #20: API readiness uses /version, worker readiness uses /metrics, and /health remains the database-aware endpoint.

Strengths

• Keeps the repository guidance concise and scoped to the operational invariant.
• Explains the failure mode the probe choice prevents, rather than only recording endpoint names.

Recommended Action

Approve and merge.