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.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "wordpress-manager",
3
- "version": "1.9.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 9 specialized agents, 26 skills, and security hooks. Includes 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.",
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": "1.9.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 26 skills, 9 agents, and security hooks. v1.9.0 adds WordPress Multisite network management via WP-CLI: sub-site CRUD, network plugins, Super Admin, domain mapping.",
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 (v6 — development + local environment + operations + multisite)
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