Repository navigation
v0.1.0 — first public release
First public release of Agent Ready — an open-source WordPress plugin that turns a site into a first-class citizen of the AI-agent web. A single Context Profile (configured once under Tools → Context) drives every agent-facing surface: what's exposed, how it's served, and how it's scored.
Modules
Four coherent modules ship in v0.1, all driven by one profile:
- Markdown Views — deterministic HTML → Markdown rendering for any public URL, with three URL forms (
.mdpath,?format=mdquery,Accept: text/markdowncontent negotiation) and uniform 404 on denial. Per-post cache with content-hash invalidation, Gutenberg sidebar preview, WP-CLI command (wp agentready md preview), REST endpoint for admin tooling. Optional LLM cleanup pass with safety guard. - LLMs Index —
/llms.txtgenerator publishing a discovery surface for AI agents. Conflict detection againstrobots.txt. Editorial-entries admin UI for site owners to add curated non-WordPress URLs. Optional LLM-powered pass drafts per-entry descriptions from post content. WP-CLI:wp agentready llms-txt {status,regen,preview}. - Context Score — 0–100 readiness audit across six weighted sub-scores (discoverability 20, content readability 15, schema coverage 10, exposure safety 15, integration health 15, Markdown conversion quality 25). Admin page under Tools → Context Score, Site Health integration, REST endpoint, WP-CLI
wp agentready context-score recompute. LLM-generated narrative with rule-based fallback. - Schema Coordination — detects whether your SEO plugin (Yoast, Rank Math, AIOSEO, The SEO Framework) already emits JSON-LD. When one is active, Agent Ready emits nothing competing. When none is active, optionally emits a native WebSite + Organization + per-content schema set (toggle in the Context Profile; default off) so the schema sub-score is achievable without a third-party plugin.
Privacy and storage
- No content leaves your server. Zero external HTTP calls in the deterministic surfaces.
- Optional LLM features (Markdown cleanup, /llms.txt descriptions, Context Score narrative) consult the WP AI Client only when explicitly toggled on.
- Two custom tables:
{prefix}agentready_md_cache(one row per published post served as Markdown) and{prefix}agentready_score_audit_log(one row per audit run, retained for trend analysis). Both dropped on uninstall.
Requirements
- WordPress 6.9+
- PHP 7.4+
- WP AI Client (optional — required only by the LLM-using modules; deterministic features run fully locally without it)
Installation
Once approved on wp.org: search for "Agent Ready" in Plugins → Add New, or install via WP-CLI: wp plugin install agentready --activate.
Before wp.org approval: download the ZIP attached to this release and install via Plugins → Add New → Upload Plugin.
Acknowledgements
- Layered CI (PHPCS WordPress + WordPressVIPMinimum, Plugin Check Tool, PHPStan level 5, PHPUnit unit × 2 PHP versions, PHPUnit integration × 4 cells) catches regressions before they ship.
- Built on the WordPress AI Client surface to keep AI provider integration WordPress-native rather than reinventing it.
Full changelog
Cumulative commit list since the initial scaffold:
Markdown Views (#5, #6, #51, #52, #53)
feat(#5): Markdown Views deterministic floor (Phases 1-4)— #36feat(#5): Markdown Views admin surfaces + docs (Phases 5-9)— #40feat(#6): Markdown Views LLM cleanup engine + safety guard (Phase A)— #46feat(#6): wire Client_Wrapper to wp_ai_client_prompt— #49feat(#6): Markdown Views cleanup admin UI + approval flow (Phase B)— #50fix(#52): re-run dbDelta on admin_init when schema lags— #54feat(#53): stuck-pending UX hint after 60s waiting on WP cron— #55fix(#37,#38): MD-escape link brackets / parens; fence inline code by max backtick run— #77
feat(#7): LLMs Index Phase A — /llms.txt generator floor— #56feat(#7): LLMs Index Phase B — conflict detection + admin notice— #60feat(#7): LLMs Index Phase C — editorial entries admin UI— #65fix(#66): classify 4xx WP_Error returns as Permanent_Error— #67feat(#8): LLM-powered /llms.txt entry descriptions — Phase A engine + WP-CLI— #68feat(#8): LLM-powered /llms.txt entry descriptions — Phase B admin UI— #69
feat(#9): Context Score engine — 0–100 score + 6 sub-scores + wp context audit— #71feat(#10): build Context Score admin UI — Tools page, REST, Site Health— #72feat(#11): build Context Score LLM narrative with rule-based fallback— #74
Schema Coordination (#12, #73)
feat(#12): build gap-fill JSON-LD emitter with SEO plugin deference— #75feat(#73): gate native JSON-LD emission behind a Profile toggle; credit it in Context Score— #76
Infrastructure + release prep
chore(#3): build layered CI matrix (PHPCS + Plugin Check + PHPUnit)— #17chore(#18): rename plugin to AgentReady (drop "wp" for wp.org policy)— #19chore(#13): add PHPStan level 5 static analysis— #26feat(#4): add Context Profile admin screen— #27chore(#29): clear WP Plugin Check warnings (Domain Path + load_plugin_textdomain)— #32chore(#80): build wp.org distribution ZIP — tools/build-zip.sh + .distignore + CI verification— #83chore(#78): wp.org submission readiness — correct headers, readme rewrite, "Agent Ready" rename— #81chore(#79): build wp.org placeholder assets — banner, icon, screenshots— #82chore(#84): exclude webpack.config.js from wp.org distribution ZIP— #85chore(#86): fix wp.org attribution — Mohamed Khaled as Author + Contributor— #87
What's next (v0.1.1 fast-follow)
- AI Assistant Preview pane — render a page as ChatGPT / Claude consume it (#45)
ai.txtand/.well-known/discovery surface detection (#22)- MCP / WordPress Abilities API integration (#21)
- Native Schema_Emitter expansion so schema coverage is fully achievable without any SEO plugin (#73 follow-up)
- LLMs Index test hardening (#57–#64)