docx

DOCX

Create the requested Word document in /workspace with the preinstalled python-docx package. Never install or download dependencies.

Authoring rules

• Use one page size and orientation for the document unless the user asks for a different layout. Prefer portrait; narrow wide content instead of silently switching sections to landscape.
• Choose the page size the user requests, or the locale-appropriate default when they do not specify one.
• Set margins of at least 18 mm and use built-in heading levels.
• Set table and cell widths deliberately and use a visible table grid.
• Use Word numbering/list styles; never insert literal • characters.
• Put page breaks in their own paragraphs. Use separate paragraphs instead of newline characters for separate blocks.
• Do not add a table of contents unless the user asks. If requested, use built-in heading levels and state that page numbers populate when Word opens and updates the field.
• For right-aligned text on the same line, use a right tab stop.
• Generate the document as one whole document. Do not assemble or save one DOCX per intended page; Word controls pagination through reflow.

Revisions

Start an in-place revision with load_artifact_for_revision. Use python-docx to open primary_path, make common edits directly to the existing document, and write the result to expected_output_path. Common edits include paragraph text and styles, headings, ordinary tables, lists, headers/footers, section settings, and embedded images that python-docx can safely preserve.

If the requested edit touches a structure python-docx cannot safely interpret or preserve—such as macros, SmartArt, complex fields, tracked changes, content controls, or unsupported drawing/layout XML—stop and report the blocker. Do not silently rebuild from markdown_path and do not fall back to a Markdown-only deliverable. Rebuild the DOCX from Markdown/context only when the user explicitly requested or accepted that lossy rebuild.