From superpowers-sage
Install the Roots AI stack (acorn-ai + wordpress/mcp-adapter) in a Sage/Bedrock project via Lando. Probes readiness, installs packages, writes API key, generates .mcp.json, validates handshake.
How this skill is triggered — by the user, by Claude, or both
Slash command
/superpowers-sage:ai-setupThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill installs and validates the Roots AI stack in your Sage/Bedrock project.
This skill installs and validates the Roots AI stack in your Sage/Bedrock project.
| Package | Purpose |
|---|---|
roots/acorn-ai | Laravel AI SDK bridge for Acorn |
wordpress/mcp-adapter | Exposes WP site via Model Context Protocol (stdio) |
Prerequisite: WordPress ≥ 6.9, Lando running.
node <plugin-scripts-path>/detect-ai-readiness.mjs --path .
Read the missing array. Proceed through only the steps that apply.
missing includes acorn-ai or mcp-adapter)The two packages belong to different layers — install them separately:
# Laravel AI bridge — goes into the theme
lando theme-composer require roots/acorn-ai
# WordPress MCP plugin — goes into the Bedrock root (installer-paths)
lando composer require wordpress/mcp-adapter
lando wp acorn vendor:publish --tag=acorn-ai
wordpress/mcp-adapter is a wordpress-plugin type package. If installed via the theme Composer it
lands in theme/vendor/ with no WordPress activation — always use root composer.
See references/install-steps.md for full install details, version conflict resolution, and the Bedrock autoloader stub fix.
missing includes api-key)Ask the user which provider they want to use:
ANTHROPIC_API_KEYOPENAI_API_KEYDo not write the key yourself. Show the exact line to add to .env:
ANTHROPIC_API_KEY=<paste-your-key-here>
Warn: Confirm .env is in .gitignore before proceeding: grep .env .gitignore
.mcp.jsonnode <plugin-scripts-path>/generate-project-mcp.mjs --path .
This merges the mcpServers.wordpress entry non-destructively into the project's .mcp.json.
lando wp mcp-adapter list
Expected: at least one server listed (e.g. mcp-adapter-default-server).
If the command returns "not a registered wp command" with the plugin showing as active, see Bedrock + installer-paths stub fix.
Then in Claude Code, confirm MCP is working:
discover-abilities
Expected: a list of available WordPress Abilities.
See references/rollback.md for per-step rollback commands.
node <plugin-scripts-path>/detect-ai-readiness.mjs --path .
Expected: "ready": true with all fields populated.
roots/acorn-ai or wordpress/mcp-adapter require a version of Acorn or WordPress that your project doesn't have.references/install-steps.md for version resolution steps. Usually requires updating Acorn or WordPress first.wp mcp-adapter list returns "not a registered wp command" (Bedrock)wordpress/mcp-adapter looks for vendor/autoload.php inside its own plugin directory.
In Bedrock with installer-paths the autoloading lives in the root vendor/ — the plugin-local
path never exists, so the plugin silently skips registering all hooks.references/install-steps.md for the stub solution.discover-abilities.mcp.json was not generated, or the generate-project-mcp.mjs script failed.node <plugin-scripts-path>/generate-project-mcp.mjs --path . and verify the file exists and contains "mcpServers": { "wordpress": ... }..env changes not taking effect.env not sourced by Bedrock.lando restart to refresh containers. Verify .env is in the project root and readable.For complete rollback instructions, see references/rollback.md.
npx claudepluginhub hekivo/superpowers-sageSets up and modifies Roots Sage + Acorn WordPress themes in Lando environments: ACF blocks, Blade components, Vite/Tailwind frontend, service providers, and CPTs.
Installs and activates WordPress MCP adapter in build: copies from vendor/, activates via WP-CLI, re-exports database, writes README.md with config, updates build.json. For WP plugin build pipelines.
Discovers, recommends, installs, and verifies MCP servers based on detected project stack, handling package installation, configuration, env vars, and testing.