docs(skills): Close epic #125 — 2 portable skills + PHASE_STATUS row 4 staleness

[dackclup]

Closes #133. Docs/skills-only PR. Final cleanup work to close out epic #125.

Task A — Portable skills library final 2 (closes #133)

Extracts the last 2 deferred-but-tracked patterns from the audit in PR #132:

portable-annotate-before-veto (132 LOC)

Progressive-rollout pattern for defense / risk flags. Ship as annotate (informational metadata, no rank change) FIRST. Promote to veto (rank suppressor) only after ≥ 1 production cron of observation + threshold calibration + cohort-acceptance check.

Forcing precedent: Phase 4.5 cluster (PRs #89/#90/#91 + #93 + #95 + #97 + #100) shipped 9 new flags — 2 promoted vetoes (Beneish + Dechow, both with researched cohort thresholds), 7 annotate-only. loss_avoidance_pattern (4.5d) at 0% S&P 500 fire rate would have been a no-op or hotfix candidate as a veto; annotate made it observable.

portable-graceful-degradation-try-except (141 LOC)

Wrap every external-data integration call site in a try / except that sets ALL related output fields to None on failure + writes a structured log line + sets a per-integration Metadata.<source>_status field.

3-rule contract:

1. No partial state — every downstream field gets None
2. No log swallowing — exception logged with exc_info AND surfaced in metadata
3. Downstream-aware — every consumer checks for None explicitly

Forcing precedent: OSAP integration in compute/main.py (PRs #112 → #118 → #124). Every OSAP-derived field defaults to None on failure; UI + composite both check explicitly.

Convention

Both skills follow the established portable-* convention from PR #132 (YAML frontmatter + Pattern + Trigger + Skip + QuantRank precedent section). Each Pattern section is project-agnostic; QuantRank refs confined to labeled "QuantRank precedent" sections at the bottom.

Task B — PHASE_STATUS.md row 4 staleness fix

Row 4 said "Phase 4h.2 Part 2 in flight in this PR" since PR #124's prep work. PR #124 merged 2026-05-19. Updated to "Phase 4h.2 Part 2 merged via PR #124 (2026-05-19)" — the rest of the row's text (multi-port OSAP adapter description, IC-decay deferral note) stays unchanged.

This was flagged in PR #132 body and tracked as a small follow-up.

Task C — Docs lockstep

• CLAUDE.md row 33 skill count: 35 → 37. QR-origin portable category 4 → 6. Categorisation otherwise unchanged; 9arm license-pending caveat still flagged with cross-reference to issue Vendor thananon/9arm-skills — blocked on upstream LICENSE #137.

Files (4 changed, +275 LOC)

File	Change
.claude/skills/portable-annotate-before-veto/SKILL.md	NEW (+132)
.claude/skills/portable-graceful-degradation-try-except/SKILL.md	NEW (+141)
CLAUDE.md	row 33 skill count update
PHASE_STATUS.md	row 4 staleness fix

Skill inventory after this PR (37 total)

Category	Count	Delta
QuantRank operational	12	unchanged
QR-origin portable extract	6	+2 (annotate-before-veto, graceful-degradation-try-except)
Anthropic vendored	6	unchanged
External MIT vendored	9 (Karpathy + 8 mattpocock)	unchanged
External license-pending	4 (9arm)	unchanged

Verification ladder

• ✅ ruff check . → All checks passed
• ✅ python -m compute.output.schema_check → Schema snapshot in sync
• ✅ python tools/check_doc_test_counts.py → exit 0
• ⏸ pytest tests/ -m "not network" → not run locally (sandbox missing pandas); CI will verify. Changes are docs/skills-only — zero Python source touched.
• ✅ Skill registry pickup verified via session reload — both new skills register with full YAML-frontmatter descriptions.

Constraints honored

• ✅ No touch to compute/ / frontend/ / tests/
• ✅ No touch to WORKFLOW.md (out of scope; could file a future follow-up if WORKFLOW.md needs to cross-reference the 2 new portable skills, but the existing ## Conventions section in CLAUDE.md already names the Annotate-and-veto-Top-N rule)
• ✅ No squash / amend of prior commits
• ✅ No push to main; no force-push; no --no-verify
• ✅ No workflow_dispatch trigger
• ✅ Both portable skills' Pattern sections are project-agnostic; QR refs only in labeled "precedent" sections

Epic #125 status after this PR

• ✅ Portable Skills Library — extract remaining tacit patterns #133 (Portable Skills Library) — closed by this PR
• ✅ PHASE_STATUS.md row 4 staleness — fixed by this PR
• 🔁 Process hygiene #5 — Quarterly cohort-threshold fire-rate review (recurring tracker) #130 (quarterly cohort-threshold review) — recurring tracker, unchanged
• 🔁 Vendor thananon/9arm-skills — blocked on upstream LICENSE #137 (9arm-skills license clarification) — external action, waiting on user to file upstream issue at thananon/9arm-skills
• 🟡 Epic Process hygiene epic — close the gap between CI-green and provably-correct (6 improvements) #125 Item 3 (Pre-merge production simulation) — only substantive open scope remaining

Epic #125 is effectively closed except for Item 3 (Pre-merge production simulation) — that's a 2-PR substantive scope and can be opened as a separate epic when picked up.

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
quantrank	Ready	Preview, Comment	May 20, 2026 4:48am