claude-plugin-wordpress-manager 2.1.0 → 2.2.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.
Files changed (33) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/CHANGELOG.md +30 -0
  3. package/agents/wp-content-strategist.md +30 -0
  4. package/agents/wp-monitoring-agent.md +50 -0
  5. package/docs/GUIDE.md +249 -15
  6. package/docs/plans/2026-02-28-wcop-strategic-assessment.md +220 -0
  7. package/hooks/hooks.json +9 -0
  8. package/package.json +6 -3
  9. package/servers/wp-rest-bridge/build/tools/index.d.ts +119 -0
  10. package/servers/wp-rest-bridge/build/tools/index.js +3 -0
  11. package/servers/wp-rest-bridge/build/tools/wc-webhooks.d.ts +129 -0
  12. package/servers/wp-rest-bridge/build/tools/wc-webhooks.js +142 -0
  13. package/servers/wp-rest-bridge/build/types.d.ts +12 -0
  14. package/skills/wordpress-router/references/decision-tree.md +7 -3
  15. package/skills/wp-content/SKILL.md +3 -0
  16. package/skills/wp-content-repurposing/SKILL.md +96 -0
  17. package/skills/wp-content-repurposing/references/content-atomization.md +117 -0
  18. package/skills/wp-content-repurposing/references/email-newsletter.md +136 -0
  19. package/skills/wp-content-repurposing/references/platform-specs.md +80 -0
  20. package/skills/wp-content-repurposing/references/social-formats.md +169 -0
  21. package/skills/wp-content-repurposing/scripts/repurposing_inspect.mjs +140 -0
  22. package/skills/wp-headless/SKILL.md +1 -0
  23. package/skills/wp-monitoring/SKILL.md +12 -2
  24. package/skills/wp-monitoring/references/fleet-monitoring.md +160 -0
  25. package/skills/wp-monitoring/scripts/monitoring_inspect.mjs +54 -1
  26. package/skills/wp-webhooks/SKILL.md +107 -0
  27. package/skills/wp-webhooks/references/integration-recipes.md +176 -0
  28. package/skills/wp-webhooks/references/payload-formats.md +134 -0
  29. package/skills/wp-webhooks/references/webhook-security.md +147 -0
  30. package/skills/wp-webhooks/references/woocommerce-webhooks.md +129 -0
  31. package/skills/wp-webhooks/references/wordpress-core-webhooks.md +162 -0
  32. package/skills/wp-webhooks/scripts/webhook_inspect.mjs +157 -0
  33. package/skills/wp-woocommerce/SKILL.md +1 -0
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "wordpress-manager",
3
- "version": "2.1.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 11 specialized agents, 28 skills, and security hooks. Includes site monitoring (uptime, performance baseline, security scanning, content integrity, alerting), CI/CD pipeline automation (GitHub Actions, GitLab CI, Bitbucket), WordPress Multisite network management, WooCommerce store management, local dev environment support, development, testing, security, i18n, accessibility, headless, and operations.",
3
+ "version": "2.2.0",
4
+ "description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (85 tools incl. WooCommerce + Multisite + Webhooks), and WordPress.com MCP (hosted sites) with 11 specialized agents, 30 skills, and security hooks. Includes fleet monitoring, content repurposing, webhook propagation, site monitoring (uptime, performance baseline, security scanning, content integrity, alerting), CI/CD pipeline automation (GitHub Actions, GitLab CI, Bitbucket), WordPress Multisite network management, WooCommerce store management, 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"
package/CHANGELOG.md CHANGED
@@ -2,6 +2,36 @@
2
2
 
3
3
  All notable changes to the WordPress Manager plugin for Claude Code.
4
4
 
5
+ ## [2.2.0] - 2026-02-28
6
+
7
+ ### Added
8
+ - **Fleet monitoring** — cross-site health assessment for all configured WordPress sites
9
+ - New reference file: `skills/wp-monitoring/references/fleet-monitoring.md` (fleet iteration, cross-site patterns, fleet baselines, site grouping, scheduling, P0 escalation)
10
+ - Detection script updated: `detectFleetConfiguration()` checks WP_SITES_CONFIG and sites.json for multi-site fleet
11
+ - Agent updated: Procedure 7 (Fleet Monitoring) + Fleet Report Template in `wp-monitoring-agent`
12
+
13
+ - **Content repurposing skill** (`wp-content-repurposing`) — transform WordPress content into multi-channel outputs
14
+ - 4 reference files: social-formats (Twitter/LinkedIn/Instagram/Facebook templates), email-newsletter (digest/drip/subject lines), content-atomization (pillar→atoms workflow, repurposing matrix), platform-specs (character limits, image dimensions, posting frequency)
15
+ - Detection script: `repurposing_inspect.mjs` — detects social plugins, email plugins, content volume
16
+ - Agent updated: `wp-content-strategist` now includes Content Repurposing Workflow and repurposing example
17
+
18
+ - **Webhook propagation skill** (`wp-webhooks`) — WordPress outbound webhook configuration and management
19
+ - 5 reference files: woocommerce-webhooks (API, topics, MCP tools), wordpress-core-webhooks (mu-plugin, action hooks), integration-recipes (Zapier/Make/n8n/Slack/CDN), payload-formats (JSON payloads, WC examples), webhook-security (HMAC-SHA256, signatures, rate limiting)
20
+ - Detection script: `webhook_inspect.mjs` — detects WC webhooks, mu-plugin webhooks, webhook plugins, wp-config constants
21
+ - 4 new MCP tools via WP REST Bridge: `wc_list_webhooks`, `wc_create_webhook`, `wc_update_webhook`, `wc_delete_webhook`
22
+ - `WCWebhook` TypeScript interface added to types.ts
23
+ - Safety hook for `wc_delete_webhook` (PreToolUse prompt confirmation)
24
+
25
+ ### Changed
26
+ - Router decision-tree.md upgraded to v9 with fleet, webhook, and content repurposing keywords and routing
27
+ - Cross-references added: `wp-content` → wp-content-repurposing, `wp-headless` → wp-webhooks, `wp-woocommerce` → wp-webhooks
28
+ - Plugin now has 30 skills, 11 agents, and 85 MCP tools
29
+
30
+ ## [2.1.1] - 2026-02-28
31
+
32
+ ### Changed
33
+ - **GUIDE.md**: aggiornamento completo da v1.7.1 a v2.1.0 — documenta WooCommerce, Multisite, CI/CD, Monitoring (11 agent, 28 skill, 81 tool, 16 script, router v8, 16 scenari, +13 termini glossario)
34
+
5
35
  ## [2.1.0] - 2026-02-28
6
36
 
7
37
  ### Added
@@ -24,6 +24,13 @@ description: |
24
24
  assistant: "I'll use the wp-content-strategist agent to set up the taxonomy structure."
25
25
  <commentary>Taxonomy design impacts content architecture and SEO.</commentary>
26
26
  </example>
27
+
28
+ <example>
29
+ Context: User wants to repurpose blog content for social media.
30
+ user: "Turn my latest blog posts into social media content"
31
+ assistant: "I'll use the wp-content-strategist agent to extract key insights from your posts and generate platform-specific social content."
32
+ <commentary>Content repurposing requires selecting source content and applying platform templates.</commentary>
33
+ </example>
27
34
  model: inherit
28
35
  tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
29
36
  ---
@@ -147,6 +154,28 @@ Excerpt: [Meta description with keyword, under 160 chars]
147
154
  - ALWAYS preserve existing SEO-optimized slugs when updating content
148
155
  - ALWAYS check for duplicate slugs before creating new content
149
156
 
157
+ ## Content Repurposing Workflow
158
+
159
+ When repurposing existing WordPress content into multi-channel formats:
160
+
161
+ 1. **Select source content**: Use `list_content` to find recent/popular posts
162
+ - Filter by `orderby: "date"` for recent or by popularity metrics
163
+ - Prioritize evergreen content with broad appeal
164
+ 2. **Extract key elements** from source post:
165
+ - Headline and hook
166
+ - 3-5 key insights or data points
167
+ - Quotable passages
168
+ - Statistics or results
169
+ - Call to action
170
+ 3. **Apply platform templates** from `wp-content-repurposing` skill:
171
+ - Social formats: `references/social-formats.md`
172
+ - Email newsletter: `references/email-newsletter.md`
173
+ - Atomization: `references/content-atomization.md`
174
+ 4. **Generate formatted outputs** per target channel
175
+ 5. **Present all variants** to user for review before distribution
176
+
177
+ See the `wp-content-repurposing` skill for detailed templates and platform specifications.
178
+
150
179
  ## Multilingual Content
151
180
 
152
181
  When creating content for multilingual sites:
@@ -164,3 +193,4 @@ When creating content for multilingual sites:
164
193
 
165
194
  - **`wp-content` skill** — content lifecycle management, editorial workflows
166
195
  - **`wp-i18n` skill** — internationalization and localization procedures
196
+ - **`wp-content-repurposing` skill** — content transformation for multi-channel distribution
@@ -24,6 +24,13 @@ description: |
24
24
  assistant: "I'll use the wp-monitoring-agent to analyze performance metrics and compare with the baseline."
25
25
  <commentary>Performance trend analysis requires collecting current metrics and comparing with historical data.</commentary>
26
26
  </example>
27
+
28
+ <example>
29
+ Context: User wants to check all their WordPress sites at once.
30
+ user: "Run a health check across all my sites"
31
+ assistant: "I'll use the wp-monitoring-agent to perform a fleet-wide health assessment across all configured sites."
32
+ <commentary>Fleet monitoring requires iterating over all configured sites and aggregating findings.</commentary>
33
+ </example>
27
34
  model: inherit
28
35
  tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
29
36
  ---
@@ -109,6 +116,23 @@ Run a full assessment to create a monitoring baseline:
109
116
  4. Check robots.txt via WebFetch: verify no unexpected rules
110
117
  5. Report content changes, spam levels, and SEO health
111
118
 
119
+ ### Procedure 7: Fleet Monitoring
120
+
121
+ Run health assessments across all configured sites and generate a fleet-wide comparison:
122
+
123
+ 1. **Enumerate sites**: Use `list_sites` to get all configured sites
124
+ 2. **Iterate**: For each site:
125
+ a. `switch_site` to target the site
126
+ b. Run Procedures 3-6 (uptime, performance, security, content)
127
+ c. Record per-site metrics and findings
128
+ 3. **Aggregate**: Combine per-site results into a fleet comparison table
129
+ 4. **Cross-site pattern detection**:
130
+ - Same plugin vulnerability across multiple sites
131
+ - Correlated performance degradation (shared hosting, CDN issue)
132
+ - Identical outdated WordPress core versions
133
+ - Common configuration drift from baselines
134
+ 5. **Generate fleet report** (see Fleet Report template below)
135
+
112
136
  ## Report Generation
