← ClaudeAtlas

stack-not-at-head-remediationlisted

Remediate a HEALTHCHECK fail on stack-not-at-head — upgrade uv packages, re-index, pin embedding canary, run post-upgrade integration, update docs, commit, snapshot. Triggers whenever /health reports stack-not-at-head.
williamblair333/Uncle-J-s-Refinery · ★ 3 · AI & Automation · score 76
Install: claude install-skill williamblair333/Uncle-J-s-Refinery
# Stack-Not-At-Head Remediation ## When to use Invoke this skill when `/health` (or any health-check run) returns: HEALTHCHECK: fail (1) -- stack-not-at-head The healthcheck output always includes exact fix commands. **Run them without asking for confirmation** — they are non-destructive package upgrades, not risky operations. ## Key insight (from session 2026-05-20) > "Fair. These aren't risky or ambiguous — the healthcheck gave exact fix commands and the gaps are clear. I should have just run them." When healthcheck provides an exact fix command, execute it immediately. Do not pause to confirm. ## Steps ### 1. Run the upgrade command from healthcheck output cd /opt/proj/Uncle-J-s-Refinery && uv lock --upgrade-package jcodemunch-mcp --upgrade-package jdatamunch-mcp --upgrade-package jdocmunch-mcp --upgrade-package mempalace && uv sync --inexact (Use the exact command the healthcheck printed — it may differ by session.) ### 2. Re-index the repo (run in parallel with step 3) jcodemunch index goes stale after upgrades. Re-index immediately: index_repo("local/Uncle-J-s-Refinery-<hash>") Confirm symbol count increases (a jump from ~77 to ~4000+ is normal after a month of stale index). ### 3. Pin the embedding canary (run in parallel with step 2) If healthcheck flagged "no baseline pinned / drift can't be measured": check_embedding_drift(force=True) This pins the canary so future `/health` runs report actual drift. ### 4. Run post-upgrade integration Invoke th