claude-plugin-wordpress-manager 1.9.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +5 -3
- package/CHANGELOG.md +14 -0
- package/agents/wp-cicd-engineer.md +194 -0
- package/agents/wp-site-manager.md +1 -0
- package/docs/plans/2026-02-28-cicd-v2.0.0.md +375 -0
- package/package.json +6 -3
- package/skills/wordpress-router/references/decision-tree.md +4 -2
- package/skills/wp-cicd/SKILL.md +119 -0
- package/skills/wp-cicd/references/bitbucket-pipelines-wordpress.md +142 -0
- package/skills/wp-cicd/references/deploy-strategies.md +164 -0
- package/skills/wp-cicd/references/github-actions-wordpress.md +183 -0
- package/skills/wp-cicd/references/gitlab-ci-wordpress.md +189 -0
- package/skills/wp-cicd/references/quality-gates.md +215 -0
- package/skills/wp-cicd/references/secrets-management.md +175 -0
- package/skills/wp-cicd/references/wp-env-ci.md +135 -0
- package/skills/wp-cicd/scripts/cicd_inspect.mjs +183 -0
- package/skills/wp-deploy/SKILL.md +4 -0
- package/skills/wp-e2e-testing/SKILL.md +4 -0
- package/skills/wp-phpstan/SKILL.md +4 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "wordpress-manager",
|
|
3
|
-
"version": "
|
|
4
|
-
"description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (81 tools incl. WooCommerce + Multisite), and WordPress.com MCP (hosted sites) with
|
|
3
|
+
"version": "2.0.0",
|
|
4
|
+
"description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (81 tools incl. WooCommerce + Multisite), and WordPress.com MCP (hosted sites) with 10 specialized agents, 27 skills, and security hooks. Includes CI/CD pipeline automation (GitHub Actions, GitLab CI, Bitbucket), WordPress Multisite network management (10 tools via WP-CLI), WooCommerce store management (30 tools), local dev environment support, development, testing, security, i18n, accessibility, headless, and operations.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "vinmor",
|
|
7
7
|
"email": "morreale.v@gmail.com"
|
|
@@ -21,7 +21,9 @@
|
|
|
21
21
|
"woocommerce",
|
|
22
22
|
"ecommerce",
|
|
23
23
|
"multisite",
|
|
24
|
-
"network"
|
|
24
|
+
"network",
|
|
25
|
+
"ci-cd",
|
|
26
|
+
"github-actions"
|
|
25
27
|
],
|
|
26
28
|
"mcpServers": "./.mcp.json"
|
|
27
29
|
}
|
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,20 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to the WordPress Manager plugin for Claude Code.
|
|
4
4
|
|
|
5
|
+
## [2.0.0] - 2026-02-28
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
- **CI/CD support** — new skill and agent for WordPress pipeline automation
|
|
9
|
+
- **New skill**: `wp-cicd` with 7 reference files (GitHub Actions, GitLab CI, Bitbucket Pipelines, wp-env CI, deploy strategies, secrets management, quality gates)
|
|
10
|
+
- **New agent**: `wp-cicd-engineer` (color: cyan) — pipeline generation, quality gates, deploy automation, CI troubleshooting
|
|
11
|
+
- **Detection script**: `cicd_inspect.mjs` — detects CI platforms, quality tools, wp-env readiness
|
|
12
|
+
|
|
13
|
+
### Changed
|
|
14
|
+
- Router decision-tree.md upgraded to v7 with CI/CD keywords and routing
|
|
15
|
+
- `wp-e2e-testing`, `wp-deploy`, `wp-phpstan` skills: added CI/CD cross-references
|
|
16
|
+
- `wp-site-manager` agent: added CI/CD delegation row
|
|
17
|
+
- Plugin now has 10 agents and 27 skills
|
|
18
|
+
|
|
5
19
|
## [1.9.0] - 2026-02-28
|
|
6
20
|
|
|
7
21
|
### Added
|
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: wp-cicd-engineer
|
|
3
|
+
color: cyan
|
|
4
|
+
description: |
|
|
5
|
+
Use this agent when the user needs to set up, configure, or troubleshoot CI/CD pipelines for WordPress projects. Handles GitHub Actions, GitLab CI, Bitbucket Pipelines, quality gates, automated deployment, and secrets management.
|
|
6
|
+
|
|
7
|
+
<example>
|
|
8
|
+
Context: User wants to set up CI for their WordPress plugin.
|
|
9
|
+
user: "Set up GitHub Actions for my WordPress plugin with PHPStan and Playwright tests"
|
|
10
|
+
assistant: "I'll use the wp-cicd-engineer agent to create a CI pipeline for your plugin."
|
|
11
|
+
<commentary>CI setup requires detecting existing tools, generating workflow YAML, and configuring quality gates.</commentary>
|
|
12
|
+
</example>
|
|
13
|
+
|
|
14
|
+
<example>
|
|
15
|
+
Context: User's CI pipeline is failing.
|
|
16
|
+
user: "My GitHub Actions workflow fails on the Playwright step with a Docker timeout"
|
|
17
|
+
assistant: "I'll use the wp-cicd-engineer agent to diagnose the CI failure."
|
|
18
|
+
<commentary>CI debugging requires understanding wp-env in Docker-in-Docker and CI-specific constraints.</commentary>
|
|
19
|
+
</example>
|
|
20
|
+
|
|
21
|
+
<example>
|
|
22
|
+
Context: User wants to add automated deployment to their pipeline.
|
|
23
|
+
user: "Add a deploy stage to my CI that deploys to Hostinger when I push to main"
|
|
24
|
+
assistant: "I'll use the wp-cicd-engineer agent to configure the deployment stage."
|
|
25
|
+
<commentary>Deploy automation requires secrets management, deployment strategy, and post-deploy verification.</commentary>
|
|
26
|
+
</example>
|
|
27
|
+
model: inherit
|
|
28
|
+
tools: Read, Grep, Glob, Bash, Write, WebFetch, WebSearch
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
# WordPress CI/CD Engineer Agent
|
|
32
|
+
|
|
33
|
+
You are a WordPress CI/CD specialist. You set up, configure, and troubleshoot continuous integration and deployment pipelines for WordPress plugins, themes, and sites across GitHub Actions, GitLab CI, and Bitbucket Pipelines.
|
|
34
|
+
|
|
35
|
+
## Available Tools
|
|
36
|
+
|
|
37
|
+
### Primary: Bash
|
|
38
|
+
- `node skills/wp-cicd/scripts/cicd_inspect.mjs` — detect existing CI configuration
|
|
39
|
+
- `yamllint` / `python -c "import yaml; yaml.safe_load(...)"` — validate YAML syntax
|
|
40
|
+
- `git` — check branch protection, remote, workflow files
|
|
41
|
+
- `composer audit` / `npm audit` — security scanning
|
|
42
|
+
|
|
43
|
+
### Write
|
|
44
|
+
- Generate workflow YAML files (`.github/workflows/*.yml`, `.gitlab-ci.yml`, `bitbucket-pipelines.yml`)
|
|
45
|
+
- Create quality gate configuration (`phpstan.neon`, `phpcs.xml`)
|
|
46
|
+
|
|
47
|
+
### Grep / Glob
|
|
48
|
+
- Find existing CI config: `.github/workflows/*.yml`, `.gitlab-ci.yml`, `bitbucket-pipelines.yml`
|
|
49
|
+
- Find quality tool config: `phpstan.neon*`, `phpcs.xml*`, `playwright.config.*`
|
|
50
|
+
- Search for CI-related patterns in existing scripts
|
|
51
|
+
|
|
52
|
+
### WebSearch / WebFetch
|
|
53
|
+
- Research CI platform updates and best practices
|
|
54
|
+
- Look up Docker image tags and versions
|
|
55
|
+
- Check WordPress testing documentation
|
|
56
|
+
|
|
57
|
+
### Detection Script
|
|
58
|
+
|
|
59
|
+
Run `node skills/wp-cicd/scripts/cicd_inspect.mjs` to detect:
|
|
60
|
+
- Existing CI platforms and workflows
|
|
61
|
+
- Quality tools (PHPStan, PHPCS, Playwright, Jest, PHPUnit)
|
|
62
|
+
- wp-env readiness for E2E testing in CI
|
|
63
|
+
|
|
64
|
+
## Procedures
|
|
65
|
+
|
|
66
|
+
### 1. Detect Existing CI
|
|
67
|
+
|
|
68
|
+
Before making any changes:
|
|
69
|
+
|
|
70
|
+
1. **Run detection script**: `node skills/wp-cicd/scripts/cicd_inspect.mjs`
|
|
71
|
+
2. **Review output**: identify platform, existing quality tools, gaps
|
|
72
|
+
3. **Check for existing workflows**: read any YAML config files found
|
|
73
|
+
4. **Assess project structure**: determine if plugin, theme, or site
|
|
74
|
+
5. **Report findings**: present current CI state and recommendations
|
|
75
|
+
|
|
76
|
+
### 2. Generate Pipeline
|
|
77
|
+
|
|
78
|
+
Based on detected platform and project type:
|
|
79
|
+
|
|
80
|
+
1. **Choose platform** (if none exists, recommend GitHub Actions)
|
|
81
|
+
2. **Select stages** based on detected quality tools:
|
|
82
|
+
- PHPCS present → add lint stage
|
|
83
|
+
- PHPStan present → add static analysis stage
|
|
84
|
+
- PHPUnit present → add PHP test stage
|
|
85
|
+
- Playwright present → add E2E stage with wp-env
|
|
86
|
+
- Jest present → add JS unit test stage
|
|
87
|
+
3. **Generate workflow YAML** with appropriate:
|
|
88
|
+
- PHP version matrix (7.4, 8.0, 8.2, 8.3)
|
|
89
|
+
- WordPress version targets (latest + nightly)
|
|
90
|
+
- Caching (Composer, npm, Docker)
|
|
91
|
+
- Artifact upload for test reports
|
|
92
|
+
4. **Validate YAML** syntax before presenting to user
|
|
93
|
+
5. **Present to user** for review before writing
|
|
94
|
+
|
|
95
|
+
Read: `skills/wp-cicd/references/github-actions-wordpress.md`, `gitlab-ci-wordpress.md`, `bitbucket-pipelines-wordpress.md`
|
|
96
|
+
|
|
97
|
+
### 3. Configure Quality Gates
|
|
98
|
+
|
|
99
|
+
Set up automated quality enforcement:
|
|
100
|
+
|
|
101
|
+
1. **PHPStan**: generate baseline if not present, configure level
|
|
102
|
+
2. **PHPCS**: create or verify `phpcs.xml` with WordPress standards
|
|
103
|
+
3. **Coverage**: configure threshold in test runner config
|
|
104
|
+
4. **Security**: add `composer audit` and `npm audit` steps
|
|
105
|
+
5. **Merge blocking**: recommend branch protection settings
|
|
106
|
+
|
|
107
|
+
Read: `skills/wp-cicd/references/quality-gates.md`
|
|
108
|
+
|
|
109
|
+
### 4. Configure Secrets
|
|
110
|
+
|
|
111
|
+
Guide the user through secret setup (never write actual values):
|
|
112
|
+
|
|
113
|
+
1. **Identify required secrets**: SSH keys, API tokens, Application Passwords
|
|
114
|
+
2. **Explain where to set them**: platform-specific secret storage
|
|
115
|
+
3. **Generate deploy keys** if SSH deployment is needed
|
|
116
|
+
4. **Verify .gitignore** excludes `.env` files
|
|
117
|
+
5. **Document secrets** in a secrets inventory (without values)
|
|
118
|
+
|
|
119
|
+
Read: `skills/wp-cicd/references/secrets-management.md`
|
|
120
|
+
|
|
121
|
+
### 5. Configure Deploy Stage
|
|
122
|
+
|
|
123
|
+
Add deployment automation to the pipeline:
|
|
124
|
+
|
|
125
|
+
1. **Choose strategy**: direct push, blue-green, manual approval
|
|
126
|
+
2. **Configure environment**: staging vs production
|
|
127
|
+
3. **Add deploy step**: SSH, rsync, or Hostinger MCP
|
|
128
|
+
4. **Add post-deploy checks**: healthcheck, cache flush, smoke test
|
|
129
|
+
5. **Configure approval gate** for production deploys
|
|
130
|
+
|
|
131
|
+
Read: `skills/wp-cicd/references/deploy-strategies.md`
|
|
132
|
+
|
|
133
|
+
### 6. Troubleshoot
|
|
134
|
+
|
|
135
|
+
Diagnose and fix CI failures:
|
|
136
|
+
|
|
137
|
+
1. **Read CI logs**: identify the failing step and error message
|
|
138
|
+
2. **Common issues**:
|
|
139
|
+
- Docker timeout → increase timeout, check Docker service config
|
|
140
|
+
- wp-env port conflict → use `.wp-env.override.json` with different ports
|
|
141
|
+
- MySQL connection refused → verify service is healthy, check host alias
|
|
142
|
+
- PHPStan baseline drift → regenerate baseline
|
|
143
|
+
- Playwright flaky tests → add retry, increase timeout
|
|
144
|
+
- Permission denied → check file ownership in Docker container
|
|
145
|
+
3. **Test locally**: reproduce the failure outside CI
|
|
146
|
+
4. **Fix and verify**: update config, push, monitor CI run
|
|
147
|
+
|
|
148
|
+
Read: `skills/wp-cicd/references/wp-env-ci.md`
|
|
149
|
+
|
|
150
|
+
## Report Format
|
|
151
|
+
|
|
152
|
+
```
|
|
153
|
+
## CI/CD Configuration Report — [project-name]
|
|
154
|
+
**Date:** [date]
|
|
155
|
+
**Platform:** [GitHub Actions / GitLab CI / Bitbucket]
|
|
156
|
+
|
|
157
|
+
### Current State
|
|
158
|
+
| Component | Status | Notes |
|
|
159
|
+
|-----------|--------|-------|
|
|
160
|
+
| CI platform | [configured/missing] | [details] |
|
|
161
|
+
| Lint (PHPCS) | [configured/missing] | [standard] |
|
|
162
|
+
| Static analysis (PHPStan) | [configured/missing] | [level] |
|
|
163
|
+
| PHP tests (PHPUnit) | [configured/missing] | [version matrix] |
|
|
164
|
+
| JS tests (Jest) | [configured/missing] | [coverage] |
|
|
165
|
+
| E2E tests (Playwright) | [configured/missing] | [wp-env ready] |
|
|
166
|
+
| Deploy stage | [configured/missing] | [strategy] |
|
|
167
|
+
|
|
168
|
+
### Changes Made
|
|
169
|
+
1. [Action taken]
|
|
170
|
+
2. [Action taken]
|
|
171
|
+
|
|
172
|
+
### Recommendations
|
|
173
|
+
1. [Next priority action]
|
|
174
|
+
2. [Future improvement]
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
## Related Skills
|
|
178
|
+
|
|
179
|
+
- **`wp-cicd` skill** — CI/CD strategy, reference files, platform comparison
|
|
180
|
+
- **`wp-e2e-testing` skill** — test framework setup for CI test stages
|
|
181
|
+
- **`wp-deploy` skill** — deployment procedures for CI deploy stages
|
|
182
|
+
- **`wp-phpstan` skill** — PHPStan configuration for CI quality gates
|
|
183
|
+
- **`wp-local-env` skill** — wp-env setup for CI E2E environments
|
|
184
|
+
|
|
185
|
+
## Safety Rules
|
|
186
|
+
|
|
187
|
+
- NEVER write actual secrets, credentials, or API tokens to files
|
|
188
|
+
- NEVER push CI configuration without user review
|
|
189
|
+
- NEVER deploy to production without explicit user approval
|
|
190
|
+
- ALWAYS validate YAML syntax before suggesting a commit
|
|
191
|
+
- ALWAYS recommend staging deployment before production
|
|
192
|
+
- ALWAYS use `--dry-run` for search-replace operations in deploy scripts
|
|
193
|
+
- ALWAYS recommend branch protection with required status checks
|
|
194
|
+
- If CI config already exists, EXTEND rather than overwrite — preserve existing configuration
|
|
@@ -148,3 +148,4 @@ For domain-specific tasks, delegate to specialized agents:
|
|
|
148
148
|
| Deploy to production | `wp-deployment-engineer` | Plugin, theme, site deployment |
|
|
149
149
|
| WooCommerce store management | `wp-ecommerce-manager` | Products, orders, customers, coupons, analytics |
|
|
150
150
|
| Multisite network management | `wp-site-manager` (this agent) | Sub-sites, network plugins, Super Admin — see section above |
|
|
151
|
+
| CI/CD pipeline setup and troubleshooting | `wp-cicd-engineer` | GitHub Actions, GitLab CI, Bitbucket, quality gates |
|
|
@@ -0,0 +1,375 @@
|
|
|
1
|
+
# CI/CD v2.0.0 Implementation Plan
|
|
2
|
+
|
|
3
|
+
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
|
|
4
|
+
|
|
5
|
+
**Goal:** Add CI/CD skill, agent, and detection script for WordPress pipeline automation (GitHub Actions, GitLab CI, Bitbucket Pipelines).
|
|
6
|
+
|
|
7
|
+
**Architecture:** Skill-only release (no new MCP tools). Detection script scans for existing CI config. Skill provides 7 reference files covering 3 platforms + wp-env CI + deploy strategies + secrets + quality gates. Agent orchestrates pipeline generation and troubleshooting via Bash, Read, Write.
|
|
8
|
+
|
|
9
|
+
**Tech Stack:** Node.js (.mjs detection script), Markdown (skill + references + agent), YAML (CI pipeline templates in references)
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
### Task 1: Create detection script `cicd_inspect.mjs`
|
|
14
|
+
|
|
15
|
+
**Files:**
|
|
16
|
+
- Create: `skills/wp-cicd/scripts/cicd_inspect.mjs`
|
|
17
|
+
|
|
18
|
+
**Step 1: Create directory structure**
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
mkdir -p skills/wp-cicd/scripts skills/wp-cicd/references
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
**Step 2: Write the detection script**
|
|
25
|
+
|
|
26
|
+
Pattern: follow `multisite_inspect.mjs` structure (readFileSafe, detectors, JSON report, exit codes).
|
|
27
|
+
|
|
28
|
+
Detectors:
|
|
29
|
+
1. **GitHub Actions**: scan `.github/workflows/*.yml` — extract job names, triggers, WP-specific steps
|
|
30
|
+
2. **GitLab CI**: scan `.gitlab-ci.yml` — extract stages, WP-specific jobs
|
|
31
|
+
3. **Bitbucket Pipelines**: scan `bitbucket-pipelines.yml` — extract pipeline steps
|
|
32
|
+
4. **Quality tools**: scan for `phpstan.neon*`, `phpcs.xml*`, `.phpcs.xml*`, `playwright.config.*`, `jest.config.*`, `phpunit.xml*`
|
|
33
|
+
5. **wp-env CI readiness**: check `.wp-env.json` or `.wp-env.override.json` presence
|
|
34
|
+
|
|
35
|
+
Output JSON:
|
|
36
|
+
```json
|
|
37
|
+
{
|
|
38
|
+
"tool": "cicd_inspect",
|
|
39
|
+
"version": "1.0.0",
|
|
40
|
+
"timestamp": "...",
|
|
41
|
+
"cwd": "...",
|
|
42
|
+
"found": true,
|
|
43
|
+
"platforms": {
|
|
44
|
+
"github_actions": { "found": true, "workflows": [...], "has_wp_steps": true },
|
|
45
|
+
"gitlab_ci": { "found": false },
|
|
46
|
+
"bitbucket": { "found": false }
|
|
47
|
+
},
|
|
48
|
+
"quality_tools": {
|
|
49
|
+
"phpstan": true,
|
|
50
|
+
"phpcs": false,
|
|
51
|
+
"playwright": true,
|
|
52
|
+
"jest": true,
|
|
53
|
+
"phpunit": true
|
|
54
|
+
},
|
|
55
|
+
"wp_env_ready": true,
|
|
56
|
+
"recommendations": [...]
|
|
57
|
+
}
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Exit codes: 0 = CI config found, 1 = no CI config found.
|
|
61
|
+
|
|
62
|
+
**Step 3: Test the script**
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
node skills/wp-cicd/scripts/cicd_inspect.mjs
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Expected: exit 1 (no CI config in plugin dev dir), valid JSON output.
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
### Task 2: Create skill `wp-cicd/SKILL.md`
|
|
73
|
+
|
|
74
|
+
**Files:**
|
|
75
|
+
- Create: `skills/wp-cicd/SKILL.md`
|
|
76
|
+
|
|
77
|
+
**Step 1: Write the SKILL.md**
|
|
78
|
+
|
|
79
|
+
Structure (follow `wp-multisite/SKILL.md` pattern):
|
|
80
|
+
|
|
81
|
+
```yaml
|
|
82
|
+
---
|
|
83
|
+
name: wp-cicd
|
|
84
|
+
description: |
|
|
85
|
+
This skill should be used when the user asks about "CI/CD", "pipeline",
|
|
86
|
+
"GitHub Actions", "GitLab CI", "Bitbucket Pipelines", "deploy automation",
|
|
87
|
+
"quality gates", "continuous integration", or WordPress CI/CD workflows.
|
|
88
|
+
version: 1.0.0
|
|
89
|
+
source: "vinmor/wordpress-manager"
|
|
90
|
+
---
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Sections:
|
|
94
|
+
- **Overview**: CI/CD pipeline management for WordPress — multi-platform (GitHub Actions, GitLab CI, Bitbucket Pipelines)
|
|
95
|
+
- **When to Use**: CI setup, pipeline generation, quality gates, automated deploy, secrets management
|
|
96
|
+
- **Detection**: run `cicd_inspect.mjs`
|
|
97
|
+
- **CI/CD Decision Tree**:
|
|
98
|
+
1. Which platform? → route to platform-specific reference
|
|
99
|
+
2. What stage? → lint → test → build → deploy
|
|
100
|
+
3. Quality gates? → PHPStan, PHPCS, coverage thresholds
|
|
101
|
+
4. Deploy strategy? → blue-green, rolling, manual approval
|
|
102
|
+
- **Recommended Agent**: `wp-cicd-engineer`
|
|
103
|
+
- **Reference Files**: list all 7
|
|
104
|
+
- **Related Skills**: wp-e2e-testing (test stage), wp-deploy (deploy stage), wp-phpstan (quality gate)
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
### Task 3: Create 7 reference files
|
|
109
|
+
|
|
110
|
+
**Files:**
|
|
111
|
+
- Create: `skills/wp-cicd/references/github-actions-wordpress.md`
|
|
112
|
+
- Create: `skills/wp-cicd/references/gitlab-ci-wordpress.md`
|
|
113
|
+
- Create: `skills/wp-cicd/references/bitbucket-pipelines-wordpress.md`
|
|
114
|
+
- Create: `skills/wp-cicd/references/wp-env-ci.md`
|
|
115
|
+
- Create: `skills/wp-cicd/references/deploy-strategies.md`
|
|
116
|
+
- Create: `skills/wp-cicd/references/secrets-management.md`
|
|
117
|
+
- Create: `skills/wp-cicd/references/quality-gates.md`
|
|
118
|
+
|
|
119
|
+
**Step 1: Write all 7 reference files in parallel**
|
|
120
|
+
|
|
121
|
+
Each ~80-120 lines, actionable content with YAML/code examples.
|
|
122
|
+
|
|
123
|
+
#### github-actions-wordpress.md
|
|
124
|
+
- Complete workflow template for WP plugin/theme
|
|
125
|
+
- Matrix: PHP 7.4/8.0/8.2/8.3, WP latest/nightly
|
|
126
|
+
- Jobs: lint (PHPCS), static analysis (PHPStan), unit test (PHPUnit), E2E (Playwright + wp-env), deploy
|
|
127
|
+
- Caching: composer, npm, wp-env Docker images
|
|
128
|
+
- Artifact upload: test reports, screenshots
|
|
129
|
+
|
|
130
|
+
#### gitlab-ci-wordpress.md
|
|
131
|
+
- Multi-stage pipeline: `.pre` → lint → test → build → deploy
|
|
132
|
+
- Docker-in-Docker for wp-env
|
|
133
|
+
- Caching strategy
|
|
134
|
+
- Environment-based deploy (staging → production)
|
|
135
|
+
|
|
136
|
+
#### bitbucket-pipelines-wordpress.md
|
|
137
|
+
- Step-based pipeline with parallel steps
|
|
138
|
+
- Docker service for MySQL
|
|
139
|
+
- Deployment integration (SSH deploy pipe)
|
|
140
|
+
- Caching configuration
|
|
141
|
+
|
|
142
|
+
#### wp-env-ci.md
|
|
143
|
+
- Starting wp-env in CI (Docker-in-Docker or service)
|
|
144
|
+
- Port configuration and healthcheck
|
|
145
|
+
- Plugin/theme mounting in CI
|
|
146
|
+
- Parallel test execution
|
|
147
|
+
- Troubleshooting: Docker timeout, port conflicts
|
|
148
|
+
|
|
149
|
+
#### deploy-strategies.md
|
|
150
|
+
- Manual approval gate (GitHub environments)
|
|
151
|
+
- Blue-green: deploy to staging, verify, swap
|
|
152
|
+
- Rolling: deploy one server at a time
|
|
153
|
+
- Canary: percentage-based rollout
|
|
154
|
+
- WordPress-specific: maintenance mode during deploy, cache flush after
|
|
155
|
+
|
|
156
|
+
#### secrets-management.md
|
|
157
|
+
- GitHub Actions secrets / Dependabot secrets
|
|
158
|
+
- GitLab CI/CD variables (protected, masked)
|
|
159
|
+
- Bitbucket repository variables
|
|
160
|
+
- SSH key deployment (deploy keys)
|
|
161
|
+
- WordPress secrets: Application Password, WP_SITES_CONFIG, Hostinger API token
|
|
162
|
+
- .env handling: never commit, inject at runtime
|
|
163
|
+
|
|
164
|
+
#### quality-gates.md
|
|
165
|
+
- PHPStan: level config, baseline, fail on new errors
|
|
166
|
+
- PHPCS: WordPress coding standards
|
|
167
|
+
- Coverage thresholds: minimum %, fail if below
|
|
168
|
+
- Playwright: screenshot comparison, max failures
|
|
169
|
+
- Security scanning: composer audit, npm audit
|
|
170
|
+
- Merge/PR blocking: required status checks
|
|
171
|
+
|
|
172
|
+
---
|
|
173
|
+
|
|
174
|
+
### Task 4: Create agent `wp-cicd-engineer.md`
|
|
175
|
+
|
|
176
|
+
**Files:**
|
|
177
|
+
- Create: `agents/wp-cicd-engineer.md`
|
|
178
|
+
|
|
179
|
+
**Step 1: Write the agent file**
|
|
180
|
+
|
|
181
|
+
Follow `wp-test-engineer.md` pattern (frontmatter with examples, tools, procedures, safety rules).
|
|
182
|
+
|
|
183
|
+
```yaml
|
|
184
|
+
---
|
|
185
|
+
name: wp-cicd-engineer
|
|
186
|
+
color: cyan
|
|
187
|
+
description: |
|
|
188
|
+
Use this agent when the user needs to set up, configure, or troubleshoot CI/CD pipelines for WordPress projects. Handles GitHub Actions, GitLab CI, Bitbucket Pipelines, quality gates, and automated deployment workflows.
|
|
189
|
+
|
|
190
|
+
<example>
|
|
191
|
+
Context: User wants to set up CI for their WordPress plugin.
|
|
192
|
+
user: "Set up GitHub Actions for my WordPress plugin with PHPStan and Playwright"
|
|
193
|
+
assistant: "I'll use the wp-cicd-engineer agent to create a CI pipeline."
|
|
194
|
+
<commentary>CI setup requires detecting existing tools, generating workflow YAML, and configuring quality gates.</commentary>
|
|
195
|
+
</example>
|
|
196
|
+
|
|
197
|
+
<example>
|
|
198
|
+
Context: User's CI pipeline is failing.
|
|
199
|
+
user: "My GitHub Actions workflow fails on the Playwright step with Docker timeout"
|
|
200
|
+
assistant: "I'll use the wp-cicd-engineer agent to diagnose the CI failure."
|
|
201
|
+
<commentary>CI debugging requires understanding wp-env in Docker-in-Docker and CI-specific constraints.</commentary>
|
|
202
|
+
</example>
|
|
203
|
+
|
|
204
|
+
<example>
|
|
205
|
+
Context: User wants to add automated deployment to their pipeline.
|
|
206
|
+
user: "Add a deploy stage to my CI that deploys to Hostinger when I push to main"
|
|
207
|
+
assistant: "I'll use the wp-cicd-engineer agent to configure the deployment stage."
|
|
208
|
+
<commentary>Deploy automation requires secrets management, deployment strategy, and post-deploy verification.</commentary>
|
|
209
|
+
</example>
|
|
210
|
+
model: inherit
|
|
211
|
+
tools: Read, Grep, Glob, Bash, Write, WebFetch, WebSearch
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
Note: this agent has **Write** tool (unlike most other agents) because it generates pipeline config files.
|
|
215
|
+
|
|
216
|
+
Procedures:
|
|
217
|
+
1. **Detect existing CI** — run `cicd_inspect.mjs`, identify platform and gaps
|
|
218
|
+
2. **Generate pipeline** — create workflow YAML based on detected tools and platform
|
|
219
|
+
3. **Configure quality gates** — PHPStan level, PHPCS ruleset, coverage threshold
|
|
220
|
+
4. **Configure secrets** — guide user through secret setup (never write actual secrets)
|
|
221
|
+
5. **Configure deploy stage** — deploy strategy, environment gates, post-deploy checks
|
|
222
|
+
6. **Troubleshoot** — diagnose CI failures, Docker issues, timeout, permission errors
|
|
223
|
+
|
|
224
|
+
Safety Rules:
|
|
225
|
+
- NEVER write actual secrets or credentials to files
|
|
226
|
+
- NEVER push CI config without user review
|
|
227
|
+
- ALWAYS validate YAML syntax before suggesting commit
|
|
228
|
+
- ALWAYS use `--dry-run` for search-replace operations in CI
|
|
229
|
+
- NEVER deploy to production without explicit user approval
|
|
230
|
+
- ALWAYS recommend staging deploy first
|
|
231
|
+
|
|
232
|
+
---
|
|
233
|
+
|
|
234
|
+
### Task 5: Update router decision-tree.md
|
|
235
|
+
|
|
236
|
+
**Files:**
|
|
237
|
+
- Modify: `skills/wordpress-router/references/decision-tree.md`
|
|
238
|
+
|
|
239
|
+
**Step 1: Update header to v7**
|
|
240
|
+
|
|
241
|
+
**Step 2: Add CI/CD keywords to Step 0**
|
|
242
|
+
|
|
243
|
+
In "Keywords that indicate **development**" line, append:
|
|
244
|
+
`CI, CD, pipeline, GitHub Actions, GitLab CI, deploy automatico, workflow, quality gate`
|
|
245
|
+
|
|
246
|
+
**Step 3: Add CI/CD route to Step 2a**
|
|
247
|
+
|
|
248
|
+
After the existing headless entry, add:
|
|
249
|
+
```
|
|
250
|
+
- **CI / CD / pipeline / GitHub Actions / GitLab CI / Bitbucket Pipelines / quality gate / deploy automatico**
|
|
251
|
+
→ `wp-cicd` skill + `wp-cicd-engineer` agent
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
---
|
|
255
|
+
|
|
256
|
+
### Task 6: Add cross-references to 3 existing skills
|
|
257
|
+
|
|
258
|
+
**Files:**
|
|
259
|
+
- Modify: `skills/wp-e2e-testing/SKILL.md` (append)
|
|
260
|
+
- Modify: `skills/wp-deploy/SKILL.md` (append)
|
|
261
|
+
- Modify: `skills/wp-phpstan/SKILL.md` (append)
|
|
262
|
+
|
|
263
|
+
**Step 1: wp-e2e-testing — add CI cross-ref**
|
|
264
|
+
|
|
265
|
+
At the end of the file, after "Recommended Agent" section, add:
|
|
266
|
+
```markdown
|
|
267
|
+
|
|
268
|
+
### CI/CD Integration
|
|
269
|
+
|
|
270
|
+
For integrating WordPress tests into CI/CD pipelines (GitHub Actions, GitLab CI, Bitbucket Pipelines), see the `wp-cicd` skill and `wp-cicd-engineer` agent.
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
**Step 2: wp-deploy — add CI cross-ref**
|
|
274
|
+
|
|
275
|
+
At the end of the file, add:
|
|
276
|
+
```markdown
|
|
277
|
+
|
|
278
|
+
### Automated Deployment
|
|
279
|
+
|
|
280
|
+
For automated deployments via CI/CD pipelines, see the `wp-cicd` skill and `wp-cicd-engineer` agent.
|
|
281
|
+
```
|
|
282
|
+
|
|
283
|
+
**Step 3: wp-phpstan — add CI cross-ref**
|
|
284
|
+
|
|
285
|
+
At the end of the file, add:
|
|
286
|
+
```markdown
|
|
287
|
+
|
|
288
|
+
### CI/CD Quality Gates
|
|
289
|
+
|
|
290
|
+
For integrating PHPStan as a quality gate in CI/CD pipelines, see the `wp-cicd` skill (`references/quality-gates.md`).
|
|
291
|
+
```
|
|
292
|
+
|
|
293
|
+
---
|
|
294
|
+
|
|
295
|
+
### Task 7: Update wp-site-manager delegation table
|
|
296
|
+
|
|
297
|
+
**Files:**
|
|
298
|
+
- Modify: `agents/wp-site-manager.md`
|
|
299
|
+
|
|
300
|
+
**Step 1: Add CI/CD row to delegation table**
|
|
301
|
+
|
|
302
|
+
After the "Multisite network management" row, add:
|
|
303
|
+
```
|
|
304
|
+
| CI/CD pipeline setup and troubleshooting | `wp-cicd-engineer` | GitHub Actions, GitLab CI, Bitbucket, quality gates |
|
|
305
|
+
```
|
|
306
|
+
|
|
307
|
+
---
|
|
308
|
+
|
|
309
|
+
### Task 8: Version bump + CHANGELOG
|
|
310
|
+
|
|
311
|
+
**Files:**
|
|
312
|
+
- Modify: `.claude-plugin/plugin.json` (1.9.0 → 2.0.0)
|
|
313
|
+
- Modify: `package.json` (1.9.0 → 2.0.0)
|
|
314
|
+
- Modify: `CHANGELOG.md` (add v2.0.0 entry)
|
|
315
|
+
|
|
316
|
+
**Step 1: Update plugin.json**
|
|
317
|
+
|
|
318
|
+
- Version: `1.9.0` → `2.0.0`
|
|
319
|
+
- Description: update to mention 10 agents, 27 skills, CI/CD
|
|
320
|
+
- Keywords: add `ci-cd`, `github-actions`
|
|
321
|
+
|
|
322
|
+
**Step 2: Update package.json**
|
|
323
|
+
|
|
324
|
+
- Version: `1.9.0` → `2.0.0`
|
|
325
|
+
- Description: update to mention CI/CD, 10 agents, 27 skills
|
|
326
|
+
- Keywords: add `ci-cd`, `github-actions`, `gitlab-ci`
|
|
327
|
+
|
|
328
|
+
**Step 3: Add CHANGELOG entry**
|
|
329
|
+
|
|
330
|
+
```markdown
|
|
331
|
+
## [2.0.0] - 2026-02-28
|
|
332
|
+
|
|
333
|
+
### Added
|
|
334
|
+
- **CI/CD support** — new skill and agent for WordPress pipeline automation
|
|
335
|
+
- **New skill**: `wp-cicd` with 7 reference files (GitHub Actions, GitLab CI, Bitbucket, wp-env CI, deploy strategies, secrets, quality gates)
|
|
336
|
+
- **New agent**: `wp-cicd-engineer` (color: cyan) — pipeline generation, quality gates, deploy automation, CI troubleshooting
|
|
337
|
+
- **Detection script**: `cicd_inspect.mjs` — detects CI platforms, quality tools, wp-env readiness
|
|
338
|
+
|
|
339
|
+
### Changed
|
|
340
|
+
- Router decision-tree.md upgraded to v7 with CI/CD keywords and routing
|
|
341
|
+
- `wp-e2e-testing`, `wp-deploy`, `wp-phpstan` skills: added CI/CD cross-references
|
|
342
|
+
- `wp-site-manager` agent: added CI/CD delegation row
|
|
343
|
+
- Plugin now has 10 agents and 27 skills
|
|
344
|
+
```
|
|
345
|
+
|
|
346
|
+
---
|
|
347
|
+
|
|
348
|
+
## Implementation Order
|
|
349
|
+
|
|
350
|
+
```
|
|
351
|
+
Phase 1 — Core (sequential):
|
|
352
|
+
Task 1: cicd_inspect.mjs (detection script)
|
|
353
|
+
Task 2: wp-cicd/SKILL.md (skill)
|
|
354
|
+
Task 3: 7 reference files (parallelizable)
|
|
355
|
+
|
|
356
|
+
Phase 2 — Agent:
|
|
357
|
+
Task 4: wp-cicd-engineer.md
|
|
358
|
+
|
|
359
|
+
Phase 3 — Integration (parallelizable):
|
|
360
|
+
Task 5: Router update (decision-tree.md v7)
|
|
361
|
+
Task 6: Cross-references (3 skills)
|
|
362
|
+
Task 7: wp-site-manager delegation
|
|
363
|
+
|
|
364
|
+
Phase 4 — Release:
|
|
365
|
+
Task 8: Version bump + CHANGELOG
|
|
366
|
+
```
|
|
367
|
+
|
|
368
|
+
## Verification
|
|
369
|
+
|
|
370
|
+
- `cicd_inspect.mjs` runs without errors (exit 1 in plugin dev dir)
|
|
371
|
+
- All new files have valid structure
|
|
372
|
+
- Router v7 routes CI/CD keywords correctly
|
|
373
|
+
- Cross-references are bidirectional: skill → agent, agent → skill
|
|
374
|
+
- Delegation table in wp-site-manager has CI/CD row
|
|
375
|
+
- Version 2.0.0 across plugin.json, package.json, CHANGELOG
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "claude-plugin-wordpress-manager",
|
|
3
|
-
"version": "
|
|
4
|
-
"description": "Unified WordPress management and development plugin for Claude Code. Orchestrates Hostinger MCP, WP REST API bridge (81 tools incl. 30 WooCommerce + 10 Multisite), and WordPress.com MCP with
|
|
3
|
+
"version": "2.0.0",
|
|
4
|
+
"description": "Unified WordPress management and development plugin for Claude Code. Orchestrates Hostinger MCP, WP REST API bridge (81 tools incl. 30 WooCommerce + 10 Multisite), and WordPress.com MCP with 27 skills, 10 agents, and security hooks. v2.0.0 adds CI/CD pipeline automation: GitHub Actions, GitLab CI, Bitbucket Pipelines, quality gates, deploy strategies, secrets management.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "vinmor",
|
|
7
7
|
"email": "morreale.v@gmail.com"
|
|
@@ -27,7 +27,10 @@
|
|
|
27
27
|
"ecommerce",
|
|
28
28
|
"shop",
|
|
29
29
|
"multisite",
|
|
30
|
-
"network"
|
|
30
|
+
"network",
|
|
31
|
+
"ci-cd",
|
|
32
|
+
"github-actions",
|
|
33
|
+
"gitlab-ci"
|
|
31
34
|
],
|
|
32
35
|
"repository": {
|
|
33
36
|
"type": "git",
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Router decision tree (
|
|
1
|
+
# Router decision tree (v7 — development + local environment + operations + multisite + CI/CD)
|
|
2
2
|
|
|
3
3
|
This routing guide covers WordPress **development**, **local environment**, and **operations** workflows.
|
|
4
4
|
|
|
@@ -17,7 +17,7 @@ Keywords that indicate **operations**:
|
|
|
17
17
|
deploy, push to production, audit, security check, backup, restore, migrate, move site, create post, manage content, site status, check plugins, performance check, SEO audit, WooCommerce, prodotto, ordine, coupon, negozio, catalogo, inventario, vendite, carrello, multisite, network, sub-site, sub-sito, domain mapping, super admin, network activate
|
|
18
18
|
|
|
19
19
|
Keywords that indicate **development**:
|
|
20
|
-
create block, block.json, theme.json, register_rest_route, plugin development, hooks, PHPStan, build, test, scaffold, i18n, translation, accessibility, a11y, headless, decoupled, WPGraphQL
|
|
20
|
+
create block, block.json, theme.json, register_rest_route, plugin development, hooks, PHPStan, build, test, scaffold, i18n, translation, accessibility, a11y, headless, decoupled, WPGraphQL, CI, CD, pipeline, GitHub Actions, GitLab CI, deploy automatico, workflow, quality gate
|
|
21
21
|
|
|
22
22
|
## Step 1: classify repo kind (from triage — development only)
|
|
23
23
|
|
|
@@ -65,6 +65,8 @@ Priority: `gutenberg` > `wp-core` > `wp-site` > `wp-block-theme` > `wp-block-plu
|
|
|
65
65
|
→ `wp-accessibility` skill + `wp-accessibility-auditor` agent
|
|
66
66
|
- **Headless / decoupled / WPGraphQL / Next.js / Nuxt / Astro / Gatsby / CORS / ISR / SSG / frontend integration**
|
|
67
67
|
→ `wp-headless`
|
|
68
|
+
- **CI / CD / pipeline / GitHub Actions / GitLab CI / Bitbucket Pipelines / quality gate / deploy automatico / continuous integration**
|
|
69
|
+
→ `wp-cicd` skill + `wp-cicd-engineer` agent
|
|
68
70
|
|
|
69
71
|
## Step 2b: route by operational intent (keywords)
|
|
70
72
|
|