113
137
 
114
138
  After completing relevant procedures, generate a report following the templates in `references/reporting-templates.md`:
@@ -155,6 +179,31 @@ After completing relevant procedures, generate a report following the templates
155
179
  3. [Third priority]
156
180
  ```
157
181
 
182
+ ### Fleet Report Template
183
+
184
+ ```
185
+ ## Fleet Health Report
186
+ **Date:** [date] | **Sites:** [count] | **Scope:** [full / quick]
187
+
188
+ ### Fleet Overview
189
+ | Site | Uptime | Performance | Security | Content | Overall |
190
+ |------|--------|-------------|----------|---------|---------|
191
+ | [site-1] | [✅/⚠️/❌] | [✅/⚠️/❌] | [✅/⚠️/❌] | [✅/⚠️/❌] | [✅/⚠️/❌] |
192
+ | [site-2] | [✅/⚠️/❌] | [✅/⚠️/❌] | [✅/⚠️/❌] | [✅/⚠️/❌] | [✅/⚠️/❌] |
193
+
194
+ ### Fleet Summary
195
+ - **Healthy sites:** X/N
196
+ - **Degraded sites:** X/N (list)
197
+ - **Critical sites:** X/N (list)
198
+
199
+ ### Cross-Site Patterns
200
+ [findings or "No cross-site patterns detected"]
201
+
202
+ ### Fleet Recommendations (Priority Order)
203
+ 1. [Fleet-wide action]
204
+ 2. [Site-specific action]
205
+ ```
206
+
158
207
  ## Safety Rules
159
208
 
160
209
  - **NEVER modify any site data** — this agent is strictly read-only
@@ -175,6 +224,7 @@ For issues found during monitoring:
175
224
  | Content or SEO issues | `wp-content-strategist` agent |
176
225
  | Plugin/deployment issues | `wp-deployment-engineer` agent |
177
226
  | Infrastructure/hosting issues | `wp-site-manager` agent |
227
+ | Fleet-wide infrastructure issue | `wp-site-manager` agent (multi-site coordination) |
178
228
 
179
229
  ## Related Skills
180
230
 
package/docs/GUIDE.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # WordPress Manager - Guida Completa per Utenti e Amministratori
2
2
 
3
- **Versione:** 1.7.1
3
+ **Versione:** 2.1.0
4
4
  **Ultimo aggiornamento:** 2026-02-28
5
5
  **Repository:** https://github.com/morrealev/wordpress-manager
6
6
 
@@ -53,6 +53,10 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
53
53
  - **Audit accessibilita**: WCAG 2.2 AA, axe-core, pa11y, Lighthouse
54
54
  - **Internazionalizzare**: PHP/JS gettext, .pot/.po/.mo workflow, RTL, WPML/Polylang
55
55
  - **Architetture headless**: REST vs WPGraphQL, JWT auth, CORS, Next.js/Nuxt/Astro
56
+ - **Gestire WooCommerce**: prodotti, ordini, clienti, coupon, report vendite, configurazione store
57
+ - **Amministrare Multisite**: sub-site, network plugin, Super Admin, domain mapping
58
+ - **Configurare CI/CD**: GitHub Actions, GitLab CI, Bitbucket Pipelines, quality gates, deploy automatico
59
+ - **Monitorare siti**: uptime, performance baseline, security scanning, content integrity, alerting
56
60
 
57
61
  ### Requisiti
58
62
 
@@ -76,7 +80,7 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
76
80
  wordpress-manager plugin
77
81
  / | \
78
82
  Hostinger MCP WP REST Bridge WordPress.com MCP
79
- (119 tool) (40 tool) (~15 tool)
83
+ (119 tool) (81 tool) (~15 tool)
80
84
  | | |
81
85
  Infrastruttura Contenuti + Siti hosted
82
86
  DNS, SSL, VPS Plugin, Utenti su WordPress.com
@@ -89,12 +93,12 @@ WordPress Manager e un plugin per **Claude Code** (la CLI ufficiale di Anthropic
89
93
  ### Componenti del Plugin
90
94
 
91
95
  ```
92
- wordpress-manager/ # v1.7.1
96
+ wordpress-manager/ # v2.1.0
93
97
  +-- .claude-plugin/plugin.json # Manifest
94
98
  +-- .mcp.json # Server MCP bundled
95
99
  +-- LICENSE # MIT + GPL-2.0-or-later
96
100
  +-- CHANGELOG.md # Cronologia versioni
97
- +-- agents/ # 8 agenti specializzati
101
+ +-- agents/ # 11 agenti specializzati
98
102
  | +-- wp-site-manager.md # Orchestratore centrale
99
103
  | +-- wp-deployment-engineer.md # Specialista deploy
100
104
  | +-- wp-content-strategist.md # Contenuti e SEO
@@ -103,9 +107,12 @@ wordpress-manager/ # v1.7.1
103
107
  | +-- wp-performance-optimizer.md # Performance e CWV
