Word Cross-Reference & Numbering Field Triage

What this skill debugs

Issues where numbered clauses, section references, or Word field-based cross-references appear incorrect in the contract editor (OnlyOffice) or in generated outputs, even when Legal believes the template DOCX is correct.

Incident pattern (evidence-backed): Numbers are wrong when the contract is first opened, but become correct after the user edits, selects all text, and presses F9 (Word / OnlyOffice Update Fields). That strongly suggests fields not refreshed in the client view rather than bad data permanently stored — confirm against downloaded DOCX / PDF and backend artifacts.

Related but different: DOCX → PDF (e.g. for signing) can change how references resolve because conversion often forces Word to update fields, reflow layout, and refresh cross-references — numbers may differ between in-editor DOCX and exported PDF without a single “buggy” number being stored.

When to use / when not to use

Use when:

• Customer reports reference numbers or clause numbering “wrong” in SpotDraft
• Support reproduces fix after F9 or full-document Update Fields
• Discussion touches template workflow_id, Legal-updated numbering, PDF vs DOCX for send/sign