Build AI-Ready WordPress Sites

PromptingPress is a WordPress theme designed so any AI tool can read one file, understand your entire site, and edit it safely — without knowing WordPress internals.

See How It Works

The AI Comprehension Problem

WordPress themes are designed for developers who accumulate knowledge over time. AI can't accumulate. Every session, it re-infers the same hidden logic from your code.

PromptingPress solves this by wrapping all WordPress calls in a thin abstraction layer, typing every component with a machine-readable schema, and providing a single AI_CONTEXT.md that maps the entire site structure in seconds.

How It Works

  • WP Abstraction Layer

    lib/wp.php is the only file that calls WordPress functions. Templates use pp_site_title(), pp_field(), pp_permalink() — stable contracts an AI can learn once.

  • Typed Component Props

    Every component ships with schema.json. Props are validated in WP_DEBUG mode. Missing a required prop? You get a warning, not a white screen.

  • AI_CONTEXT.md

    A single file maps the entire site: component index, file responsibilities, ACF fields, and current pages. AI reads it first and edits with confidence.

  • CI Invariant Enforcement

    GitHub Actions checks that no raw WP functions appear in templates, every component has schema.json, and no raw hex values exist in components.css.

  • Zero-JS FAQ Accordion

    The faq component uses native HTML details/summary — no JavaScript required. Accessible by default, keyboard-navigable, and screen-reader friendly.

  • Retheme in One File

    16 CSS custom properties in base.css control the entire visual system. Change the 7 color tokens to retheme the site. AI can do this without touching a single component.

Frequently Asked Questions

Does this theme require ACF?
No. The pp_field() wrapper returns null if ACF is not installed. All components accept fallback values so the page renders without any plugin installed.
Can I use this with Gutenberg or a page builder?
PromptingPress is intentionally incompatible with Gutenberg blocks and page builders. The theme is a frontend framework — WordPress handles the backend. Mixing both approaches undermines the AI comprehension guarantee.
How does an AI actually edit this theme?
Claude Code reads CLAUDE.md automatically on startup. That file instructs it to read AI_CONTEXT.md next, which maps every template, component, and file responsibility. From there, the AI can add a component, create a page, or retheme the site in one session.
What happens when I add a component?
Create a folder at components/myname/ with myname.php, README.md, and schema.json. The auto-loader picks it up — no registration needed. Call pp_get_component('myname', [...]) from any template.
Is this production-ready?
Yes. The theme uses standard WordPress enqueue hooks, registers nav menus, adds html5 theme support, and respects wp_head() and wp_footer() calls required by all plugins.

Ready to build your AI-ready site?

Start with the theme, fill in AI_CONTEXT.md, and let your AI tool do the rest.

Get Started on GitHub