prestashop-experts

prestashop-experts

Claude Code plugin with two expert agents for daily PrestaShop freelance work, plus a curated knowledge base both agents consult before answering.

Agent	Domain	KB size
panda-expert	Panda theme by SunnyToo, st* modules, Easy Builder, SunnyToo demos	120 md files
prestashop-expert	PrestaShop 8/9 core: themes, parent-child, Symfony BO, Twig, Smarty, hooks, modules, install, migration 8→9	82 md files

Both agents are CWD-first: they always inspect the current project source before relying on KB snapshots, and they never edit the parent theme — only the child.

---

Install

In Claude Code:

/plugin marketplace add educlopez/prestashop-experts
/plugin install prestashop-experts@prestashop-experts
/reload-plugins

After install, both agents auto-register. Invoke them in two ways:

1. Direct mention: @panda-expert or @prestashop-expert.
2. Via the Task tool — Claude Code auto-routes by the agent description.

Updating

/plugin marketplace update prestashop-experts
/plugin uninstall prestashop-experts@prestashop-experts
/plugin install prestashop-experts@prestashop-experts
/reload-plugins

See the CHANGELOG for what's new in each release.

---

When to use which

PrestaShop question
        │
        ▼
Is it about the Panda theme specifically? ──── yes ──▶ panda-expert
        │
        no
        │
        ▼
Is it about a `st*` module / SunnyToo / Easy Builder? ── yes ──▶ panda-expert
        │
        no
        │
        ▼
Is it about a storefront layout you'd render with Panda? ─ yes ──▶ panda-expert
        │
        no
        │
        ▼
       prestashop-expert (Symfony BO, Twig, Smarty, hooks, modules, themes core, migration)

Examples:

• "¿Qué módulo de Panda uso para un megamenu con imágenes de categoría?" → panda-expert.
• "¿Cómo override el template product.tpl sin tocar el padre?" → panda-expert (project lives in Panda).
• "¿Qué cambia en hooks de PS 8 a PS 9?" → prestashop-expert.
• "Cloné PS 9 source y tengo install-dev/ en vez de install/. ¿Qué hago?" → prestashop-expert.
• "Hummingbird vs Panda para un cliente con compliance EAA" → prestashop-expert (decision matrix).
• "¿Qué demo de Panda como base para web de moda?" → panda-expert.

Note: stats* modules (statsbestcategories, statsbestcustomers, etc.) are PS core, not Panda. The agents will defer those questions to prestashop-expert.

---

What's in the KB

panda-kb (skills/panda-kb/references/)

docs/         # 26 docs oficiales SunnyToo (shallow — imágenes no capturadas)
modules/      # 58 fiches generadas desde source de Panda 2.9.2
              # incluye stbanner, stmegamenu, stbrandsslider, stfeaturedslider,
              # stblog (+ 10 sub-módulos), stthemeeditor, steasybuilder,
              # steasy_trans_panda, etc.
demos/        # 22 demos oficiales catalogadas
easybuilder/  # 6 docs del track Easy Builder (paid, opcional)
              #   01-widgets-catalog.md      # 31 widgets genéricos
              #   04-bridge-trans-panda.md   # 20 widgets PS-aware
forum/        # placeholder (diferido)
_agent/       # README de la KB + panda-expert system prompt original
README.md
00-Research-Report.md

prestashop-kb (skills/prestashop-kb/references/)

themes/             # 14 docs — theme.yml, parent-child, template inheritance,
                    # Hummingbird v2 decision matrix, themes folder layout PS 9,
                    # recovery protocol for parent edits
modules/            # 11 docs — config.xml, controllers, services.yml, lifecycle,
                    # hooks-in-modules
hooks/              # 3 docs — overview + listings
smarty/             # 40 docs — Smarty + PS extensions ({l}, {hook}, {widget})
install/            # 1 doc — source-vs-distribution.md (PS 9 clone vs zip)
version-migration/  # 9 docs — PS 8 → 9, Symfony/Twig BO, upgrade process,
                    # custom module migration
README.md

---

Operating principles (both agents)