drupal-tools

drupal-tools

Plugins de Claude Code para desarrollo con Drupal

[![version][version-badge]][changelog] [![Licencia][license-badge]][license] [![Código de conducta][conduct-badge]][conduct] [![Donate][donate-badge]][donate-url]

---

Descripción

Colección de plugins para Claude Code orientados al desarrollo con Drupal. El marketplace ofrece tres plugins modulares:

Plugin	Descripción
drupal-global	Base común: MCPs (Context7, Obsidian, Playwright), agentes, comandos y skills compartidos
drupal-backend	Especializado en backend: módulos, APIs, servicios, migraciones (requiere drupal-global)
drupal-frontend	Especializado en frontend: theming, Twig, CSS/JS, accesibilidad (requiere drupal-global)

Los plugins drupal-backend y drupal-frontend requieren drupal-global. Debes instalar drupal-global primero, o instalarlos todos juntos si haces desarrollo full-stack.

---

Arquitectura

Componentes de un plugin

Los plugins de Claude Code pueden incluir los siguientes tipos de componentes:

Componente	Qué es	Ejemplo
Agentes	Subagentes especializados que Claude invoca automáticamente según el contexto de la tarea. Tienen su propio prompt de sistema, herramientas y modelo.	El agente context7 consulta documentación actualizada antes de responder.
Comandos	Atajos invocables con /nombre que ejecutan instrucciones predefinidas. Útiles para tareas repetitivas o flujos guiados.	/drupal-setup configura un entorno de proyecto Drupal.
Skills	Similares a los comandos pero con estructura más completa: pueden incluir archivos de referencia, scripts auxiliares y subdirectorios.	La skill drupal-setup incluye plantillas de CLAUDE.md y README.md.
Hooks	Scripts que se ejecutan automáticamente antes o después de que Claude use una herramienta. Actúan como guardrails de seguridad.	Un hook PreToolUse que impide modificar archivos en vendor/.
MCPs	Servidores del Model Context Protocol que conectan a Claude con herramientas externas (APIs, bases de datos, navegadores, etc.).	Context7 para documentación, Playwright para automatizar un navegador.

Estructura de directorios

drupal-tools/
├── .claude-plugin/
│   └── marketplace.json            # Registro de los 3 plugins
├── drupal-global/                  # Plugin base con componentes compartidos
│   ├── .claude-plugin/plugin.json
│   ├── .mcp.json                   # MCPs: Context7, Obsidian, Playwright
│   ├── agents/
│   │   └── context7.md             # Agente experto en documentación
│   ├── commands/
│   │   ├── drupal-setup.md         # Comando para invocar la skill drupal-setup
│   │   └── update-changelog.md     # Comando para gestionar CHANGELOG.md
│   ├── output-styles/
│   │   └── onovasdev.md            # Estilo de salida personalizado (registrado globalmente)
│   ├── skills/
│   │   ├── drupal-setup/           # Skill de configuración de proyectos Drupal
│   │   │   ├── SKILL.md            # Instrucciones de la skill
│   │   │   └── templates/          # Plantillas (CLAUDE.md, README.md)
│   │   ├── change-name/            # Skill de renombrado de módulos/temas
│   │   │   └── SKILL.md            # Instrucciones de la skill
│   │   └── config-ia/              # Skill de configuración de Claude Code para el proyecto
│   │       ├── SKILL.md            # Instrucciones de la skill
│   │       └── templates/          # Plantillas (settings.onovas.json, scripts/)
│   └── hooks/
│       ├── hooks.json              # Configuración de hooks compartidos
│       └── scripts/
│           └── protect-files.sh     # Protección: node_modules, vendor, .git
├── drupal-backend/                 # Plugin backend (depende de drupal-global)
│   ├── .claude-plugin/plugin.json
│   ├── agents/
│   │   └── drupal-backend.md       # Agente experto en backend Drupal
│   ├── commands/                   # (vacío por ahora, preparado para futuros comandos)
│   ├── skills/                     # (vacío por ahora, preparado para futuros skills)
│   └── hooks/
│       ├── hooks.json              # Configuración de hooks backend
│       └── scripts/
│           └── protect-files.sh     # Protección: core, default.settings.php
└── drupal-frontend/                # Plugin frontend (depende de drupal-global)
    ├── .claude-plugin/plugin.json
    ├── agents/
    │   └── drupal-frontend.md      # Agente experto en frontend Drupal
    ├── commands/
    │   └── component.md            # Generador de SDC (Single Directory Components)
    ├── skills/                     # (vacío por ahora, preparado para futuros skills)
    └── hooks/
        ├── hooks.json              # Configuración de hooks frontend
        └── scripts/
            └── protect-files.sh     # Protección: core, dist, build

Sistema modular

Los tres plugins están completamente separados: