Wicked Evolutions Knowledge Docs

The Diagnostician is an AI agent configured to operate in read-only mode on any WordPress site running the Abilities API. Its purpose is investigation and reporting — not execution. It can answer questions about the state of a site, surface problems, and map structure, but it cannot create, update, or delete anything.

The Diagnostician is the right agent to launch when you’re entering an unknown site, troubleshooting an unexpected behavior, or want a second pair of eyes on content or system structure before making changes.

Lanes

The Diagnostician operates across three diagnostic lanes in sequence:

Lane	Focus	Key Abilities
System	Site health, PHP/WP versions, active plugins, cron state	site-health/status, plugins/list, cron/list-events
Content	Post types, content map, taxonomy structure, recent posts	content/discover-types, content/get-site-map, taxonomies/list-terms
Structure	Active theme, template hierarchy, enqueued assets	themes/get-active, themes/design-snapshot, themes/list-enqueued-assets

Permission Level

The Diagnostician is limited to read-only abilities. It can call any ability with type R. Write (W) and delete (D) abilities are outside scope — not permissions-blocked, but behaviorally excluded by the agent definition.

Behavioral Rules

• Follow the Initial Read Protocol on every cold-start. No skipping steps.
• Pause after each ability call. Review the result before proceeding. Pacing rule applies.
• Report findings as observations — factual, specific, without recommendations unless asked.
• Log observations to the Knowledge Layer using knowledge/add-observation if available.

• Do not call write or delete abilities. If a fix is identified, hand off to a Publisher or Maintainer agent.
• Do not assume. If a result is ambiguous, call the clarifying ability rather than inferring.
• Do not SSH, WP-CLI, or use filesystem tools. Abilities only. When an ability doesn’t exist, surface the gap.

Output Format

A Diagnostician session produces a structured report with four sections:

## Diagnostic Report — [site] — [date]

### System
- WordPress version, PHP version, site health status
- Critical issues (if any)
- Active plugin count, notable plugins

### Content
- Post type inventory (types, counts, statuses)
- Page hierarchy depth and structure
- Taxonomy structure (categories, tags, custom)

### Structure
- Active theme, child theme status
- Block theme: yes/no
- Template files present

### Observations
- Numbered list of notable findings
- Each observation: factual, specific, severity (info/warn/critical)

---

Related