Skip to content

docs: CLAUDE.md §Phase status drain (#311–#326) + A-L label fix + 2 PR #326 §Gotchas#327

Merged
dackclup merged 2 commits into
mainfrom
claude/docs-housekeep-phase-status
May 30, 2026
Merged

docs: CLAUDE.md §Phase status drain (#311–#326) + A-L label fix + 2 PR #326 §Gotchas#327
dackclup merged 2 commits into
mainfrom
claude/docs-housekeep-phase-status

Conversation

@dackclup
Copy link
Copy Markdown
Owner

Full docs-reviewer substance pass on CLAUDE.md surfaced 5 MUST-FIX + 4 SHOULD-FIX — all fixed here in one focused diff. CLAUDE.md only (+ a PHASE_STATUS_INFLIGHT.md lockstep entry); no code / schema / compute / frontend change.

MUST-FIX (factual errors / contradictions that would mislead a future agent)

  1. §Phase status "In flight" marked PR feat(frontend): app-wide tasteful motion — gauge sweep · row stagger · veto pulse #312 (tasteful-motion) as "THIS PR / not yet merged" — it merged as e602485. → "No current in-flight PR on this branch" + pointer to the side-file.
  2. §Phase status "Recently merged" was frozen at PR fix(scoring): inject stale_filing_hard before Top-5 rotation (latent Rule-16 fix) — closes #309 #310 (16 PRs stale). → header refreshed to PR #303 → PR #326 + the 16 missing entries (docs: reconcile cross-doc drift after the 6-PR session (#303–#310) #311fix(frontend): sidebar refresh/rotate flash + chart crosshair re-park on sidebar toggle; 2 flaky-test guards #326) inserted newest-first with SHAs.
  3. §Phase status "Next deliverables" listed "Issue Phase 5+: Damodaran sector-adjusted cost_of_equity (deferred from Phase 4c) #67 flip PR" as pending — USE_SECTOR_COE = True already flipped via PR feat(valuation): Issue #67 — flip USE_SECTOR_COE True (Damodaran 11-sector Ke) #294 (config.py confirms). → "Issue Phase 5+: Damodaran sector-adjusted cost_of_equity (deferred from Phase 4c) #67 — DONE (PR feat(valuation): Issue #67 — flip USE_SECTOR_COE True (Damodaran 11-sector Ke) #294)".
  4. §Commands + §workflow_dispatch said "Section A-H" — the verify-production-output helper is Section A-L (PR feat(verify+auditor): OSAP factor-exposure proxy contract codification (closes #217 + #218) #221 extended A-J → A-L). → both labels fixed.
  5. §Cue table defense-layer-auditor row said "Section A-J" → A-L. (The edgar-debugger historical narrative keeps its self-contained A=…/…/J=annotate inventory legend — a point-in-time 4.5-era record, preserved per the doc's historical-narrative convention.)

SHOULD-FIX (staleness)

  1. §Stack "Phase 3b on this PR" → "(merged)" (no dangling "this PR" referent).
  2. §Gotchas compute/main.py line refs re-anchored to the current file: 840→879 · 1965-1966→2084-2085 · 717→728 · 785→805 · 972→1025.
  3. §Gotchas +2 entries for the PR fix(frontend): sidebar refresh/rotate flash + chart crosshair re-park on sidebar toggle; 2 flaky-test guards #326 invariants (previously only in PHASE_STATUS_INFLIGHT.md): (a) Sidebar data-rail attrs ↔ globals.css html.sidebar-collapsed [data-rail=…] pre-paint rules move in lockstep (drift → refresh text-flash returns); (b) the price-chart crosshair re-park MUST debounce the <AreaChart> remount ≥ ~300ms so it lands after ResponsiveContainer re-measures (immediate remount → crosshair parks at index 0 / far-left).
  4. §Stack edgartools 5.315.32 (installed version).

Confirmed NO drift (no change needed)

schema 0.10.11-phase4.6 (config.py) · skills 46 · agents 19 · hooks 3 · defense-layer 33 declared — all §Layout counts already accurate. No broken cross-links.

Verification

Markdown-only — no ruff / pytest / build surface. Edits verified via sentinel grep: all 6 old strings → 0 occurrences, all 5 new strings → 1. Only 2 files changed (CLAUDE.md 49+/17−, PHASE_STATUS_INFLIGHT.md 89+/0− append). docs-reviewer re-check spawned at this gate. Lockstep satisfied via the PHASE_STATUS_INFLIGHT.md side-file (PR #237 convention); AGENTS.md mirror of the 2 frontend gotchas deferred (they live in CLAUDE.md §Gotchas, the canonical home; AGENTS.md carries no §Gotchas mirror today).

https://claude.ai/code/session_0144kHrCYNaamMPH57b7xdM7


Generated by Claude Code

…#326 §Gotchas

Full docs-reviewer substance pass on CLAUDE.md → 5 MUST-FIX + 4 SHOULD-FIX,
all fixed in one focused diff. CLAUDE.md only (+ INFLIGHT lockstep entry); no
code / schema / compute / frontend change.

MUST-FIX:
- §Phase status "In flight" marked PR #312 (tasteful-motion) as "THIS PR";
  it merged as e602485 → "No current in-flight PR".
- §Phase status "Recently merged" was frozen at PR #310 (16 PRs stale) →
  refreshed to #303#326 with the 16 missing entries (#311#326).
- §Phase status "Next deliverables" listed Issue #67 flip as pending →
  DONE via PR #294 (USE_SECTOR_COE = True).
- §Commands + §workflow_dispatch "Section A-H" → "Section A-L" (helper is
  A-L since PR #221).
- §Cue table defense-layer-auditor "Section A-J" → "A-L". (Historical
  edgar-debugger narrative keeps its A..J legend — point-in-time record.)

SHOULD-FIX:
- §Stack "Phase 3b on this PR" → "(merged)"; edgartools 5.31 → 5.32.
- §Gotchas compute/main.py line refs re-anchored (840→879 · 1965-66→2084-85
  · 717→728 · 785→805 · 972→1025).
- §Gotchas +2 entries for PR #326 invariants (sidebar data-rail↔globals.css
  pre-paint lockstep; AreaChart re-park debounce ≥300ms).

Confirmed no drift: schema 0.10.11-phase4.6 · skills 46 · agents 19 · hooks 3.
Edits verified via sentinel grep (6 old → 0, 5 new → 1). Lockstep via
PHASE_STATUS_INFLIGHT.md side-file (PR #237 convention).

https://claude.ai/code/session_0144kHrCYNaamMPH57b7xdM7
@vercel
Copy link
Copy Markdown

vercel Bot commented May 30, 2026

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

Project Deployment Actions Updated (UTC)
quantrank Ready Ready Preview, Comment May 30, 2026 10:43am

…iewer SHOULD-FIX)

The Recently-merged PR #316 entry substituted '(skill count 45 → 46)' for the
commit's own '(original-prose, inspire-only)'. Both are true; keep both for
commit-log fidelity per the docs-reviewer re-check note.

https://claude.ai/code/session_0144kHrCYNaamMPH57b7xdM7
@dackclup dackclup marked this pull request as ready for review May 30, 2026 11:18
@dackclup dackclup merged commit 0303e9f into main May 30, 2026
4 checks passed
@dackclup dackclup deleted the claude/docs-housekeep-phase-status branch May 30, 2026 11:19
dackclup added a commit that referenced this pull request May 31, 2026
…t + sign-aware MoS) (#333)

PR #332 (stock-detail hero rework) merged as a fast spot-check-driven UI
iteration and skipped the CLAUDE.md/AGENTS.md substance lockstep. Add the two
invariants future editors must not regress:

1. The hero's two-column (name-left / stats-top-right) vs stacked decision is
   driven by a CSS CONTAINER QUERY on the hero's own inline-size, NOT a viewport
   md:/lg: breakpoint — because the sidebar eats a viewport-variable width slice
   (the dead-band bug that prompted the rework). JSX default is the stacked
   flex-col; @container only adds the row; raw CSS, no plugin/dep.
2. The MoS gauge arc is sign-aware: >=0 clockwise (like the score gauge), <0
   counter-clockwise via -scale-x-100 on the container with the number span
   mirrored back. 329/502 of the universe is negative, so CCW is the common case.

CLAUDE.md §Gotchas holds the full rationale; AGENTS.md §Code style mirrors each
as a pointer (PR #327 precedent). PHASE_STATUS_INFLIGHT.md entry per the
ship-with-every-PR convention. Doc-only — the hero code already shipped in #332.

https://claude.ai/code/session_0148EoMmL6zakDWqHXjqQ9yq

Co-authored-by: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants