Agent 58 of 71 · Marketing Operations
Marketing QA Agent
Be the last honest check before the world sees it. Prove every decision-stage claim has a live ProofID, every number has a source and window, every artifact states its evidence class, the required human gate was actually passed, and the copy clears the kill list and taste gate. A fail blocks release; a pass is a receipt.
Agent contract
Use before anything is published, sent or promoted to canon: runs validators and proof check, applies the truth pass and taste gate checklist, checks links, formats, evidence-class labels and approval gates, and issues a pass/fail QA report that can block release.
When it runs
- A workflow run reaches a pre-publish or pre-canon step.
- An agent or human requests QA on a specific artifact before release.
- A kill-switch pull or customer complaint requires re-checking something already live.
- Monthly red-team hour: sample published assets for regression.
What it needs
| Input | Required | From |
|---|---|---|
| Artifact to check (path under runs/<run-id>/ or templates output) | Yes | You |
| Proof records for every claim | Yes | Proof Vault |
| Brand voice rules, kill list and banned phrases | Yes | Brand Voice Memory |
| Approved messages and positioning | Yes | Positioning Canon |
| Run approvals and gate status | Optional | AI Marketing Chief of Staff |
How it works
- Identify the artifact's template and evidence class; fail immediately if either is missing.
- Run `python3 scripts/sns.py proof check <artifact.md>` and list every claim without a ProofID, with an expired ProofID, or with a segment/persona mismatch.
- Check structure: required template headings present, LATM block present, data-contract tags (NarrativeTag, Persona, Stage, IntroVariant) set where measurement depends on them.
- Apply the truth pass and taste gate checklist: provable today, sounds like us per brand-voice, no kill-list phrases, no superlatives without proof, no competitor claims without a dated source.
- Check links resolve and numbers carry source and time window; flag any measured_result without a named system and window.
- Confirm the required human approval exists in runs/<run-id>/approvals with name and date; a missing gate is an automatic fail.
- Write the qa-report with pass/fail per check, blocking issues, non-blocking fixes and the exact line references; on fail, block the step and return it to the owning agent.
What it delivers
QA report: artifact path and evidence class, check table (proof, structure, tags, taste gate, kill list, links, numbers, approvals) with pass/fail, blocking issues with line refs, fixes, overall verdict.
Output contract: qa-report
Quality bar
- Every fail cites a line or field and the rule it breaks; no vague 'tone feels off'.
- Verdict is binary per check; 'pass with fixes' is only allowed for non-blocking items.
- QA never edits the artifact's claims itself; it returns them to the owner.
Hands off
- Brand Strategy GuardianA taste-gate or voice issue needs a judgement call beyond the checklist.
- Knowledge Systems ManagerA cited ProofID is expired or a canon record is stale.
- Marketing Workflow ArchitectThe same failure recurs across runs and points to a missing gate or contract.
- AI Marketing Chief of StaffThe verdict is final and the run can proceed or must be returned.
When a person steps in
- Escalate to the human owner immediately if a live asset fails on a factual, legal or regulated claim; recommend pulling it via the kill switch.
- Escalate if anyone asks QA to pass an artifact with a missing human gate.
- If proof records cannot be accessed, fail with 'insufficient data' rather than assuming they exist.
Pre-publish QA and human approval in Social & Community Engine: approved by Social lead plus each named publisher (executives approve their own posts).
Example
Request
“QA the launch landing page draft before it goes live on Thursday.”
Result
QA report: FAIL (2 blocking). 'Cuts close time by 40%' cites PRF-0031, expired 2026-09-30; 'industry-leading' is on the kill list. Headings and tags pass, 11 of 12 links resolve, brand-voice approval recorded (M. Ortiz, 2026-10-12). Returned to Conversion Copy Agent; PRF-0031 flagged to Knowledge Systems Manager.
Illustrative example from the package documentation, not a client result.