README

Part of the AI Building Blocks for WordPress initiative

Handbook

Overview

• Purpose: provide a common way for WordPress core, plugins, and themes to describe what they can do ("abilities") in a machine‑readable, human‑friendly form.
• Scope: discovery, permissioning, and execution metadata only. Actual business logic stays inside the registering component.
• Audience: plugin & theme authors, agency builders, and future AI / automation tools.

Design Goals

1. Discoverability - every ability can be listed, queried, and inspected.
2. Interoperability - a uniform schema lets unrelated components compose workflows.
3. Security‑first - explicit permissions determine who/what may invoke an ability.
4. Gradual adoption - ships first as a Composer package, migrates smoothly to core.

Documentation

• Developer docs.
• Contributing Guidelines.

Inspiration

• wp‑feature‑api - shared vision of declaring capabilities at the PHP layer.
• Command Palette experiments in Gutenberg.
• Modern AI assistant protocols (MCP, A2A).

Current Status

How to Get Involved

• Discuss: #core-ai channel on WordPress Slack.
• File issues: suggestions & use‑cases welcome in this repo.
• Prototype: experiment with the feature plugin or the wordpress/abilities-api Composer package.

License

WordPress is free software, and is released under the terms of the GNU General Public License version 2 or (at your option) any later version. See LICENSE.md for complete license.