convez.ai
SkillDesenvolvimento WebAvançado
Automattic

Claude WooCommerce Toolkit

Automattic/claude-woocommerce-toolkit

Skills Claude para desenvolvimento e auditoria de plugins WooCommerce enterprise-ready

Ver no GitHub
BomPluginScore · de 0 a 100

Conjunto de skills e agents para construir, revisar e manter plugins WordPress e WooCommerce com padrões profissionais, segurança fintech-grade e conformidade PCI-DSS. Inclui ferramentas para desenvolvimento, auditoria de saúde de código, testes de upgrade e análise de rastreabilidade.

Instalação

$npx convez-ai Automattic/claude-woocommerce-toolkit

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
8
Forks
2
Acompanhando
0
Saúde
62%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Desenvolver plugins WooCommerce prontos para o marketplace
  • Auditar saúde de código e rastreabilidade antes de lançamento
  • Validar segurança de migrações de banco de dados em upgrades
  • Implementar conformidade PCI-DSS em integrações de pagamento
  • Estruturar arquitetura de plugins com padrões WordPress

Veredito

Toolkit robusto e especializado para desenvolvedores WooCommerce profissionais. Vai além de scaffolding: inclui auditoria estruturada, segurança fintech, testes de compatibilidade e guias de conformidade — essencial para quem precisa entregar plugins marketplace-ready ou manter padrões enterprise.

README

A tradução para o português deste README ainda está na fila.

Claude WooCommerce Toolkit

A collection of Claude Code skills and agents for building, reviewing, and maintaining WordPress and WooCommerce plugins. These tools encode professional development standards, security best practices, and UX guidelines drawn from the official WordPress Plugin Handbook, WooCommerce developer documentation, and fintech-grade security practices.

What's Included

Skills

WooCommerce Plugin Development — A comprehensive skill that guides you through building WooCommerce Marketplace-ready plugins from scratch. It operates in two phases:

  1. Project Discovery — structured interview to produce a project brief
  2. Development Execution — scaffold and build following all standards

Includes 10 reference documents covering every aspect of plugin development:

ReferenceWhat It Covers
Coding StandardsWordPress PHP/JS/CSS standards, WPCS 3.3.0+, PSR-4 autoloading
SecurityInput sanitization, output escaping, nonces, CSRF, SQL injection prevention, PCI-DSS
TestingPHPUnit, Playwright E2E, security tests, financial precision tests, CI/CD
Plugin ArchitectureFile structure, bootstrapping, HPOS declaration, uninstall handlers
WooCommerce APIsOrder/Product CRUD, hooks, REST API, Store API, Additional Checkout Fields, Action Scheduler
UX GuidelinesNavigation, settings design, onboarding, admin notices, accessibility
Abilities & MCPExposing operations to AI agents via the WordPress Abilities API + MCP Adapter
Agentic CommerceAI-agent discovery & checkout readiness (Abilities/MCP, ACP, AP2)
PCI Script ManagementPCI DSS v4.0.1 payment-page script requirements (6.4.3 / 11.6.1)
Marketplace SubmissionQIT managed tests, Marketplace + WordPress.org distribution

Also includes evaluation benchmarks with 3 test scenarios.

WooCommerce Finalization — Pre-release code health and traceability audit. Runs after code review to catch structural issues that checklists miss:

  • Code Health — dead code detection, duplication analysis, structural complexity (god classes, deep nesting)
  • Traceability Analysis — end-to-end verification tracing every UI interaction through AJAX/REST handlers, business logic, data access, and database. Includes 5 payment-gateway-specific trace paths (payment, refund, settings, token, webhook flows)

WooCommerce Upgrade Safety — Pre-release upgrade safety review that validates what happens when existing merchants upgrade between versions:

  • Database Migration Safety — idempotency, batching, version gates, HPOS dual-table compatibility
  • Payment Continuity — saved token preservation, active subscription safety, pending transaction handling, webhook backward compatibility
  • Hook/Filter Compatibility — removed hooks, changed signatures, deprecation notices
  • Rollback Safety — downgrade resilience, WordPress auto-update safety
  • Changelog Quality — upgrade notices, breaking change documentation, version metadata

