Skip to content

feat: render_format docx — native, versioned Word CV + cover letter (v0.4.0)#5

Merged
mabry1985 merged 1 commit into
mainfrom
feat/docx-render-format
Jul 22, 2026
Merged

feat: render_format docx — native, versioned Word CV + cover letter (v0.4.0)#5
mabry1985 merged 1 commit into
mainfrom
feat/docx-render-format

Conversation

@mabry1985

Copy link
Copy Markdown
Member

protoAgent v0.107.0 shipped ADR 0092 — the desktop build now bundles the doc stack (#2123) and the artifact plugin gained save_file_artifact (#2126, versioned file/download artifacts). That unblocks a real .docx path for Career Coach — what most ATS forms and recruiters actually want, and the thing this thread parked as "deferred to core."

What this adds

A third render_format: docx. When set, the CV / cover letter is produced as an editable Word file via cowork's docx skill (python-docx through execute_code), then registered with save_file_artifact(path, title=…) so it lands in the Artifact panel as a versioned, downloadable file with a text preview (docx→text). Re-saves become v2/v3 via artifact_id.

Soft pairing, graceful: needs the cowork plugin + execute_code + a protoAgent v0.107.0+ host (which bundles the doc stack). If any is missing, it falls back to html→PDF and says so — never silently skips. No hard dependency, and no min_protoagent_version bump (the whole plugin still runs on 0.34.0 without docx).

Changes

  • manifestrender_format config + Settings description gain docx; version 0.3.2 → 0.4.0.
  • cv-guide.md / cover-letter-guide.md — the docx rendering path (build → save → save_file_artifact), with requirements + fallback.
  • job-application-assistant/SKILL.md (step 2) + role-packet/SKILL.md (phase 3) — render mentions include docx.
  • README — design-decision note on native docx.

Testing

14 passed, ruff clean. Skill-markdown + manifest only — rendering is agent-driven, so no code paths changed.

Complements a cowork-side change (its doc skills calling save_file_artifact after they save) so all cowork doc output is versioned; this careercoach path is self-contained either way (it calls save_file_artifact itself).

🤖 Generated with Claude Code

https://claude.ai/code/session_01NvgV2saY75czWLEqaNVKaq

…v0.4.0)

protoAgent v0.107.0 shipped ADR 0092: the desktop build bundles the doc stack (#2123)
and the artifact plugin gained save_file_artifact (#2126, versioned file/download
artifacts). That unblocks a real .docx path for careercoach — what most ATS forms and
recruiters actually want.

Add `docx` to render_format: build the CV / cover letter as an editable Word file via
cowork's docx skill (python-docx via execute_code), then register it with
save_file_artifact so it lands in the Artifact panel as a versioned, downloadable file
with a text preview. Soft pairing — needs cowork + execute_code + a v0.107.0+ host;
falls back to html→PDF (and says so) when any is missing. No hard dependency, no core
version floor bump (the whole plugin still runs on 0.34.0 without docx).

- manifest: render_format config + setting doc gain `docx`; version 0.3.2 → 0.4.0.
- cv-guide.md / cover-letter-guide.md: the docx rendering path (build → save →
  save_file_artifact, with requirements + fallback).
- job-application-assistant SKILL.md (step 2) + role-packet SKILL.md (phase 3): render
  mentions include docx.
- README: design-decision note on native docx.

Skill + manifest only (rendering is agent-driven); tests stay green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NvgV2saY75czWLEqaNVKaq
@mabry1985
mabry1985 merged commit ce356ab into main Jul 22, 2026
1 check passed
@mabry1985
mabry1985 deleted the feat/docx-render-format branch July 22, 2026 10:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant