docx-contracts

Workflow

1. Extract schema: Run

   scripts/extract_schema.py <template.docx>

   to get variables list and JSON schema. Don't read file. Just launch script.
2. Gather data: Extract values from user message context, matching schema fields. Use Claude completion for extraction if needed
3. Handle missing data: If any required field is missing or uncertain, ask user directly. Do not guess
4. Fill template: Create JSON file with data, then run

   scripts/fill_template.py <template.docx> <data.json> <output.docx>

5. Deliver: Move result to

   /mnt/user-data/outputs/

   and provide download link. Please don't read output file.

Key Points

• Template must use Jinja2 syntax:

  {{VARIABLE_NAME}}

• All required fields from schema must be filled
• Ask user for missing data - never invent values
• Install docxtpl if needed:

  pip install docxtpl --break-system-packages