plan(dqn): SP1 numerical stability — F1 NaN root-cause investigation

Browse Source

Implementation plan for SP1 (Sub-project 1 of 3) of the numerical
stability investigation. Follows the γ + β methodology from the spec
at docs/superpowers/specs/2026-04-29-numerical-stability-investigation-design.md.

8 tasks across 4 phases:
- Phase A (Task 1): γ read-only audit producing docs/dqn-backward-nan-audit.md
- Phase B (Tasks 2-5): always-landing β instrumentation expanding
  nan_flags_buf 24→48 with 12 new backward-kernel NaN check slots
  + 12 reserved slots for future coverage
- Phase C (Task 6): surgical fix(es), content-driven by audit + smoke
  topology, ISV-driven for any dynamic bound (mandatory)
- Phase D (Task 7): multi-fold L40S smoke validation against 7 pass
  criteria (F0 ≥ 95% baseline, F1+F2 monotone improvement, zero
  NaN-CLAMPED-TO-ZERO, all 48 NaN flag slots remain at zero)
- Closure (Task 8): audit doc closure, memory entry, SP2/SP3 handoff

Operating principles (mandatory per spec):
- No deferrals — anomalies discovered during investigation get fixed
  within SP1, not punted to SP2/SP3
- Combined RELATED fixes ship as rich commits (per
  feedback_no_partial_refactor)
- ISV-driven design for any dynamic bound

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

...

This commit is contained in:

jgrusewski

2026-04-29 23:21:26 +02:00

parent 792812baa1

commit 05958d3a0c

1 changed files with 1336 additions and 0 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

1336

docs/superpowers/plans/2026-04-29-numerical-stability-sp1-f1-nan-root-cause.md Normal file

File diff suppressed because it is too large Load Diff