wp-agentic-kit

A starter kit for building WordPress with agentic engineering. The harness, the skills, and the MCP servers Marcel uses every day, packaged so you can install once and start delegating implementation on Monday morning.

Companion to the talk "A Nova Era do WordPress: De Developer a Arquiteto com Engenharia Agêntica" at WordCamp Portugal 2026.

Why this exists

Senior WordPress developers don't need to write boilerplate anymore. What we still need to do is design the system that writes it. The talk frames that system in four D's; the kit makes each one concrete:

Plus curated MCP servers and the scaffolding CLI that sets it all up in one command.

What's in here

Quick start

npm create wp-ai-plugin my-cool-plugin
# or
npx create-wp-ai-plugin my-cool-plugin

The interactive scaffolder asks for the plugin name, an optional vendor prefix, a one-sentence description, an author, and then lets you pick the minimum WordPress and PHP versions from a short list. It fetches the kit from GitHub at the requested git ref, derives the slug / namespace / constant / function prefixes, runs a find-and-replace across every file, runs composer install and npm install, pulls WordPress/agent-skills into .claude/skills/, and initialises a fresh git repo with a scaffold tag on the initial commit.

Prerequisites: Node 18+ and npm, PHP 8.2+ and composer, git on $PATH. The CLI source lives in cli/, published to npm as create-wp-ai-plugin.

Need to pin a release?

npm create wp-ai-plugin my-cool-plugin -- --ref v0.2.0

If you'd rather adopt the kit into an existing plugin, copy individual pieces (CLAUDE.md, AGENTS.md, .claude/, mcp/) into your project and replace the example values by hand.

Status

This kit is being built live alongside the talk. Each piece lands in its own commit so you can see the harness assemble step by step.

• 1 — CLAUDE.md
• 2 — AGENTS.md
• 3 — settings.json
• 4 — MCP servers
• 5 — Skills (scaffold + feature, with planning phases)
• 6 — Plans (constitution + per-feature spec/plan/progress)
• 7 — Sub-agents (plan-reviewer + security-reviewer)
• 8 — Hooks (pre-commit, post-edit, user-prompt-submit, stop)
• 9 — Scripts (quality.sh, open-plan-pr.sh)
• 10 — Tests (hook test suite, integrated into quality.sh)
• 11 — Docs walkthrough

License

MIT. Take it, fork it, ship faster.