---
name: edit-resume
description: Edit an existing resume or cover letter from critique or user feedback. Use to make evidence-safe content, hierarchy, format, or readability changes while preserving canonical claims, revalidating role fit, compiling LaTeX, and recording the edit.
---

# Edit a Resume or Cover Letter

## Startup

1. Read `shared_ops.md` and `resume_builder/canonical/claims.json` completely.
2. Run the system validator.
3. Read the session, real JD, target `.tex`, critique/feedback, selected profile rules and relevant experience files.
4. Check `historical_outputs.json`. A package marked unsafe must be regenerated from canonical sources rather than lightly polished.
5. If the package was already submitted, preserve it as history. Create a clearly named new version only when the user requests a reusable corrected document.

## Diagnose

Classify requested changes as:

- Truth/provenance correction.
- Fit/framing correction.
- Information hierarchy or readability.
- Content selection.
- Mechanical/LaTeX.
- Blocked because evidence is absent.

Do not treat whitespace, equal bullet lengths or an exact character target as defects. Do not add filler. A critique cannot authorize an unsupported claim.

Present a concise edit plan and wait for explicit confirmation unless the user already approved specific edits.

## Execute

- Source every work claim from canonical IDs and experience files.
- Keep employer/title/date hierarchy conventional.
- Preserve natural bullet lengths and verified ownership scope.
- Remove unsupported skills rather than replacing them with synonyms.
- Update a cover letter only when its session decision is YES or the user explicitly requests it.
- If edits reveal a hard fit gate, update the Evidence Fit classification; writing improvements cannot remove the gate.

## Verify

Run the validator on every edited document, compile, inspect the PDF, and verify extracted text order. Compare before/after for:

- validator failures;
- page count;
- employer/title/date visibility;
- bullet count and relevance;
- duplicated sections;
- readability at normal size.

Update the session Edit History, Document Quality, status and next action. Mark the critique stale after material edits. Present results and wait for approval.