Agents

WooCommerce UX Reviewer — An expert UX review agent specialized in WordPress, WooCommerce, and payment system interfaces. Reviews checkout flows, payment gateway integrations, admin UI, onboarding experiences, and error states against dimensions including clarity, trust signals, accessibility (WCAG 2.1 AA), mobile responsiveness, and conversion impact.

Code Reviewer — A general-purpose code review agent that evaluates code across six dimensions: correctness, security, performance, code quality, test coverage, and project standards alignment. Not WordPress-specific, but works well in any WooCommerce project context.

Prerequisites

Installation

See the Installation Guide for detailed setup instructions.

Quick Start

Clone this repository:

git clone https://github.com/Automattic/claude-woocommerce-toolkit.git

Install skills (copy or symlink into your Claude Code skills directory):

# Global installation (available in all projects)
cp -r claude-woocommerce-toolkit/skills/woocommerce-plugin-dev ~/.claude/skills/
cp -r claude-woocommerce-toolkit/skills/woocommerce-finalize ~/.claude/skills/
cp -r claude-woocommerce-toolkit/skills/woocommerce-upgrade-safety ~/.claude/skills/

# Project-level installation (available only in one project)
cp -r claude-woocommerce-toolkit/skills/* /path/to/your/project/.claude/skills/

Install the agents (copy or symlink into your Claude Code agents directory):

# Global installation
cp claude-woocommerce-toolkit/agents/*.md ~/.claude/agents/

# Project-level installation
cp claude-woocommerce-toolkit/agents/*.md /path/to/your/project/.claude/agents/

Usage

WooCommerce Plugin Dev Skill

The skill triggers automatically when you mention building a WooCommerce plugin. You can also invoke it directly:

> I want to build a WooCommerce plugin that adds a loyalty points system

Claude will conduct a project discovery interview before writing any code,
then scaffold and build following all standards in the reference docs.

Example trigger phrases:

  • "Build a WooCommerce plugin..."
  • "Create a payment gateway extension..."
  • "Start a new Woo extension for..."
  • "Scaffold a shipping method plugin..."

UX Payments Reviewer Agent

The agent is invoked automatically when you complete UX-critical work, or you can request a review:

> Can you review the checkout flow I just built?

Claude will launch the UX reviewer agent to assess clarity, trust signals,
error handling, accessibility, mobile responsiveness, and conversion impact.

Code Reviewer Agent

Triggered after completing a logical chunk of code:

> I've finished the payment gateway class, can you review it?

Claude will launch the code reviewer agent to check correctness, security,
performance, code quality, test coverage, and standards alignment.

Non-Negotiable Standards

The WooCommerce plugin dev skill enforces these rules on every file:

  1. HPOS compatibility is mandatory — use WooCommerce CRUD, never get_post_meta() for orders
  2. All user input is hostile — sanitize on input, escape on output, prepared statements for DB
  3. Nonces and capability checks on every form and AJAX handler
  4. Every public function has a PHPDoc block with @since, @param, @return
  5. No direct database queries when WooCommerce/WordPress provides an API
  6. All strings are translatable using the plugin's text domain
  7. Tests exist for every feature — unit, integration, and E2E for user-facing flows
  8. Prefix everything — functions, hooks, options, meta keys, REST routes
  9. WordPress enqueue system for all scripts and styles
  10. Declare all WooCommerce feature compatibility via FeaturesUtil

Contributing

See CONTRIBUTING.md for guidelines on proposing changes, adding reference docs, and submitting evals.

License

This project is licensed under the GPL v2 or later — see the LICENSE file for details.

Ver o original no GitHub

Bom para

Relacionados