104
108
  | +-- wp-test-engineer.md # Testing (E2E, unit, integration)
105
109
  | +-- wp-accessibility-auditor.md # WCAG 2.2 AA audit (read-only)
110
+ | +-- wp-ecommerce-manager.md # WooCommerce store management (v1.8.0)
111
+ | +-- wp-cicd-engineer.md # CI/CD pipeline specialist (v2.0.0)
112
+ | +-- wp-monitoring-agent.md # Site monitoring read-only (v2.1.0)
106
113
  +-- commands/ # 5 slash commands
107
114
  | +-- wp-status.md / wp-deploy.md / wp-audit.md / wp-backup.md / wp-setup.md
108
- +-- skills/ # 24 skill totali
115
+ +-- skills/ # 28 skill totali
109
116
  | +-- [OPERATIVE - 5 skill]
110
117
  | +-- wp-deploy/ # Procedure deploy
111
118
  | +-- wp-audit/ # Checklist audit
@@ -115,7 +122,7 @@ wordpress-manager/ # v1.7.1
115
122
  | +-- [AMBIENTE LOCALE - 1 skill]
116
123
  | +-- wp-local-env/ # Studio/LocalWP/wp-env
117
124
  | +-- [SVILUPPO - 13 skill da WordPress/agent-skills]
118
- | +-- wordpress-router/ # Router unificato v4 (dev + local + ops)
125
+ | +-- wordpress-router/ # Router unificato v8 (dev + local + ops + multisite + cicd + monitoring)
119
126
  | +-- wp-project-triage/ # Auto-detect tipo progetto
120
127
  | +-- wp-block-development/ # Blocchi Gutenberg
121
128
  | +-- wp-block-themes/ # Temi a blocchi
@@ -134,6 +141,11 @@ wordpress-manager/ # v1.7.1
134
141
  | +-- wp-i18n/ # Internazionalizzazione
135
142
  | +-- wp-accessibility/ # WCAG 2.2 accessibilita
136
143
  | +-- wp-headless/ # Architettura headless/decoupled
144
+ | +-- [E-COMMERCE + INFRASTRUTTURA - 4 skill]
145
+ | +-- wp-woocommerce/ # WooCommerce store management (v1.8.0)
146
+ | +-- wp-multisite/ # Multisite network management (v1.9.0)
147
+ | +-- wp-cicd/ # CI/CD pipeline automation (v2.0.0)
148
+ | +-- wp-monitoring/ # Site monitoring e observability (v2.1.0)
137
149
  +-- hooks/ # 6 hook di sicurezza
138
150
  | +-- hooks.json # 4 prompt + 2 command
139
151
  | +-- scripts/ # Script per hook command-type
@@ -313,6 +325,10 @@ WordPress Manager comprende richieste in linguaggio naturale. Ecco come formular
313
325
  | Audit accessibilita | "Controlla l'accessibilita" / "WCAG audit" |
314
326
  | Internazionalizzare | "Internazionalizza il plugin" / "Traduci il tema" |
315
327
  | Setup headless | "WordPress headless con Next.js" / "Configura WPGraphQL" |
328
+ | Gestire WooCommerce | "Mostra gli ordini" / "Crea un prodotto" / "Report vendite" |
329
+ | Amministrare Multisite | "Crea un sub-site" / "Network activate plugin" / "Super Admin" |
330
+ | Configurare CI/CD | "Setup GitHub Actions" / "CI per il mio plugin" / "Deploy automatico" |
331
+ | Monitorare il sito | "Monitora il sito" / "Health report" / "Setup uptime check" |
316
332
 
317
333
  ---
318
334
 
@@ -476,7 +492,7 @@ I comandi slash sono scorciatoie dirette per operazioni specifiche. Si invocano
476
492
 
477
493
  Gli agenti sono "personalita" specializzate di Claude che vengono attivate automaticamente in base al contesto della conversazione. Non devi invocarli manualmente - Claude sceglie l'agente giusto per il compito.
478
494
 
479
- Il plugin include **8 agenti** organizzati per area di competenza. Alcuni agenti lavorano in coppia (audit → fix).
495
+ Il plugin include **11 agenti** organizzati per area di competenza. Alcuni agenti lavorano in coppia (audit → fix) o in modalita read-only (monitoraggio).
480
496
 
481
497
  ### wp-site-manager (Orchestratore)
482
498
 
@@ -697,14 +713,101 @@ Complementa `wp-security-auditor`: l'auditor **trova** i problemi, l'hardener **
697
713
 
698
714
  ---
699
715
 
