> Every playbook: https://protuno.com/playbooks.md · Site map for AI agents: https://protuno.com/llms.txt

# WP Doctor

Diagnoses a problem you report and matches it to a known cause. It applies a fix only for safe WordPress-level causes and hands everything else back with exact steps.

- Agent: Wren (Care)
- Steps: 5
- Changes the site: yes, in step 4
- Backup: Step 4 (Safety Snapshot And Apply Fix) saves a snapshot before it makes its change.
- Connector: No connector needed
- You get: A written Markdown report of what was found, the evidence behind it, what was changed and the result of rechecking.
- Looks at: Your site environment and current health; Logs and other evidence of the reported problem; Whether the failing check passes after the fix
- Page: https://protuno.com/playbooks/wp-doctor
- Ask: "Wren, run WP Doctor on my site."

## Steps

1. **Gateway And Environment Probe**: Checks how Protuno reaches your site and what it can do there, without changing anything.
2. **Reproduce And Health Baseline**: Reproduces the reported problem and records how healthy the site is before any change.
3. **Collect Evidence And Match Signature**: Gathers evidence and matches it to a known failure pattern, or hands the case back if nothing matches.
4. **Safety Snapshot And Apply Fix**: Saves and confirms a copy of what it will touch, then applies the one matching fix if it is a safe WordPress-level one. It rechecks the site and restores the copy if health gets worse. Server, CDN and uncertain causes are handed off with nothing changed. `changes the site`
5. **Verify And Report**: Runs the exact check that failed again and writes up what was found and what changed.

## Good to know

- Runs when you ask for it in your AI app. On Pro and Agency you can also put it on a routine.
- Needs no connector.
- Changes your site in one step only: the snapshot and fix step (step 4 of 5).
- Takes a snapshot of what it will change before applying the fix.
- If no known failure pattern matches, it applies nothing and hands off.
- To find a plugin or theme conflict it may switch plugins off and on, with the site in maintenance mode.
- When it runs depends on the agent's mode: after you press Approve in Protuno in Approval mode, or on its own in Auto mode.
- Server and CDN problems and suspected malware are diagnosed and handed off, never fixed.

## How to run it
In an AI app connected to Protuno: `ask_agent` with the site and "WP Doctor", then `propose_agent_plan`. In Approval mode, ask the user to press Approve in Protuno; in Auto mode the run starts when you propose it.
