approval-watermark-template-execution-mismatch

Installation
SKILL.md

Approval Watermark Missing on Executed Template Contracts

What This Skill Debugs

This runbook covers the specific mismatch where approval / ready-to-sign watermarking behaves differently by workflow:

  • TPP / upload-sign / editable flows keep the watermark after execution
  • Template / template-editable flows show the watermark at signing time, but the executed platform copy loses it

This is not usually a random rendering issue. The important split is in how the executed PDF is produced:

  • Editable / TPP path signs the already-generated PRE_SIGN_PDF, so the watermark survives into the final copy
  • Template path historically regenerated the executed PDF from scratch and, before the Mar 2026 fix, did not re-apply the watermark before generating the executed copy

Confirmed fix pattern from incident #incident-20260311-medium-doceree-inconsistent-watermark-behavior-between-templat / Jira SPD-42223:

  • move watermark application into get_pre_sign_pdf_for_template_contract()
  • let save_executed_pdf_for_template_contract() consume that already-watermarked PDF
  • regression-test Native signing, DocuSign, HelloSign, and Aadhaar/native-sign variants before prod rollout
Installs
1
First Seen
Apr 9, 2026