716
+ ### wp-ecommerce-manager (WooCommerce)
717
+
718
+ | Proprieta | Valore |
719
+ |-----------|--------|
720
+ | Colore | Orange |
721
+ | Ruolo | Gestione completa store WooCommerce |
722
+ | Attivazione | "Mostra gli ordini", "crea un prodotto", "report vendite", "coupon", "WooCommerce" |
723
+
724
+ **Capacita** (30 tool MCP via WP REST Bridge, namespace `wc/v3`):
725
+
726
+ | Area | Tool | Operazioni |
727
+ |------|------|-----------|
728
+ | Products | 7 | CRUD prodotti, categorie, variazioni |
729
+ | Orders | 6 | Lista ordini, aggiorna stato, note, rimborsi |
730
+ | Customers | 4 | Gestione clienti, profili, cronologia |
731
+ | Coupons | 4 | Creazione coupon, marketing promozioni |
732
+ | Reports | 5 | Vendite, top seller, totali ordini/prodotti/clienti |
733
+ | Settings | 4 | Gateway pagamento, zone spedizione, tasse, system status |
734
+
735
+ **Prerequisiti**: WooCommerce attivo + Consumer Key/Secret configurati in `WP_SITES_CONFIG` (generare da WooCommerce > Settings > Advanced > REST API).
736
+
737
+ **Skill correlata**: `wp-woocommerce`
738
+
739
+ ---
740
+
741
+ ### wp-cicd-engineer (CI/CD)
742
+
743
+ | Proprieta | Valore |
744
+ |-----------|--------|
745
+ | Colore | Cyan |
746
+ | Ruolo | Setup, configurazione e debug pipeline CI/CD |
747
+ | Attivazione | "Setup GitHub Actions", "CI per il plugin", "pipeline fallisce", "deploy automatico" |
748
+
749
+ **3 piattaforme supportate**:
750
+
751
+ | Piattaforma | Config | Best for |
752
+ |-------------|--------|----------|
753
+ | GitHub Actions | `.github/workflows/*.yml` | Plugin open-source, GitHub repos |
754
+ | GitLab CI | `.gitlab-ci.yml` | Enterprise, self-hosted GitLab |
755
+ | Bitbucket Pipelines | `bitbucket-pipelines.yml` | Team Atlassian |
756
+
757
+ **Pipeline WordPress tipica**:
758
+ 1. **Lint**: PHP syntax, PHPCS code style
759
+ 2. **Static Analysis**: PHPStan livello 6+
760
+ 3. **Unit Test**: PHPUnit con WordPress test suite
761
+ 4. **E2E Test**: Playwright con wp-env in Docker
762
+ 5. **Deploy**: SSH/rsync o Hostinger MCP con rollback automatico
763
+
764
+ **Detection**: `cicd_inspect.mjs` rileva piattaforma CI, quality tool, wp-env, e genera raccomandazioni.
765
+
766
+ **Skill correlata**: `wp-cicd`
767
+
768
+ ---
769
+
770
+ ### wp-monitoring-agent (Monitoring)
771
+
772
+ | Proprieta | Valore |
773
+ |-----------|--------|
774
+ | Colore | Teal |
775
+ | Ruolo | Monitoring continuo del sito (read-only, non modifica nulla) |
776
+ | Attivazione | "Monitora il sito", "health report", "uptime check", "performance trend", "security scan periodico" |
777
+
778
+ **5 aree di monitoraggio**:
779
+
780
+ | Area | Cosa monitora |
781
+ |------|--------------|
782
+ | Uptime | HTTP status, response time, SSL expiry, WP-Cron |
783
+ | Performance | Core Web Vitals trend, TTFB, Lighthouse score |
784
+ | Security | Plugin vulnerabilita, file integrity, utenti anomali, malware patterns |
785
+ | Content | Modifiche non autorizzate, broken links, spam comments, media integrity |
786
+ | Alerting | Threshold P0-P3, notifiche email/Slack/webhook, escalation |
787
+
788
+ **Report disponibili**: Daily Health Summary, Weekly Performance, Monthly Security, Quarterly Trend, Executive Dashboard.
789
+
790
+ **Delegazione**: Quando rileva problemi, delega a agent specializzati:
791
+ - Sicurezza → `wp-security-auditor` + `wp-security-hardener`
792
+ - Performance → `wp-performance-optimizer`
793
+ - Contenuti → `wp-content-strategist`
794
+ - Deploy fix → `wp-deployment-engineer`
795
+
796
+ **Detection**: `monitoring_inspect.mjs` rileva setup monitoring esistente (uptime tools, Lighthouse CI, security plugins, logging config).
797
+
798
+ **Skill correlata**: `wp-monitoring`
799
+
800
+ ---
801
+
700
802
  ### Pattern di Collaborazione tra Agent
701
803
 
702
804
  | Pattern | Flusso | Descrizione |
703
805
  |---------|--------|-------------|
704
806
  | **Audit → Fix** | `wp-security-auditor` → `wp-security-hardener` | L'auditor trova problemi, l'hardener implementa le correzioni |
807
+ | **Monitor → Delegate** | `wp-monitoring-agent` → agent specializzati | Il monitoring rileva anomalie e delega agli agent competenti |
705
808
  | **Delegazione** | `wp-site-manager` → tutti gli altri | Il site manager delega a agent specializzati in base al task |
706
809
 
707
- Il `wp-site-manager` puo delegare a tutti gli 8 agent specializzati:
810
+ Il `wp-site-manager` puo delegare a tutti gli 11 agent specializzati:
708
811
 
709
812
  | Task | Agent delegato |
710
813
  |------|---------------|
@@ -715,6 +818,9 @@ Il `wp-site-manager` puo delegare a tutti gli 8 agent specializzati:
715
818
  | Performance, CWV | `wp-performance-optimizer` |
716
819
  | Testing | `wp-test-engineer` |
717
820
  | Accessibilita | `wp-accessibility-auditor` |
821
+ | WooCommerce, e-commerce | `wp-ecommerce-manager` |
822
+ | CI/CD pipeline | `wp-cicd-engineer` |
823
+ | Site monitoring e health reports | `wp-monitoring-agent` |
718
824
 
