wp-contribute

WP Contribute — Working on the Plugin Itself

This command operates on this repository, not on a user's WordPress project. Everything below assumes the working directory is the plugin root (it contains .claude-plugin/).

Required skill: read ${CLAUDE_PLUGIN_ROOT}/skills/wp-contributing/SKILL.md before doing anything. It owns the layer rules, the grep-gate test style and the frontmatter contracts that every step here assumes.

Step 1: Parse arguments

$ARGUMENTS starts with a subcommand:

Subcommand	Form
new	/wp-contribute new <command|agent|skill|check> <name>
check	/wp-contribute check
pr	/wp-contribute pr [--title "..."]
release	/wp-contribute release [major|minor|patch] — maintainers

With no subcommand, print the table above and exit 0.

Confirm the working directory is the plugin root:

[ -d .claude-plugin ] && [ -d commands ] && [ -d tests/checks ]

If not, stop: "Not in the claude-wp-builder repository root. This command edits the plugin itself — to build a WordPress site, use /wp-init and /wp-yolo."

---

Step 2 — new: scaffold a layer file with everything it needs

The point of this subcommand is that a new capability is never one file. Emit all of it, so the PR cannot arrive with the check or the doc row missing.

new command <name>

1. commands/<name>.md — frontmatter carrying description, allowed-tools and argument-hint (add Agent to allowed-tools only if it will dispatch subagents), then numbered ## Step N: sections. The first step parses $ARGUMENTS; the second reads the project's .claude/CLAUDE.md for prefix, theme slug, languages, template and i18n strategy, and tells the user to run /wp-init first when it is missing.
2. tests/checks/<name>.sh — a grep gate in the house style: a comment naming the contract it protects, set -euo pipefail, cd "$(dirname "$0")/../..", a fail() helper, assertions, echo PASS. Make it executable.
3. A row in the README Commands Reference table (Command · Path · Required? · Description).
4. An entry in docs/commands.md, and a step in docs/workflows.md if it belongs to a build path (A /wp-yolo, B step-by-step, C cinematic).
5. A CHANGELOG.md entry under [Unreleased] → ### Added.