claude-plugin-wordpress-manager 1.4.0 → 1.5.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "wordpress-manager",
-  "version": "1.4.0",
-  "description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (content), and WordPress.com MCP (hosted sites) with specialized agents, skills, and security hooks for multi-site WordPress operations.",
+  "version": "1.5.0",
+  "description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (content), and WordPress.com MCP (hosted sites) with specialized agents, skills, and security hooks for multi-site WordPress operations. Includes local dev environment support for WordPress Studio, LocalWP, and wp-env.",
   "author": {
     "name": "vinmor",
     "email": "morreale.v@gmail.com"
@@ -13,7 +13,11 @@
     "mcp",
     "deployment",
     "cms",
-    "multi-site"
+    "multi-site",
+    "local-development",
+    "wordpress-studio",
+    "localwp",
+    "wp-env"
   ],
   "mcpServers": "./.mcp.json"
 }

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to the WordPress Manager plugin for Claude Code.
 
+## [1.5.0] - 2026-02-27
+
+### Added
+- **`wp-local-env` skill** — Unified local WordPress development environment management
+  - Cross-platform detection script (`detect_local_env.mjs`) for Studio, LocalWP, wp-env
+  - 4 reference files: `studio-adapter.md`, `localwp-adapter.md`, `wpenv-adapter.md`, `mcp-adapter-setup.md`
+  - 8 procedure sections: detection, lifecycle, WP-CLI, symlink dev workflow, REST API, database ops, version switching, preview/share
+  - MCP Adapter integration guide (STDIO + HTTP transports)
+
+### Changed
+- **Router upgraded to v3** — three-category routing (development + local environment + operations)
+  - `decision-tree.md` upgraded from v2 to v3 with Step 2c for local environment routing
+  - Added local environment keywords and overlap resolution with dev/ops
+  - Added local environment guardrails
+- **`wp-wpcli-and-ops`** — Added local environment WP-CLI invocation methods (Studio/LocalWP/wp-env)
+- **`wp-deploy`** — Added "Deploying from Local Environment" section with export instructions
+- **`wp-playground`** — Added comparison table with `wp-local-env` and escalation paths
+- Version bumps: plugin.json + package.json → 1.5.0
+
 ## [1.4.0] - 2026-02-27
 
 ### Added

package/README.md

@@ -6,11 +6,11 @@ Unified WordPress management **and** development plugin that orchestrates multip
 
 ```
 wordpress-manager/
-├── .claude-plugin/plugin.json    # Plugin manifest (v1.4.0)
+├── .claude-plugin/plugin.json    # Plugin manifest (v1.5.0)
 ├── .mcp.json                     # MCP server definitions
 ├── agents/                       # 5 specialized agents
 ├── commands/                     # 5 slash commands
-├── skills/                       # 18 skills (5 operational + 13 development)
+├── skills/                       # 19 skills (5 operational + 13 development + 1 local env)
 ├── hooks/hooks.json              # 6 safety hooks (PreToolUse)
 └── servers/wp-rest-bridge/       # Custom MCP server (TypeScript)
 ```
@@ -66,13 +66,19 @@ wordpress-manager/
 | `wp-migrate` | "migrate my site", "move to Hostinger", "transfer" | hostinger-migration.md, cross-platform.md |
 | `wp-backup` | "backup my site", "create backup", "restore" | backup-strategies.md, restore-procedures.md |
 
+### Local Environment Skill (1) — managing local WordPress dev environments
+
+| Skill | Purpose | Key References |
+|-------|---------|----------------|
+| `wp-local-env` | Unified local env management: Studio, LocalWP, wp-env detection, lifecycle, WP-CLI, symlinks, DB ops | studio-adapter.md, localwp-adapter.md, wpenv-adapter.md, mcp-adapter-setup.md |
+
 ### Development Skills (13) — building WordPress projects
 
 Integrated from [WordPress/agent-skills](https://github.com/WordPress/agent-skills) (GPL-2.0-or-later).
 
 | Skill | Purpose | Key References |
 |-------|---------|----------------|
-| `wordpress-router` | Unified router: classifies tasks (dev vs ops) and routes to correct skill/agent | decision-tree.md |
+| `wordpress-router` | Unified router v3: classifies tasks (dev vs local env vs ops) and routes to correct skill/agent | decision-tree.md |
 | `wp-project-triage` | Auto-detects project type (plugin, theme, block theme, core) | detect_wp_project.mjs, triage.schema.json |
 | `wp-block-development` | Gutenberg block creation: block.json, attributes, save, edit | 10 references, list_blocks.mjs |
 | `wp-block-themes` | Block theme development: theme.json, templates, patterns | 6 references, detect_block_themes.mjs |
@@ -206,6 +212,7 @@ npx tsc              # Compile TypeScript to build/
 | 1.2.0 | Phase 3 | +3 commands (audit, backup, setup), +2 skills (migrate, backup) |
 | 1.3.0 | Phase 4 | E2E testing, utility scripts, command hooks, WordPress.com dual-mode support |
 | 1.4.0 | Phase 5 | +13 development skills from WordPress/agent-skills community repo (blocks, themes, plugins, REST API, Interactivity API, Abilities API, WP-CLI, PHPStan, Performance, Playground, WPDS, Router, Triage) |
+| 1.5.0 | Phase 6 | +1 local environment skill (`wp-local-env`): WordPress Studio, LocalWP, wp-env detection, unified management, router v3 |
 
 ## License
 

package/docs/GUIDE.md

@@ -1,6 +1,6 @@
 # WordPress Manager - Guida Completa per Utenti e Amministratori
 
-**Versione:** 1.4.0
+**Versione:** 1.5.0
 **Ultimo aggiornamento:** 2026-02-27
 **Repository:** https://github.com/morrealev/wordpress-manager
 
@@ -16,13 +16,14 @@
 6. [Agenti Specializzati](#6-agenti-specializzati)
 7. [Skills Operative - Gestione Siti Live](#7-skills-operative---gestione-siti-live)
 8. [Skills di Sviluppo - Costruire Progetti WordPress](#8-skills-di-sviluppo---costruire-progetti-wordpress)
-9. [Hook di Sicurezza](#9-hook-di-sicurezza)
-10. [MCP Server - Architettura Tecnica](#10-mcp-server---architettura-tecnica)
-11. [Gestione Multi-Sito](#11-gestione-multi-sito)
-12. [Scenari d'Uso Comuni](#12-scenari-duso-comuni)
-13. [Amministrazione Avanzata](#13-amministrazione-avanzata)
-14. [Troubleshooting](#14-troubleshooting)
-15. [Glossario](#15-glossario)
+9. [Ambienti di Sviluppo Locali](#9-ambienti-di-sviluppo-locali)
+10. [Hook di Sicurezza](#10-hook-di-sicurezza)
+11. [MCP Server - Architettura Tecnica](#11-mcp-server---architettura-tecnica)
+12. [Gestione Multi-Sito](#12-gestione-multi-sito)
+13. [Scenari d'Uso Comuni](#13-scenari-duso-comuni)
+14. [Amministrazione Avanzata](#14-amministrazione-avanzata)
+15. [Troubleshooting](#15-troubleshooting)
+16. [Glossario](#16-glossario)
 
 ---
 
@@ -696,7 +697,59 @@ Senza il server MCP, la skill usa conoscenza generale di `@wordpress/components`
 
 ---
 
-## 9. Hook di Sicurezza
+## 9. Ambienti di Sviluppo Locali
+
+La skill `wp-local-env` fornisce gestione unificata degli ambienti di sviluppo WordPress locali.
+
+### Strumenti Supportati
+
+| Strumento | Tipo | Database | CLI | Quando Usarlo |
+|-----------|------|----------|-----|---------------|
+| **WordPress Studio** | WASM (Electron) | SQLite | `studio` CLI | Setup rapido, sviluppo leggero |
+| **LocalWP** | Nativo (Electron) | MySQL | GUI only + WP-CLI bundled | Parita con produzione, multisite |
+| **wp-env** | Docker | MySQL | `npx wp-env` | CI/CD, contribuzione WordPress core |
+
+### Rilevamento Automatico
+
+```
+"Rileva i miei ambienti WordPress locali"
+```
+
+Il plugin esegue `detect_local_env.mjs` che:
+1. Cerca WordPress Studio (`studio` CLI + `~/Studio/`)
+2. Cerca LocalWP (`sites.json` + WP-CLI bundled)
+3. Cerca wp-env (`.wp-env.json` + Docker)
+4. Raccomanda lo strumento migliore per automazione
+
+### Operazioni Comuni
+
+```
+"Crea un sito locale con WordPress Studio"
+→ studio site create --path ~/Studio/mio-sito
+
+"Elenca i plugin del mio sito LocalWP"
+→ <wp-cli-bin> --path="~/Local Sites/mio-sito/app/public" plugin list
+
+"Avvia wp-env con il mio plugin"
+→ npx wp-env start
+
+"Collega il mio plugin al sito locale (symlink)"
+→ ln -s /path/to/plugin ~/Studio/mio-sito/wp-content/plugins/plugin
+
+"Esporta il database locale per il deploy"
+→ studio wp db export backup.sql --path=<sito>
+```
+
+### Reference Files
+
+- `studio-adapter.md` — CLI Studio, percorsi, SQLite, limitazioni
+- `localwp-adapter.md` — sites.json, binari bundled, MySQL, log
+- `wpenv-adapter.md` — Docker, .wp-env.json, comandi
+- `mcp-adapter-setup.md` — Configurazione MCP Adapter (STDIO + HTTP)
+
+---
+
+## 10. Hook di Sicurezza
 
 Gli hook sono guardiani automatici che intercettano operazioni pericolose prima che vengano eseguite. Funzionano senza bisogno di attivarli manualmente.
 
@@ -738,7 +791,7 @@ Se approvato -> Esecuzione hosting_importWordpressWebsite
 
 ---
 
-## 10. MCP Server - Architettura Tecnica
+## 11. MCP Server - Architettura Tecnica
 
 ### Cos'e MCP
 
@@ -795,7 +848,7 @@ MCP (Model Context Protocol) e il protocollo che permette a Claude di comunicare
 
 ---
 
-## 11. Gestione Multi-Sito
+## 12. Gestione Multi-Sito
 
 ### Configurazione
 
@@ -841,7 +894,7 @@ Il wp-site-manager agent determina automaticamente quale set di tool usare:
 
 ---
 
-## 12. Scenari d'Uso Comuni
+## 13. Scenari d'Uso Comuni
 
 ### Scenario 1: Check-up Mattutino del Sito
 
@@ -944,7 +997,7 @@ Claude (attiva wp-phpstan + wp-performance):
 
 ---
 
-## 13. Amministrazione Avanzata
+## 14. Amministrazione Avanzata
 
 ### 13.1 Personalizzare gli Hook
 
@@ -1046,7 +1099,7 @@ wp-config.php:  440 (r--r-----)
 
 ---
 
-## 14. Troubleshooting
+## 15. Troubleshooting
 
 ### Problemi di Connessione
 
@@ -1155,7 +1208,7 @@ bash ~/.claude/plugins/local/wordpress-manager/scripts/validate-wp-operation.sh
 
 ---
 
-## 15. Glossario
+## 16. Glossario
 
 | Termine | Definizione |
 |---------|------------|

package/docs/plans/2026-02-27-local-dev-tools-assessment.md

@@ -0,0 +1,332 @@
+# Assessment: Integrazione WordPress Studio + LocalWP
+
+**Data**: 2026-02-27
+**Versione plugin**: 1.4.0
+**Stato**: Approccio A approvato — design doc in `2026-02-27-local-env-design.md`
+
+---
+
+## 1. Contesto
+
+Il plugin wordpress-manager v1.4.0 copre sviluppo (13 skill) e operazioni (5 skill + 5 agent + 2 MCP server) su siti WordPress remoti e sandbox effimeri (Playground). Manca un layer per **ambienti locali persistenti** — il gap critico tra "scrivo codice" e "lo testo/deploy".
+
+WordPress Studio (by Automattic) e LocalWP (by WP Engine) sono i due strumenti principali per sviluppo WordPress locale. Questo assessment analizza le superfici di integrazione, i workflow tipici, e propone tre approcci architetturali.
+
+---
+
+## 2. Gap Analysis — Plugin attuale
+
+### Cosa il plugin GIA copre
+
+| Area | Copertura |
+|------|-----------|
+| Sviluppo codice WP | 13 skill (blocchi, temi, plugin, REST, PHPStan, Interactivity API...) |
+| Operazioni siti remoti | 5 skill + 5 agent + 2 MCP server (Hostinger + WP REST Bridge) |
+| Sandbox effimeri | `wp-playground` (WASM, @wp-playground/cli) |
+| Routing intelligente | `wordpress-router` + decision tree v2 |
+
+### Gap identificati
+
+| Gap | Dettaglio |
+|-----|-----------|
+| **Ambiente locale persistente** | Nessuna skill gestisce siti locali permanenti (non effimeri come Playground) |
+| **Discovery siti locali** | Non esiste detection di Studio (`~/Studio/`, CLI `studio`) o LocalWP (`~/Local Sites/`, `sites.json`) |
+| **WP-CLI locale** | La skill `wp-wpcli-and-ops` assume WP-CLI disponibile ma non sa come invocarlo via `studio wp` o i binari bundled di LocalWP |
+| **Ciclo dev completo** | Manca: scaffold progetto -> sviluppo locale -> test -> deploy (il deploy c'e, ma parte dal codice, non dall'ambiente locale) |
+| **MCP Adapter** | WordPress 6.9 ha il plugin MCP Adapter (STDIO + HTTP) — non integrato |
+| **Studio MCP Server** | Automattic pubblica un MCP server per Studio — non integrato |
+| **Database locale** | Nessun supporto per SQLite (Studio) o MySQL socket (LocalWP) |
+
+---
+
+## 3. WordPress Studio — Superficie di integrazione
+
+### Architettura interna
+
+- **Runtime**: Electron + WASM (PHP compilato in WebAssembly)
+- **Database**: SQLite (file: `wp-content/database/.ht.sqlite`)
+- **Web server**: Nessuno (WASM serve direttamente)
+- **Porte**: Da 8881 in su (sequenziali)
+- **Storage siti**: `~/Studio/<nome-sito>/`
+- **Config app**: `~/.config/WordPressStudio/` (Linux)
+
+### Punti di integrazione
+
+| Punto | Metodo | Automazione possibile |
+|-------|--------|----------------------|
+| **Studio CLI** | `studio site create/start/stop/list/delete` | Ciclo di vita siti completo |
+| **WP-CLI via Studio** | `studio wp <comando> --path=<sito>` | Tutto WP-CLI, senza installare WP-CLI |
+| **REST API** | `http://localhost:888x/wp-json/` | CRUD contenuti, plugin, temi |
+| **SQLite diretto** | `sqlite3 wp-content/database/.ht.sqlite` | Query raw, bulk ops |
+| **Filesystem** | `~/Studio/<sito>/wp-content/` | Sviluppo tema/plugin, symlink |
+| **Studio MCP Server** | `wordpress-agent-skills/studio-mcp/` (Node.js) | AI agent site management |
+| **MCP Adapter plugin** | `studio wp mcp-adapter serve` (STDIO) | WordPress 6.9+ come MCP server |
+| **Preview API** | `studio preview create/update/delete` | Deploy temporaneo su WordPress.com |
+
+### Punti di forza
+
+- CLI v2 eccellente, completamente scriptabile
+- MCP ecosystem maturo (Studio MCP + MCP Adapter + WordPress.com MCP)
+- Setup in secondi, risorse minime
+- Integrazione nativa con WordPress.com per preview/deploy
+- Symlink workflow per multi-site testing
+
+### Limitazioni
+
+- No multisite
+- No Xdebug nativo
+- SQLite incompatibile con alcuni plugin complessi (WooCommerce)
+- No estensioni PHP native (solo quelle compilate in WASM)
+- Linux: richiede build da source
+
+---
+
+## 4. LocalWP — Superficie di integrazione
+
+### Architettura interna
+
+- **Runtime**: Electron + Lightning Stack (processi nativi OS)
+- **Web server**: NGINX o Apache (selezionabile per sito)
+- **PHP**: PHP-FPM nativo (versioni multiple bundled: 7.4 - 8.3)
+- **Database**: MySQL/MariaDB nativo (credenziali default: root/root, db: local)
+- **Porte**: Da 10000+ (incrementali: HTTP, HTTPS, MySQL)
+- **Storage siti**: `~/Local Sites/<nome-sito>/app/public/`
+- **Config siti**: `~/.config/Local/sites.json` (Linux)
+- **Binari**: `~/.config/Local/lightning-services/{php,mysql,nginx,wp-cli}-*/`
+
+### Punti di integrazione
+
+| Punto | Metodo | Automazione possibile |
+|-------|--------|----------------------|
+| **Site Discovery** | Parse `~/.config/Local/sites.json` | Scoperta automatica siti, porte, versioni |
+| **WP-CLI** | Binario bundled `wp-cli-*/bin/wp --path=` | Tutto WP-CLI (richiede MySQL attivo) |
+| **REST API** | `http://<nome>.local/wp-json/` o `http://127.0.0.1:<porta>/wp-json/` | CRUD completo |
+| **MySQL diretto** | Socket `~/.config/Local/run/<id>/mysql/mysqld.sock` o TCP | Query, export, import |
+| **Filesystem** | `~/Local Sites/<nome>/app/public/wp-content/` | Sviluppo tema/plugin, symlink |
+| **Logs** | `~/Local Sites/<nome>/logs/{nginx,php,mysql}/` | Debug, monitoring |
+| **Blueprints** | `~/.config/Local/blueprints/` | Template siti riutilizzabili |
+| **MCP Adapter** | `wp mcp-adapter serve --path=<root>` (STDIO) | WordPress 6.9+ come MCP server |
+| **Live Links** | GUI only (ngrok-like) | Non automabile direttamente |
+
+### Punti di forza
+
+- Production parity completa (MySQL, PHP nativo, NGINX/Apache)
+- Multisite supportato
+- Xdebug + VS Code (add-on)
+- MailHog per email testing
+- Ecosystem add-on esteso
+- Pacchetti Linux ufficiali (.deb/.rpm)
+
+### Limitazioni
+
+- **No CLI ufficiale** — solo GUI + "Open Site Shell"
+- Automazione richiede parsing `sites.json` + PATH setup per binari interni
+- Setup piu lento (minuti vs secondi)
+- Risorse pesanti (processi nativi multipli per sito)
+- No MCP server dedicato (solo MCP Adapter generico)
+- Live Links solo da GUI
+
+---
+
+## 5. Confronto decisionale
+
+| Criterio | WordPress Studio | LocalWP | Vincitore per plugin |
+|----------|-----------------|---------|---------------------|
+| **CLI automation** | Eccellente (`studio` CLI v2) | Assente (solo binari interni) | Studio |
+| **MCP ecosystem** | Studio MCP Server + MCP Adapter | Solo MCP Adapter (generico) | Studio |
+| **Production parity** | Bassa (SQLite, WASM PHP) | Alta (MySQL, PHP nativo, NGINX) | LocalWP |
+| **WooCommerce dev** | Fragile (SQLite compat issues) | Completo | LocalWP |
+| **Multisite** | Non supportato | Supportato | LocalWP |
+| **Xdebug** | Non disponibile | Supportato (add-on) | LocalWP |
+| **Setup speed** | Secondi | Minuti | Studio |
+| **Risorse sistema** | Leggero (~100MB) | Pesante (multi-processo) | Studio |
+| **Email testing** | Non disponibile | MailHog integrato | LocalWP |
+| **Linux support** | Build da source | Pacchetti .deb/.rpm | LocalWP |
+| **Preview/share** | `studio preview` (WordPress.com) | Live Links (GUI) | Studio |
+| **Symbiosi con plugin** | Forte (stesso ecosystem Automattic) | Moderata (parsing richiesto) | Studio |
+
+**Sintesi**: Studio vince per automazione e leggerezza. LocalWP vince per fedelta all'ambiente di produzione.
+
+---
+
+## 6. Workflow tipici mappati
+
+### Comandi concreti per tool
+
+| Workflow | WordPress Studio | LocalWP |
+|----------|-----------------|---------|
+| **Crea sito** | `studio site create --path ~/Studio/test` | GUI -> New Site (no CLI) |
+| **Scaffold tema** | `studio wp scaffold theme mytheme` | `wp scaffold theme mytheme --path=~/Local\ Sites/test/app/public` |
+| **Scaffold blocco** | `studio wp scaffold block myblock --plugin=myplugin` | (stesso via wp-cli bundled) |
+| **Installa plugin** | `studio wp plugin install woocommerce --activate` | (stesso via wp-cli bundled) |
+| **Test PHP version** | `studio site set --php-version=8.2` | GUI -> Site Settings -> PHP Version |
+| **Export DB** | `studio wp db export backup.sql` | (stesso via wp-cli bundled) |
+| **Import contenuti** | `studio wp import content.xml --authors=create` | (stesso via wp-cli bundled) |
+| **Preview sharing** | `studio preview create` | Live Links (GUI only) |
+| **Debug PHP** | `studio wp eval 'error_log("test");'` | Xdebug + VS Code (add-on) |
+| **Deploy a produzione** | Locale -> `wp-deploy` skill (esistente) | Locale -> `wp-deploy` skill (esistente) |
+
+### Workflow completo: Sviluppo Block Theme
+
+```
+1. Crea sito locale          studio site create / LocalWP GUI
+2. Scaffold tema              wp scaffold theme / npx create-block-theme
+3. Sviluppa in editor         VS Code + symlink wp-content/themes/
+4. Testa nel browser          localhost:8881 / mysite.local
+5. Test PHP versions          studio site set --php / LocalWP settings
+6. PHPStan analisi            wp-phpstan skill (esistente)
+7. Preview condivisa          studio preview / Live Links
+8. Deploy                     wp-deploy skill (esistente)
+```
+
+### Workflow completo: Sviluppo Plugin con Gutenberg Block
+
+```
+1. Crea sito locale          studio site create / LocalWP GUI
+2. Scaffold plugin            wp scaffold plugin myplugin
+3. Scaffold blocco            npx @wordpress/create-block@latest
+4. Dev con hot reload         npm start (wp-scripts)
+5. Unit test                  npm test / phpunit
+6. PHPStan                    wp-phpstan skill (esistente)
+7. Build produzione           npm run build
+8. Deploy                     wp-deploy skill (esistente)
+```
+
+---
+
+## 7. Tre approcci architetturali
+
+### Approccio A: "Local Environment Abstraction Layer"
+
+Un layer di astrazione unificato che rileva automaticamente Studio, LocalWP, o wp-env e espone un'interfaccia comune.
+
+```
+                   ┌──────────────────────────┐
+                   │    wordpress-router       │
+                   │  (decision tree v3)       │
+                   └─────────┬────────────────┘
+                             │
+                   ┌─────────▼────────────────┐
+                   │  wp-local-env (NUOVA)     │
+                   │  Detection + Abstraction  │
+                   └─────────┬────────────────┘
+                    ┌────────┼────────┐
+               ┌────▼──┐ ┌──▼───┐ ┌──▼────┐
+               │Studio │ │Local │ │wp-env │
+               │adapter│ │adapter│ │adapter│
+               └───────┘ └──────┘ └───────┘
+```
+
+**Nuovi componenti**:
+- 1 skill: `wp-local-env` (detection, lifecycle, unified API)
+- 1 script detection: `detect_local_env.mjs` (trova Studio/LocalWP/wp-env)
+- 3 adapter sections in SKILL.md (Studio CLI, LocalWP sites.json, wp-env)
+- Aggiornamento router decision tree -> v3
+- Opzionale: integrazione Studio MCP Server in `.mcp.json`
+
+**Pro**: Massima flessibilita, futuro-proof, un solo workflow per l'utente.
+**Contro**: Complessita di implementazione alta, 3 adapter da documentare.
+
+**Effort stimato**: ~v1.5.0 (major feature)
+
+### Approccio B: "Studio-First con fallback LocalWP"
+
+Focus su Studio (CLI eccellente, MCP server Automattic), con detection passiva di LocalWP.
+
+```
+                   ┌─────────────────────┐
+                   │  wp-local-dev (NUOVA)│
+                   │  Studio-first        │
+                   └─────────┬───────────┘
+                    ┌────────┼────────┐
+               ┌────▼──────┐    ┌────▼──────┐
+               │Studio CLI │    │LocalWP    │
+               │(primario) │    │(discovery)│
+               └───────────┘    └───────────┘
+```
+
+**Nuovi componenti**:
+- 1 skill: `wp-local-dev` (focalizzata su Studio, con sezione LocalWP)
+- 1 script: `detect_local_env.mjs`
+- Integrazione `.mcp.json` con Studio MCP Server (disabled by default)
+- Aggiornamento router v3
+
+**Pro**: Piu semplice, Studio ha la migliore superficie CLI per automazione.
+**Contro**: Utenti LocalWP hanno esperienza di seconda classe.
+
+**Effort stimato**: ~v1.5.0 (medium feature)
+
+### Approccio C: "Workflow Skills" (per tipo di attivita)
+
+Skill separate per workflow tipico, ognuna con istruzioni specifiche per ogni tool.
+
+```
+  ┌───────────────┐  ┌──────────────┐  ┌───────────────┐
+  │wp-local-theme │  │wp-local-plugin│ │wp-local-test  │
+  │  development  │  │  development  │ │  & debug      │
+  └───────┬───────┘  └──────┬───────┘ └───────┬───────┘
+          │                  │                  │
+    Istruzioni per:    Istruzioni per:   Istruzioni per:
+    - Studio           - Studio          - Studio
+    - LocalWP          - LocalWP         - LocalWP
+    - wp-env           - wp-env          - wp-env
+```
+
+**Nuovi componenti**:
+- 3+ skill workflow-based
+- 1 script detection condiviso
+- Nessun adapter layer
+
+**Pro**: Ogni skill e self-contained, facile da capire.
+**Contro**: Duplicazione istruzioni, manutenzione difficile.
+
+**Effort stimato**: ~v1.5.0 (medium feature, ma manutenzione alta)
+
+---
+
+## 8. Integrazione MCP proposta
+
+### Opzione 1: Studio MCP Server (Automattic)
+
+```json
+{
+  "studio-mcp": {
+    "command": "node",
+    "args": ["<path-to>/wordpress-agent-skills/studio-mcp/dist/index.js"],
+    "disabled": true
+  }
+}
+```
+
+### Opzione 2: MCP Adapter Plugin (WordPress 6.9+, per qualsiasi sito locale)
+
+```json
+{
+  "wp-local-mcp": {
+    "command": "studio",
+    "args": ["wp", "mcp-adapter", "serve", "--server=mcp-adapter-default-server", "--user=admin", "--path=<site>"],
+    "disabled": true
+  }
+}
+```
+
+### Opzione 3: wp-rest-bridge esistente puntato a localhost
+
+Il `wp-rest-bridge` MCP server gia presente nel plugin puo gia connettersi a siti locali configurando `WP_SITES_CONFIG` con URL `http://localhost:8881` e Application Password locale.
+
+---
+
+## 9. Raccomandazione
+
+**Approccio A** e il piu robusto e futuro-proof.
+**Approccio B** e il miglior compromesso effort/valore — Studio ha la CLI migliore e l'ecosistema MCP piu maturo.
+**Approccio C** e il piu semplice da iniziare ma scala male.
+
+La decisione dipende da:
+- Se l'utente usa prevalentemente Studio -> Approccio B
+- Se deve supportare team con tool diversi -> Approccio A
+- Se vuole partire veloce e iterare -> Approccio C
+
+---
+
+*Assessment generato il 2026-02-27 per wordpress-manager v1.4.0*