litera-version-compare-triage

Installation
SKILL.md

Litera Contract Version Compare Triage

What this skill debugs

SpotDraft’s contract version comparison feature calls Litera Compare (hosted Compare Server + UI Compare flow). Failures often surface as:

  • 422 from Litera with a generic “corrupt or unsupported format” message
  • Browser/UI showing “This version of Litera Compare Online requires Litera Compare Server 9.5.3 or later” — this can appear even when the backend server is on a 9.24.x line; treat it as a symptom to verify server health and the real API error, not as proof of an old server version alone
  • Compare works once, then breaks after swapping which version is “original” vs “modified” (customer may retry many times)
  • UICompare path fails while non-UI Compare (e.g. RTF/DOCX output in Litera Swagger) succeeds for the same logical content
  • Django logs WordServerError: "Word server raised an error when handling request", but the same compare later succeeds in production and neither Litera nor Word Server logs show a matching failure. Treat this as a possible misattributed / low-observability transient, not proof that Word Server was the real root cause.

Earliest failure point is usually: Litera rejecting one or both inputs (often PDF-related or conversion pipeline / Kofax), not SpotDraft’s generic “compare” button.


When to use / when not to use

Use when:

Installs
1
First Seen
Apr 9, 2026