What problem does it solve? Custom model implementations in NeMo AutoModel (combined projections, backend switching, kernel patches) can silently diverge from HuggingFace reference behavior, causing loss divergence or output mismatches that are hard to localize. ## Core Features & Use Cases - Three-Level Test Strategy: State dict round-trip checks on CPU/float32, isolated component parity tests, and end-to-end forward-pass validation on GPU/bfloat16. - Systematic Debugging Workflow: Step-by-step isolation procedure covering weight loading, backend forcing (SDPA/torch linear), component injection, and gradient parity checks. - Pitfall Catalog: Documents 12 known divergence sources including QKV interleaving, RoPE precision, tied weights, MoE routing non-determinism, and kernel patch interference. - Use Case: After adding a new model to NeMo AutoModel, run the three-level parity suite against its HuggingFace counterpart to confirm exact weight round-trips and logits within tolerance before merging. ## Quick Start Verify that my new NeMo AutoModel implementation of Llama-3.2-1B produces numerically identical outputs to the HuggingFace reference model.