WP Kit v1.0.3 — Developer Doctor Agent
🧑💻 Introducing Developer Doctor
WP Kit v1.0.3 introduces the Developer Doctor Agent, a developer-focused diagnostic system designed to help WordPress developers find runtime failures, compatibility problems, PHP issues, and configuration risks faster.
Instead of manually searching through debug logs and configuration files, Developer Doctor collects the available evidence and organizes it into a developer-friendly incident report.
🚀 What's New
PHP Error Detection
Developer Doctor can inspect wp-content/debug.log for:
- PHP Fatal Errors
- PHP Parse Errors
- PHP Warnings
- PHP Notices
- PHP Deprecations
Issues are classified by severity so critical failures are immediately visible.
💥 Runtime Fatal Detection
Developer Doctor registers a shutdown diagnostic that can capture fatal errors occurring while WP Kit is active.
Captured information can include:
- Error message
- File
- Line number
- Request-time evidence
This provides a foundation for identifying production incidents that may otherwise be difficult to reproduce.
⚠️ WordPress Deprecation Detection
Developer Doctor listens for deprecated WordPress hooks and doing_it_wrong calls.
This helps developers identify:
- Deprecated hooks
- Incorrect API usage
- Legacy integrations
- Compatibility problems
🔍 Source Classification
Where a file path is available, Developer Doctor attempts to identify the likely source:
- Plugin
- Theme
- WordPress Core
- External/Server
This makes it easier to identify which component should be investigated first.
🧠 Developer Incident Bundle
Developer Doctor introduces an AI-ready incident bundle.
The collected diagnostic information can be copied and supplied to an AI coding assistant such as OpenCode for further analysis.
Recommended workflow:
Collect → Classify → Redact → Copy → Diagnose → Review → Patch → Test
The AI layer remains optional.
🔐 Sensitive Data Protection
Developer Doctor attempts to redact sensitive values from diagnostic evidence.
Patterns such as:
- Passwords
- API keys
- Tokens
- Authorization values
- Secrets
are filtered before being displayed in the incident information.
Developers should still review diagnostic information before sharing it externally.
⚙️ Environment Diagnostics
Developer Doctor checks important development environment signals including:
- PHP version
- WordPress version
- PHP memory limit
- WP_DEBUG
- WP_DEBUG_DISPLAY
- WP_DEBUG_LOG
- Active theme information
Potential development and production risks are highlighted.
🧩 Component Diagnostics
Developer Doctor can identify development/beta plugin builds and missing theme version metadata.
This helps developers detect environments that may be difficult to reproduce or maintain.
🛡️ Audit-First Architecture
Developer Doctor does NOT automatically:
- Edit PHP files
- Delete plugins
- Delete themes
- Delete content
- Disable security plugins
- Change database credentials
- Change DNS
- Change PHP versions
- Modify server configuration
- Apply unreviewed code patches
The system is designed to provide evidence and recommendations first.
🤝 Works Alongside Query Monitor
Developer Doctor is not intended to replace Query Monitor.
Query Monitor remains an excellent request-level developer debugging toolbox.
WP Kit focuses on a complementary workflow:
Incident Detection → Source Classification → Evidence Collection → AI-Ready Diagnosis
🏗️ WP Kit Agent Architecture
WP Kit now contains three major agent foundations:
v1.0.1
Builder Compatibility Agent
Detects and provides compatibility architecture for major WordPress builders.
v1.0.2
Site Doctor Agent
Audits website health and launch readiness.
v1.0.3
Developer Doctor Agent
Helps developers diagnose runtime and compatibility problems.
🔮 What's Next
The Developer Doctor architecture provides the foundation for future capabilities including:
- AI-powered root-cause analysis
- Stack-trace intelligence
- Plugin conflict detection
- Theme/plugin compatibility analysis
- REST API diagnostics
- AJAX diagnostics
- WP-Cron diagnostics
- Database query diagnostics
- Hook analysis
- JavaScript console diagnostics
- Asset dependency diagnostics
- Performance incident analysis
- Safe patch generation
- Git-aware change analysis
- Automated regression testing
- OpenCode development workflows
📌 Version
WP Kit v1.0.3
Release: Developer Doctor Agent
Previous Release: v1.0.2 — Site Doctor Agent
Release Type: Feature Release
⚠️ Important
Developer Doctor is a diagnostic system.
Its findings should be reviewed by a developer before changes are made to production websites.
AI-generated recommendations should always be reviewed, tested in staging, and verified before deployment.