719
825
  ---
720
826
 
@@ -752,10 +858,11 @@ Le skill di sviluppo provengono da due fonti:
752
858
 
753
859
  - **13 skill community** integrate dal repository [WordPress/agent-skills](https://github.com/WordPress/agent-skills) (licenza GPL-2.0-or-later). Coprono blocchi, temi, plugin, endpoint REST, analisi statica, profiling e altro.
754
860
  - **5 skill estese** (MIT) aggiunte in v1.6.0: testing, security, internazionalizzazione, accessibilita, headless.
861
+ - **4 skill e-commerce + infrastruttura** (MIT) aggiunte in v1.8.0-v2.1.0: WooCommerce, Multisite, CI/CD, Monitoring.
755
862
 
756
863
  ### Il Router Unificato
757
864
 
758
- La skill `wordpress-router` (v4) e il punto d'ingresso per tutti i task WordPress. Classifica automaticamente il task in **tre categorie**: sviluppo, ambiente locale, operativo.
865
+ La skill `wordpress-router` (v8) e il punto d'ingresso per tutti i task WordPress. Classifica automaticamente il task in **sei categorie**: sviluppo, ambiente locale, operativo, multisite, CI/CD, monitoring.
759
866
 
760
867
  ```
761
868
  Utente: "Crea un blocco custom per la gallery"
@@ -791,6 +898,30 @@ wordpress-router: TASK = sviluppo (testing)
791
898
  wp-e2e-testing skill + wp-test-engineer agent
792
899
  ```
793
900
 
901
+ ```
902
+ Utente: "Mostrami gli ordini WooCommerce di questa settimana"
903
+ |
904
+ wordpress-router: TASK = operativo (e-commerce)
905
+ |
906
+ wp-woocommerce skill + wp-ecommerce-manager agent
907
+ ```
908
+
909
+ ```
910
+ Utente: "Setup GitHub Actions per il mio plugin WordPress"
911
+ |
912
+ wordpress-router: TASK = sviluppo (CI/CD)
913
+ |
914
+ wp-cicd skill + wp-cicd-engineer agent
915
+ ```
916
+
917
+ ```
918
+ Utente: "Configura il monitoring del sito con alerting"
919
+ |
920
+ wordpress-router: TASK = operativo (monitoring)
921
+ |
922
+ wp-monitoring skill + wp-monitoring-agent agent
923
+ ```
924
+
794
925
  ### Panoramica Skills di Sviluppo — Community (13)
795
926
 
796
927
  | Skill | Si attiva quando... | Risorse |
@@ -823,9 +954,20 @@ Aggiunte in v1.6.0, queste skill coprono aree avanzate dello sviluppo WordPress.
823
954
 
824
955
  **Cross-reference bidirezionali**: Le skill con agent dedicato contengono una sezione "Recommended Agent", e gli agent contengono "Related Skills". Questo garantisce che Claude attivi sia la conoscenza (skill) che l'esecutore (agent) appropriati.
825
956
 
957
+ ### Panoramica Skills E-Commerce + Infrastruttura (4)
958
+
959
+ Aggiunte in v1.8.0-v2.1.0, queste skill coprono e-commerce, multisite, CI/CD e monitoring.
960
+
961
+ | Skill | Si attiva quando... | Risorse | Agent dedicato |
962
+ |-------|---------------------|---------|----------------|
963
+ | `wp-woocommerce` | "prodotti", "ordini", "WooCommerce", "coupon", "report vendite" | 6 reference files, woocommerce_inspect.mjs | `wp-ecommerce-manager` |
964
+ | `wp-multisite` | "multisite", "sub-site", "network admin", "domain mapping" | 6 reference files, multisite_inspect.mjs | — |
965
+ | `wp-cicd` | "CI/CD", "GitHub Actions", "pipeline", "deploy automatico" | 6 reference files, cicd_inspect.mjs | `wp-cicd-engineer` |
966
+ | `wp-monitoring` | "monitora", "uptime", "health report", "alerting", "trend" | 6 reference files, monitoring_inspect.mjs | `wp-monitoring-agent` |
967
+
826
968
  ### Script di Rilevamento Automatico
827
969
 
828
- Le skill includono 12 script Node.js (`.mjs`) che eseguono analisi automatica del progetto:
970
+ Le skill includono 16 script Node.js (`.mjs`) che eseguono analisi automatica del progetto:
829
971
 
830
972
  | Script | Cosa rileva |
831
973
  |--------|-------------|
@@ -841,6 +983,10 @@ Le skill includono 12 script Node.js (`.mjs`) che eseguono analisi automatica de
841
983
  | `security_inspect.mjs` | wp-config constants, permessi file, .htaccess, plugin sicurezza (v1.6.0) |
842
984
  | `i18n_inspect.mjs` | Text domain, file .pot/.po/.mo, funzioni i18n PHP/JS (v1.6.0) |
843
985
  | `headless_inspect.mjs` | WPGraphQL, CORS config, framework frontend (v1.6.0) |
986
+ | `woocommerce_inspect.mjs` | WooCommerce attivo, API keys, prodotti, ordini, gateway (v1.8.0) |
987
+ | `multisite_inspect.mjs` | Multisite abilitato, sub-sites, network plugins, Super Admin (v1.9.0) |
988
+ | `cicd_inspect.mjs` | Piattaforme CI, quality tools, wp-env, deploy config (v2.0.0) |
989
+ | `monitoring_inspect.mjs` | Uptime tools, Lighthouse CI, security plugins, logging config (v2.1.0) |
844
990
 
845
991
  ### WordPress Playground — Ambienti Disposable
846
992
 
@@ -875,7 +1021,7 @@ Senza il server MCP, la skill usa conoscenza generale di `@wordpress/components`
875
1021
  ```
876
1022
  1. cd mio-progetto-wordpress/
877
1023
  2. Claude esegue wp-project-triage → rileva "wp-block-plugin"
878
- 3. wordpress-router v4 → instrada a wp-block-development
1024
+ 3. wordpress-router v8 → instrada a wp-block-development
879
1025
  4. Claude guida la creazione con block.json, edit.js, save.js
880
1026
  5. wp-e2e-testing + wp-test-engineer → esegue test E2E con Playwright
881
1027
  6. wp-accessibility + wp-accessibility-auditor → verifica WCAG 2.2
@@ -1009,9 +1155,9 @@ MCP (Model Context Protocol) e il protocollo che permette a Claude di comunicare
1009
1155
  | Sorgente | Custom TypeScript server in `servers/wp-rest-bridge/` |
1010
1156
  | Trasporto | stdio (JSON-RPC via stdin/stdout) |
1011
1157
  | Autenticazione | `WP_SITES_CONFIG` JSON env var |
1012
- | Tool disponibili | 40 |
1158
+ | Tool disponibili | 81 (40 WordPress + 30 WooCommerce + 11 Multisite) |
1013
1159
 
1014
- **Categorie tool**:
1160
+ **Categorie tool WordPress** (`wp/v2`):
1015
1161
 
1016
1162
  | Categoria | Tool | Esempio |
1017
1163
  |-----------|------|---------|
@@ -1024,6 +1170,26 @@ MCP (Model Context Protocol) e il protocollo che permette a Claude di comunicare
1024
1170
  | Media | 4 | `list_media`, `create_media`, `delete_media` |
1025
1171
  | WP.org | 2 | `search_plugin_repository`, `get_plugin_details` |
1026
1172
 
1173
+ **Categorie tool WooCommerce** (`wc/v3`, richiede Consumer Key/Secret):
1174
+
1175
+ | Categoria | Tool | Esempio |
1176
+ |-----------|------|---------|
1177
+ | Products | 7 | `wc_list_products`, `wc_create_product`, `wc_list_product_variations` |
1178
+ | Orders | 6 | `wc_list_orders`, `wc_update_order_status`, `wc_create_refund` |
1179
+ | Customers | 4 | `wc_list_customers`, `wc_get_customer`, `wc_update_customer` |
1180
+ | Coupons | 4 | `wc_list_coupons`, `wc_create_coupon`, `wc_delete_coupon` |
1181
+ | Reports | 5 | `wc_get_sales_report`, `wc_get_top_sellers`, `wc_get_orders_totals` |
1182
+ | Settings | 4 | `wc_list_payment_gateways`, `wc_list_shipping_zones`, `wc_get_system_status` |
1183
+
1184
+ **Categorie tool Multisite** (`ms_` prefix, richiede `is_multisite: true` + SSH/WP-CLI):
1185
+
1186
+ | Categoria | Tool | Esempio |
1187
+ |-----------|------|---------|
1188
+ | Sub-sites | 4 | `ms_list_sites`, `ms_create_site`, `ms_activate_site`, `ms_deactivate_site` |
1189
+ | Network Plugins | 3 | `ms_network_activate`, `ms_network_deactivate`, `ms_network_plugins` |
1190
+ | Admin | 2 | `ms_list_super_admins`, `ms_network_settings` |
1191
+ | DNS | 2 | `ms_domain_mapping`, `ms_site_url` |
1192
+
1027
1193
  **Architettura multi-sito**: Il server mantiene una `Map<siteId, AxiosInstance>` dove ogni sito ha la propria istanza HTTP autenticata. Il cambio sito e istantaneo.
1028
1194
 
1029
1195
  #### WordPress.com MCP
@@ -1245,7 +1411,49 @@ Claude (attiva skill wp-i18n):
1245
1411
  6. Verifica supporto RTL se necessario
1246
1412
  ```
1247
1413
 
1248
- ### Scenario 12: Architettura Headless con Next.js
1414
+ ### Scenario 12: Gestione Store WooCommerce
1415
+
1416
+ ```
1417
+ Tu: "Mostrami gli ordini di questa settimana e crea un coupon sconto 20%"
1418
+
1419
+ Claude (attiva wp-ecommerce-manager + skill wp-woocommerce):
1420
+ 1. Lista ordini con wc_list_orders (filtro ultimi 7 giorni)
1421
+ 2. Mostra riepilogo: totale ordini, revenue, status breakdown
1422
+ 3. Crea coupon con wc_create_coupon (20% sconto, tipo percentuale)
1423
+ 4. Conferma codice coupon e condizioni d'uso
1424
+ -> Report: ordini settimanali + coupon creato
1425
+ ```
1426
+
1427
+ ### Scenario 13: Setup CI/CD per Plugin WordPress
1428
+
1429
+ ```
1430
+ Tu: "Configura GitHub Actions per il mio plugin con PHPStan e Playwright"
1431
+
1432
+ Claude (attiva wp-cicd-engineer + skill wp-cicd):
1433
+ 1. Detection con cicd_inspect.mjs (rileva PHPStan, Playwright, wp-env)
1434
+ 2. Genera workflow YAML con 4 stage: lint, phpstan, phpunit, playwright
1435
+ 3. Configura wp-env per E2E testing in Docker
1436
+ 4. Imposta quality gates (coverage > 80%, PHPStan level 6)
1437
+ 5. Aggiunge deploy stage condizionale (push to main)
1438
+ -> File: .github/workflows/ci.yml creato e spiegato
1439
+ ```
1440
+
1441
+ ### Scenario 14: Monitoring Continuo del Sito
1442
+
1443
+ ```
1444
+ Tu: "Configura il monitoring completo per opencactus.com"
1445
+
1446
+ Claude (attiva wp-monitoring-agent + skill wp-monitoring):
1447
+ 1. Detection con monitoring_inspect.mjs (rileva setup esistente)
1448
+ 2. Baseline: cattura CWV attuali, TTFB, plugin count, DB size
1449
+ 3. Uptime check: configura cron per HTTP probe ogni 5 minuti
1450
+ 4. Security: schedule settimanale per plugin audit e file integrity
1451
+ 5. Alerting: configura threshold P0-P3 con notifiche email/Slack
1452
+ 6. Report template: configura Daily Health Summary + Weekly Performance
1453
+ -> Report: baseline stabilito, monitoring schedule configurato
1454
+ ```
1455
+
1456
+ ### Scenario 15: Architettura Headless con Next.js
1249
1457
 
1250
1458
  ```
1251
1459
  Tu: "Voglio usare WordPress come CMS headless con Next.js"
@@ -1259,6 +1467,20 @@ Claude (attiva skill wp-headless):
1259
1467
  6. Configura webhook per invalidazione cache
1260
1468
  ```
1261
1469
 
1470
+ ### Scenario 16: WordPress Multisite Network
1471
+
1472
+ ```
1473
+ Tu: "Crea un network multisite con 3 sub-site per i nostri brand"
1474
+
1475
+ Claude (attiva skill wp-multisite):
1476
+ 1. Detection con multisite_inspect.mjs (multisite gia abilitato?)
1477
+ 2. Se necessario, guida conversione single → multisite (wp-config.php + .htaccess)
1478
+ 3. Crea 3 sub-site con ms_create_site
1479
+ 4. Network-activate plugin comuni
1480
+ 5. Configura domain mapping per ogni sub-site
1481
+ -> Report: network configurato con 3 sub-site attivi
1482
+ ```
1483
+
1262
1484
  ---
1263
1485
 
1264
1486
  ## 14. Amministrazione Avanzata
@@ -1509,8 +1731,20 @@ bash ~/.claude/plugins/local/wordpress-manager/scripts/validate-wp-operation.sh
1509
1731
  | **RTL** | Right-to-Left — supporto per lingue scritte da destra a sinistra (arabo, ebraico) |
1510
1732
  | **WCAG** | Web Content Accessibility Guidelines — standard W3C per accessibilita web (target: 2.2 AA) |
1511
1733
  | **WPGraphQL** | Plugin WordPress che espone un'API GraphQL come alternativa alla REST API |
1734
+ | **WooCommerce** | Plugin e-commerce per WordPress; il WP REST Bridge espone 30 tool via namespace `wc/v3` |
1735
+ | **Consumer Key/Secret** | Credenziali API WooCommerce per accesso REST (`wc/v3`), generate da WooCommerce > Settings > REST API |
1736
+ | **Multisite** | Funzionalita WordPress per gestire una rete di siti da una singola installazione (Network Admin) |
1737
+ | **Super Admin** | Ruolo utente WordPress con accesso a tutte le operazioni del network multisite |
1738
+ | **Domain Mapping** | Associazione di un dominio custom a un sub-site del network multisite |
1739
+ | **CI/CD** | Continuous Integration / Continuous Deployment — pipeline automatizzate per build, test e deploy |
1740
+ | **GitHub Actions** | Piattaforma CI/CD integrata in GitHub, configurata via file YAML in `.github/workflows/` |
1741
+ | **Quality Gate** | Soglia di qualita in una pipeline CI (es. PHPStan level 6, coverage > 80%) che blocca il deploy se non superata |
1742
+ | **Monitoring** | Osservabilita continua del sito: uptime, performance trend, security scan, content integrity |
1743
+ | **Baseline** | Snapshot iniziale delle metriche (CWV, TTFB, plugin count) usato come riferimento per trend analysis |
1744
+ | **P0-P3** | Livelli di severity per alerting: P0 critico (sito down), P1 alto, P2 medio, P3 informativo |
1745
+ | **TTFB** | Time To First Byte — tempo tra la richiesta HTTP e il primo byte di risposta dal server |
1512
1746
 
1513
1747
  ---
1514
1748
 
1515
- *Guida v1.7.1 - WordPress Manager Plugin per Claude Code*
1749
+ *Guida v2.1.0 - WordPress Manager Plugin per Claude Code*
1516
1750
  *Ultimo aggiornamento: 2026-02-28*