Referencia completa de Senzu
Todo el catálogo en una página. Por temas: skills · comandos · hooks · stacks · arquitectura. Guías: README · INSTALL · USO.
1. Skills y enrutamiento
Sección titulada «1. Skills y enrutamiento»El agente decide solo, en tres capas automáticas:
- Al arrancar la sesión (hook SessionStart): estado del proyecto (stack, versiones+EOL, si es nuevo o
existente, design system, plan, devlog, convenciones) + puertas de entrada: UI →
ui-ux-pro-max· lógica →code-quality· proyecto nuevo →project-planner· duda →skill-router. - En cada petición (hook UserPromptSubmit): las señales de las tablas de abajo sugieren la skill (máx. 2, una vez por skill y sesión). Los entrypoints van primero; a igual match gana la prioridad mayor.
- Tablas de activación (
skill-routeryfront-activation, generadas del registro): el agente las consulta cuando duda;references/decision-trees.mdtiene los árboles de decisión completos.
Total: 45 skills. Fuente única: core/skills-registry.json (grupo, cuándo, señales, prioridad, dependencias).
Planificación (grupo planning, 1 skill)
Sección titulada «Planificación (grupo planning, 1 skill)»| Skill | Prio | Cuándo usarla | Señales que la activan (muestra) |
|---|---|---|---|
project-planner (entrada) |
20 | Arrancar un proyecto o feature, planificar, “¿qué hacemos ahora?”, siguiente tarea; y SIEMPRE que exista plan/PLAN.md (se sigue el plan) | planifica, planning, roadmap, fases, hoja de ruta, que hacemos ahora, siguiente tarea, empezamos… |
Enrutado (grupo routing, 3 skills)
Sección titulada «Enrutado (grupo routing, 3 skills)»| Skill | Prio | Cuándo usarla | Señales que la activan (muestra) |
|---|---|---|---|
skill-router (entrada) |
0 | Empezar cualquier tarea no trivial: decide qué skill y sección leer (tabla de activación + protocolo de carga) | que stack, elegir stack, con que lo hago, que skill, which stack, choose a stack, what do I use, which skill |
front-activation |
8 | Empezar una tarea de UI, animación o 3D: detecta el perfil de front y la lectura mínima por tarea; efectos concretos del catálogo (CSS moderno, formas y SVG, tipografía cinética, microinteracciones, WebGL avanzado, física e impacto: objetos que caen, pantalla rota, intros y loaders) | blobs, gooey, metaballs, morph, separadores de onda, onda entre secciones, clip-path, view transitions… |
instalar-proyecto |
8 | Instalar o actualizar Senzu completo en el proyecto (/instalar): todo, por categorías o a medida | instalar dev.standards, actualizar dev.standards, reinstala dev.standards, instalar el paquete, instalacion de dev.standards, install dev.standards, update senzu, reinstall senzu… |
Calidad de código (grupo quality, 3 skills)
Sección titulada «Calidad de código (grupo quality, 3 skills)»| Skill | Prio | Cuándo usarla | Señales que la activan (muestra) |
|---|---|---|---|
backend-audit |
8 | Auditar backend y arquitectura con pruebas (herramientas por stack, evidencia por hallazgo, informe), deuda técnica, código legado, dependencias circulares y refactor seguro con tests de caracterización | audit, deuda tecnica, codigo legado, legacy, hotspots, acoplamiento, dependencias circulares, analiza el backend… |
depurar |
8 | Algo falla o no funciona (tests en rojo, excepción, error 500, resultado incorrecto): método reproducir, test que falla, hipótesis, acotar y arreglar la causa | no funciona, no va, falla, fallando, depura, debug, bug, excepciones… |
code-quality |
5 | Escribir o refactorizar lógica, crear tests, manejar errores/logs, seguridad, rendimiento, diseñar endpoints/APIs, revisar o abrir un PR | tests, refactor, revisa, pull request, seguridad, security, rendimiento, performance… |
Arquitectura (grupo architecture, 1 skill)
Sección titulada «Arquitectura (grupo architecture, 1 skill)»| Skill | Prio | Cuándo usarla | Señales que la activan (muestra) |
|---|---|---|---|
ddd-hexagonal |
5 | Módulo con reglas de negocio ricas, varios contextos, refactor de arquitectura desde MVC, “¿cómo estructuro esto?” (empieza por su checklist “¿hace falta?”) | ddd, hexagonal, arquitectura, architecture, dominio, domain, agregado, aggregate… |
Documentación (grupo docs, 1 skill)
Sección titulada «Documentación (grupo docs, 1 skill)»| Skill | Prio | Cuándo usarla | Señales que la activan (muestra) |
|---|---|---|---|
devlog |
8 | Terminar un paso relevante o commitear (siempre); preguntas sobre el pasado del proyecto (memoria y buscador) | commit, commitea, cierra la tarea, documenta, devlog, memoria del proyecto, historial del proyecto, por que lo hicimos… |
Front y diseño (grupo front, 7 skills)
Sección titulada «Front y diseño (grupo front, 7 skills)»| Skill | Prio | Cuándo usarla | Señales que la activan (muestra) |
|---|---|---|---|
ui-ux-pro-max (entrada) |
15 | Crear, maquetar o rediseñar páginas, vistas, layouts, componentes, formularios, dashboards, temas, colores, tipografía, iconos, responsive, accesibilidad; archivos .vue .tsx .jsx .astro .blade.php .html .css | landing, web, sitio, home, hero, pagina, pantalla, vista… |
design-system |
10 | Tokens de diseño (primitivos → semánticos → componente), CSS variables, validación de tokens | design tokens, tokens de diseño, tokens semanticos, primitivos, css variables, sistema de diseño |
tanstack |
10 | Estado del servidor (fetch, caché, invalidación, infinite), tablas con orden/filtro/paginación (cliente o servidor), virtualización de listas grandes; dashboards y tablas de datos (React, Vue, Svelte, Solid) | tanstack, @tanstack, react.query, vue.query, react.table, tanstack.table, useQuery, estado del servidor… |
ui-styling |
10 | Componentes shadcn/ui (React o Vue) y utilidades/tema de Tailwind | shadcn-vue, radix, reka, componentes de ui, tailwind config, cva |
image-gen |
8 | Generar imágenes IA acordes a la web: producto flotante, heros, fondos, 3D, mockups, texturas (gpt-image en Codex, Nano Banana en Antigravity, script multi-proveedor) | genera una imagen, imagenes ia, fotos de producto, producto flotando, levitando, hero image, imagen para el hero, fondo generado… |
ui-verify |
8 | Verificar una UI terminada en navegador real: responsive 375/768/1440, dark mode, consola y accesibilidad (axe); obligatoria antes de dar una vista por hecha | verifica, comprueba la ui, revisa el responsive, lighthouse, axe, capturas, screenshots, se ve bien en movil… |
modern-web-design |
5 | Tendencias y principios de diseño web moderno | tendencias, bento, glassmorphism, neo-brutalis, estilo moderno, inspiracion, awwwards |
Animación (grupo motion, 9 skills)
Sección titulada «Animación (grupo motion, 9 skills)»| Skill | Prio | Cuándo usarla | Señales que la activan (muestra) |
|---|---|---|---|
motion-framer |
10 | Animación declarativa en React/Next con Motion (variants, gestos, layout animations) | framer motion, motion/react, animatepresence, variants, layout animation, usescroll, usetransform |
animated-component-libraries |
8 | Componentes animados prehechos (Magic UI, React Bits) | magic ui, react bits, aceternity, componentes animados, marquee react, shimmer, border beam, bento grid… |
animejs |
8 | Animaciones JS ligeras (anime.js) de DOM/SVG | anime js, anime |
barba-js |
8 | Transiciones entre páginas con Barba.js (sitios multipágina) | barba js, mpa, crossfade, wipe entre paginas, multipagina |
locomotive-scroll |
8 | Smooth scroll con Locomotive Scroll | locomotive |
lottie-animations |
8 | Animaciones Lottie (JSON de After Effects) | lottie, after effects, bodymovin, dotlottie |
react-spring-physics |
8 | Animación basada en físicas en React (react-spring) | react-spring, popmotion, animacion fisica, spring physics |
scroll-reveal-libraries |
8 | Reveals simples al hacer scroll (AOS) en landings | aos, animate on scroll, reveal simple, fade in al hacer scroll |
gsap-scrolltrigger |
5 | Animación, scroll-driven, parallax, pin/scrub, timelines, transiciones de página, smooth scroll (Lenis) | gsap, scrolltrigger, anima, animation, scroll, parallax, transiciones de pagina, smooth scroll… |
3D / WebGL (grupo 3d, 12 skills)
Sección titulada «3D / WebGL (grupo 3d, 12 skills)»| Skill | Prio | Cuándo usarla | Señales que la activan (muestra) |
|---|---|---|---|
pixijs-2d |
10 | Gráficos 2D/partículas en canvas con PixiJS | pixi js, canvas 2d, sprites, displacement, filtro 2d, pixelate, chromatic aberration, glow… |
react-three-fiber |
10 | 3D declarativo en React/Next (R3F + drei) | r3f, react three fiber, drei, fiber |
lightweight-3d-effects |
8 | Efectos 3D decorativos ligeros (Zdog, Vanta, tilt) | zdog, vanta, tilt, efecto 3d ligero, fondo animado, card 3d, glare, waves… |
aframe-webxr |
5 | VR/AR en el navegador (A-Frame, WebXR) | a-frame, webxr, realidad virtual |
babylonjs-engine |
5 | 3D con Babylon.js (juegos, escenas complejas) | babylon js |
blender-web-pipeline |
5 | Exportar/optimizar modelos de Blender a glTF para web | blender, exportar gltf, draco, ktx2 |
playcanvas-engine |
5 | Juegos/experiencias con PlayCanvas | playcanvas |
rive-interactive |
5 | Animaciones interactivas Rive (state machines) | rive, state machine de animacion |
spline-interactive |
5 | Escenas hechas en Spline e integración en web | spline |
substance-3d-texturing |
5 | Texturizado PBR con Substance 3D para web | substance, texturiz, pbr |
threejs-webgl |
5 | 3D, WebGL/WebGPU, modelos GLB/GLTF, shaders, partículas, configuradores, heros 3D | three js, webgl, webgpu, glb, gltf, shader, particulas, particles… |
web3d-integration-patterns |
5 | Combinar Three.js + GSAP + R3F + Motion en experiencias 3D complejas | integrar 3d, 3d gsap, three motion, experiencia 3d compleja |
Diseño gráfico y marca (grupo design, 4 skills)
Sección titulada «Diseño gráfico y marca (grupo design, 4 skills)»| Skill | Prio | Cuándo usarla | Señales que la activan (muestra) |
|---|---|---|---|
banner-design |
5 | Banners para redes, ads y heros | banners, creatividades, anuncios, ads |
brand |
5 | Voz de marca, identidad visual, guías de marca | marca, branding, voz de marca, guia de marca, brand |
graphic-design |
5 | Logos, iconos, identidad corporativa, mockups (generación con IA) | logo, logotipo, iconos, identidad corporativa, mockups, cip |
slides |
5 | Presentaciones HTML | presentacion, slides, diapositivas, deck |
Marketing y SEO (grupo growth, 2 skills)
Sección titulada «Marketing y SEO (grupo growth, 2 skills)»| Skill | Prio | Cuándo usarla | Señales que la activan (muestra) |
|---|---|---|---|
email-html |
8 | Maquetar o arreglar emails HTML (transaccionales y newsletters): react-email/MJML/plantillas del framework, compatibilidad Gmail/Outlook, dark mode, texto plano y pruebas antes de enviar | email transaccional, emails de bienvenida, newsletters, mjml, react-email, plantillas de email, email html, maqueta el email… |
marketing-seo |
8 | Posicionar y medir la web: SEO on-page y local, keywords, Search Console, GA4, Google Tag Manager (contenedor, dataLayer, Consent Mode) y MCPs de analítica para operar con agentes | seo, posicionamiento, posicionar, salir en google, keywords, palabras clave, search console, google analytics… |
Operaciones y despliegue (grupo ops, 1 skill)
Sección titulada «Operaciones y despliegue (grupo ops, 1 skill)»| Skill | Prio | Cuándo usarla | Señales que la activan (muestra) |
|---|---|---|---|
deploy-ops |
8 | Desplegar y operar en producción cualquier stack: Netlify/Vercel/Forge/VPS, Docker, CI/CD con GitHub Actions, secretos por entorno, colas y cron en prod, backups con restore probado, monitorización e incidentes | deploy, despliegue, desplegar, subelo a produccion, docker, dockerfile, docker.compose, dockeriza… |
Seguridad (grupo security, 1 skill)
Sección titulada «Seguridad (grupo security, 1 skill)»| Skill | Prio | Cuándo usarla | Señales que la activan (muestra) |
|---|---|---|---|
security |
8 | Revisar o auditar la seguridad del proyecto, blindar auth / una API / un agente de IA, hardening, pentesting autorizado, OWASP, inyección de prompt, XSS/CSRF/SSRF/IDOR, cabeceras de seguridad | seguridad, security, revision de seguridad, auditoria de seguridad, hardening, endurec, pentest, pruebas de penetracion… |
2. Comandos slash
Sección titulada «2. Comandos slash»Atajos opcionales: hablar en llano activa lo mismo vía enrutador. plan/siguiente/verificar/desplegar/adoptar
se instalan SIEMPRE; el resto solo en stacks con perfil de front.
| Comando | Argumento | Qué hace |
|---|---|---|
/plan |
[descripción del proyecto o feature] | Crea o retoma el plan del proyecto (senzu/plan/PLAN.md) con la skill project-planner |
/siguiente |
[id de tarea opcional, p. ej. F1-T3] | Ejecuta la siguiente tarea del plan (task-protocol de project-planner) |
/verificar |
Verifica el proyecto tras los cambios — build, lint, types, tests y (si hay UI) móvil | |
/desplegar |
[entorno u objetivo, p. ej. “producción” o “staging”] | Deploy con red — checklist PRE/DEPLOY/POST/ROLLBACK con evidencia y aprobación explícita |
/adoptar |
[notas opcionales, p. ej. “solo backend” o “el idioma oficial es inglés”] | Adoptar las convenciones de un proyecto existente y sellarlas como regla inmutable |
/auditar |
[área opcional, p. ej. “pagos”, “API pública” o “antes de producción”] | Auditoría del backend y la arquitectura con pruebas — herramientas reales, evidencia por hallazgo, informe y plan |
/brief |
[tipo de negocio si ya se sabe, p. ej. “restaurante”] | Entrevista de descubrimiento en lenguaje llano — para clientes que no saben el palabreo técnico |
/dependencias |
— sin argumento, revisa todo el proyecto. |
Pasa el escaner de cadena de suministro de Senzu (supply-scan) sobre el proyecto y explica lo que encuentre. Es la revision a fondo A PETICION; el muro supply-guard ya vigila solo al instalar un paquete y al hacer commit.
- Localiza el escaner: en un proyecto instalado esta en | Revisa la cadena de suministro — paquetes con malware o typosquatting y skills de terceros maliciosas |
|
/depurar| [síntoma o error, p. ej. “el checkout devuelve 500 con cupones”] | Depuración con método — reproducir, test que falla, hipótesis, acotar, arreglar la causa y verificar | |/design-system| [producto/industria, p. ej. “saas facturación autónomos”] | Genera (o revisa) el design system del proyecto con ui-ux-pro-max | |/efecto| <nombre del efecto> [dónde, p. ej. “marquee en el footer de logos”] | Aplica un efecto pro de frontend desde el catálogo (parallax, marquee, cursor, stacking…) | |/entregar| [proyecto o cliente] | Entrega al cliente — manual de uso, servicios y accesos, mantenimiento, cómo pedir cambios y formación | |/estimar| [qué estimar, p. ej. “la web del restaurante” o “fase 2”] | Estimación y presupuesto — horas por tarea, partidas olvidadas, riesgos y rango final para el cliente | |/instalar| [stack opcional, p. ej. “laravel”] | Instala o actualiza Senzu en este proyecto (web, backend, front, agente de IA, librería o a medida) | |/lanzar| [url de preview/producción] | Checklist de lanzamiento — todo lo que se comprueba antes de publicar la web | |/mapa| [área opcional, p. ej. “pagos”] | Mapa del proyecto — qué es, cómo arrancarlo, estructura, flujos críticos y dónde tocar para cada cosa | |/propuestas| [página, p. ej. “home” o “landing de escombros”] | Modo propuesta — blueprint aprobable + 2 maquetas A/B visuales antes de construir | |/recordar| [qué, p. ej. “los commits siempre sin co-autor”] | Apunta algo en la memoria — de este proyecto (decisión, regla, lo que no funcionó, pendiente) o del usuario (todos sus proyectos) | |/refactor| <objetivo, p. ej. “sacar la lógica de precios de OrderController”> | Refactor seguro — tests de caracterización primero, pasos pequeños verificados y mismo comportamiento demostrado | |/repaso| [url o página, p. ej. “http://localhost:4321” o “la home”] | Sesión de revisión conversacional — repasamos la web juntos, sección a sección | |/retomar| — sin argumentos.
Reconstruye dónde se quedó el trabajo SIN pedirle al usuario que lo cuente, y propón el siguiente paso:
- La sesión anterior: el aviso de inicio de sesión («Sesión anterior: pidió…, tocó…, dejó sin commitear…») y,
si hace falta el detalle, | Retoma donde se quedó la sesión anterior — qué se pidió, qué se tocó, qué quedó a medias y el siguiente paso |
|
/revisar-ui| [url o ruta de la vista, p. ej. http://localhost:5173 o Pages/Home.vue] | Audita la UI (rúbrica + verificación en navegador si hay Chrome disponible) | |/ronda| [tu opinión de la ronda anterior, o el texto que copia el panel de las maquetas] | Nueva ronda de maquetas — fija lo que te gustó, quita lo que no y propone algo nuevo | |/seguridad| — sin argumento, revisa todo el proyecto; con una zona (p. ej. | Revisión de seguridad con evidencia — mapa de superficie, pasada OWASP, informe y plan de arreglo |
Flujos típicos
Sección titulada «Flujos típicos»- Proyecto nuevo con web:
/brief(entrevista en llano) →/propuestas(blueprint + maquetas A/B) →/design-system→ construir con checkpoints →/revisar-ui→/lanzar→/desplegar. - Cualquier feature:
/plan→/siguiente(una tarjeta cada vez) →/verificarantes de cerrar. - Proyecto nuevo sin interfaz (API, backend, agente):
/plandirectamente;/briefes para lo que tiene pantallas. - Proyecto heredado:
/adoptarla primera sesión (analiza y sella sus convenciones) y después lo normal. /instalary/adoptarlos exige el muroarranque-guardantes de la primera línea de código; plan y brief no se imponen: si no está claro qué se hace, el agente pregunta.- Efecto concreto (“quiero un parallax/marquee/cursor”):
/efecto <nombre>va directo al catálogo con receta y coste móvil.
3. Muros y hooks
Sección titulada «3. Muros y hooks»Hooks en Node (.mjs, agnósticos de OS: funcionan igual en Windows/macOS/Linux). Los que BLOQUEAN salen
con exit 2 y el motivo; el resto solo informa. Solo Claude Code ejecuta hooks: en Codex/Cursor/Windsurf el
trabajo lo hacen las tablas de activación de las reglas generadas y los githooks (sync.ps1 -GitHooks).
| Hook | Evento | Qué hace |
|---|---|---|
session-start.mjs |
SessionStart | Inyecta estado: si Senzu está DESACTUALIZADO (qué hacer y qué se pierde, de core/novedades.json), stack/perfil, el SIGUIENTE PASO del método que falta (/instalar, /adoptar; sin plan, saber qué se hace o preguntarlo), idioma, diario propio detectado, versiones con aviso EOL, convenciones adoptadas, git, design system, plan, devlog y protocolo de skills. |
prompt-router.mjs |
UserPromptSubmit | Sugiere la skill que encaja con la petición (señales de docs/skills.md), una vez por skill y sesión. |
guard.mjs |
PreToolUse Bash/PowerShell | Mira lo que se EJECUTA, no lo citado (mensajes de commit, heredocs a un archivo, echo, grep). BLOQUEA: git push a una rama principal, forzado o sin ver a qué rama va (a las de trabajo, sí), escribir, mover, borrar o restaurar las convenciones selladas desde la terminal (sin escape para el agente), destructivos de BD/git, rm -rf, deploy a prod sin aprobación (escape SENZU_ALLOW_DEPLOY=1), generadores de logos con logo ya elegido (SENZU_ALLOW_LOGO=1), jQuery/Bootstrap (SENZU_ALLOW_LIB=1), devops peligroso (curl|bash, chmod 777, dd, mkfs, docker prune, parar servicios, vaciar firewall, crontab -r); commits: rama protegida, Conventional ≤72, sin co-autores. |
supply-guard.mjs |
PreToolUse Bash/PowerShell | Muro de cadena de suministro. En un comando de instalación (npm/pip/composer…) mira los NOMBRES de paquete (typosquatting, denylist de malware conocido) antes de que entren; al hacer git commit escanea lo que entra (manifests de dependencias, archivos de skills/plugins y .mcp.json) buscando scripts de instalación con red/shell, inyección de prompt, exfiltración (lee secretos y abre red), ofuscación (eval/base64/hex), caracteres unicode ocultos y servidores MCP que descargan y ejecutan. BLOQUEA lo grave, AVISA del resto. «Citar no es hacer»: mira lo que se ejecuta, no el texto citado, y también DENTRO de un script que el comando ejecuta (bash x.sh, python x.py…). Offline y determinista (listas en core/hooks/data/). No se puede apagar. Escape tras verificar: SENZU_ALLOW_SUPPLY=1. |
pentest-guard.mjs |
PreToolUse Bash/PowerShell | Muro de ALCANCE de pentesting. BLOQUEA ejecutar herramientas de seguridad ofensiva: escaneo de red (nmap, masscan, hping3), descubrimiento y fuzzing web (gobuster, ffuf, nikto, wpscan, nuclei, wfuzz), inyección y explotación (sqlmap, commix, metasploit/msfconsole/msfvenom), fuerza bruta de credenciales (hydra, medusa, ncrack), cracking (hashcat, john) y enumeración o post-explotación de red o AD (enum4linux, crackmapexec, responder, evil-winrm, wifi). «Citar no es hacer»: mira lo que se ejecuta, no el texto citado, y también DENTRO de un script que el comando ejecuta (bash x.sh, ./x.sh…). Senzu ayuda con pentesting AUTORIZADO: con permiso por escrito y alcance documentados en el devlog, escape SENZU_ALLOW_PENTEST=1. No se puede apagar. |
protect-files.mjs |
PreToolUse Edit/Write | BLOQUEA editar: generados por Senzu, secretos (.env, *.pem, credentials), dependencias/artefactos, migraciones versionadas, conventions.md/json sellados (no se puede apagar), maestros del logo elegido (logos/final/) y protectedPaths del proyecto. |
secrets-guard.mjs |
PreToolUse Edit/Write | BLOQUEA escribir credenciales reales (AWS, GitHub, Stripe, OpenAI/Anthropic, PEM, JWT, cadenas con password); ignora placeholders. |
code-hygiene.mjs |
PreToolUse Edit/Write | BLOQUEA introducir (no en scripts de la carpeta temporal del agente): console.log/debugger/dd()/var_dump/ray, términos vetados en gustos.md §No, marcadores de conflicto de git, .only/.skip/xit en tests, y la lista negra anti-IA (badges de disponibilidad, numeración de secciones). Escape puntual: comentario senzu-allow. |
conventions-guard.mjs |
PreToolUse Edit/Write | BLOQUEA código que viole las reglas ejecutables de conventions.json (/adoptar): la convención del proyecto gana. No se puede apagar. La ruta se normaliza (C:, C:/, /c/ de Git Bash, relativa) antes de aplicar las reglas. |
arquitectura-guard.mjs |
PreToolUse Edit/Write | Solo si el proyecto DECLARA su arquitectura (senzu/arquitectura/capas.json, de /adoptar o /plan). BLOQUEA lo que introduce: una capa que usa otra que no puede (dominio con framework u ORM, aplicación con HTTP), un contexto de DDD que usa otro por dentro y el controlador que habla con la base de datos. AVISA del array de la petición pasado en vez de un DTO y del código nuevo fuera de las carpetas declaradas. Imports reales: use + PSR-4, import + alias de tsconfig, módulos de Python. No se puede apagar. |
backend-guard.mjs |
PreToolUse Edit/Write | BLOQUEA introducir: migraciones destructivas en la parte que se aplica (borrar o renombrar columnas o tablas: patrón expandir → contraer), env() fuera de config/ en Laravel, datos personales en logs (request completa, cuerpos, contraseñas o tokens), migraciones sin down() honesto, asignación masiva (la request entera al modelo) y errores tragados (catch vacío, except: pass). AVISA de varias escrituras en la misma función sin transacción y de consultas en bucle (N+1). Escape: senzu-allow con el motivo. |
security-guard.mjs |
PreToolUse Edit/Write | AVISA (no bloquea; una vez por archivo y sesión) de puntos de inyección que se introducen en el código: XSS (dangerouslySetInnerHTML, v-html, set:html, {@html}, Blade {!! $x !!}, innerHTML/insertAdjacentHTML/document.write con una variable), SQL injection (Prisma $queryRawUnsafe, DB::raw/whereRaw de Laravel con $, execute con f-string o concatenación en Python) e inyección de comando o ejecución dinámica (exec/execSync/shell_exec/os.system con variable, shell=True, eval). Solo mira lo introducido y el código sin comentarios. Escape por línea: senzu-allow. |
pool-guard.mjs |
PreToolUse Edit/Write | AVISA (no bloquea; una vez por archivo y sesión) de lo que agota el pool de conexiones a la BD en Node/TS y Python: new PrismaClient() sin singleton global (en serverless abre una conexión por invocación), y crear un pool/cliente/engine dentro de código por petición (rutas, controladores, endpoints). PHP-FPM queda fuera. Receta: code-quality/references/database-design.md (§Conexiones y pool). |
back-skill-reminder.mjs |
PreToolUse Edit/Write (backend) | Primera edición de backend en la sesión: recuerda la receta del stack, las convenciones selladas y la versión real del framework. No bloquea. |
depurar-coach.mjs |
PostToolUse Bash/PowerShell | Si falla un test, build o verificación que se EJECUTA (no al leer un archivo de test), activa el método de la skill depurar (reproducir, test que falla, hipótesis, acotar, arreglar la causa). Como mucho una vez cada 20 minutos. |
front-skill-reminder.mjs |
PreToolUse Edit/Write (front) | Primera edición de UI: BLOQUEA una vez si no hay design system NI brief (obliga a preguntar); después recuerda ui-ux-pro-max, el set de iconos del MASTER y las reglas duras de UI. |
format-on-save.mjs |
PostToolUse | Formatea el archivo guardado con la herramienta del stack (Pint/Prettier/ruff) si existe. Nunca bloquea. |
edit-tracker.mjs |
PostToolUse | Apunta cada archivo que toca la sesión (para cierre-limpio) y marca que se editó código (stop-guard exige verificación posterior). |
memoria-viva.mjs |
UserPromptSubmit | Si dices una regla o una corrección («no vuelvas a…», «te dije…», «a partir de ahora…»), pide al agente apuntarla en la memoria del proyecto o en la tuya (todos tus proyectos). Guarda tus últimas peticiones para /retomar. |
memoria-archivo.mjs |
PreToolUse Edit/Write | La primera vez que se va a tocar un archivo, le pasa al agente lo que la memoria y el devlog dicen de él (decisiones, lo que no funcionó). No bloquea. |
estado-sesion.mjs |
Stop · PreCompact | Guarda en qué se quedó la sesión (peticiones, archivos, lo que quedó sin commitear, tarea en curso) para la siguiente y para /retomar. Al cerrar, BLOQUEA una vez si diste una regla o corrección y no quedó apuntada en la memoria. |
arranque-guard.mjs |
PreToolUse Edit/Write (código y manifiestos) | BLOQUEA, una vez por paso y sesión, la primera edición de código si falta instalar Senzu o /adoptar (proyecto con código sin convenciones). Sin plan NO bloquea: recuerda que hay que saber qué se va a hacer y, si no está claro, hablarlo con el usuario; /plan o /brief solo si es grande. Nunca para senzu/, CLAUDE.md, AGENTS.md ni la documentación. El usuario puede quitar un paso con init.mjs –omitir-paso. |
tarjeta-guard.mjs |
PreToolUse Edit/Write (senzu/plan/PLAN.md) | BLOQUEA pasar una tarjeta a [done] sin «Verificado:» (la evidencia real), «Cumple:» (cómo cumple su «Para qué»: el objetivo del usuario o el hallazgo de la auditoría que resuelve) y un «Devlog:» que exista. Vale igual para las tarjetas del plan y las de /auditar. |
feature-guard.mjs |
Stop · PostToolUse Bash | Backend. BLOQUEA el cierre (una vez por conjunto de archivos) si la sesión tocó código de backend y ningún test, si creó o tocó migraciones sin ejecutarlas o sin probar su rollback (apunta los migrate que se ejecutan), o si el código usa variables de entorno nuevas que no están en .env.example. |
cierre-limpio.mjs |
Stop | BLOQUEA el cierre (una vez) si dejas sin commitear archivos que tocaste en esta sesión: o terminas y commiteas (en una rama), o commiteas y dices qué falta. Los cambios que NO tocaste (otro agente como Codex, otra sesión o el usuario) solo los avisa: no se commitean ni se descartan sin preguntar. |
stop-guard.mjs |
Stop | BLOQUEA el cierre (una vez) si falta: devlog del día, verify-build tras editar código, o ui-verify móvil tras tocar UI. Además avisa de assets pesados añadidos en las últimas 24 h (imágenes de más de 500 KB, fuentes sin woff2, vídeos grandes). |
pre-compact.mjs |
PreCompact | Re-inyecta lo esencial (stack, versiones, design system, plan, reglas) para sobrevivir a la compactación de contexto. |
session-end.mjs |
SessionEnd | Limpia los marcadores de sesión. |
Escapes (siempre con aprobación explícita del usuario, documentada en el devlog)
Sección titulada «Escapes (siempre con aprobación explícita del usuario, documentada en el devlog)»Las llaves SENZU_ALLOW_* van como prefijo del comando (SENZU_ALLOW_PENTEST=1 nmap …): autorizan solo ESE comando, no toda la sesión. Exportar la variable ya no abre la puerta.
SENZU_ALLOW_DEPLOY=1— deploy a producción tras la aprobación del checklist/desplegar.SENZU_ALLOW_LIB=1— instalar una librería vetada (jQuery/Bootstrap) si el usuario lo pide.- Comentario
senzu-allowen la línea — excepción puntual de code-hygiene (script CLI con console.log, test .skip justificado, patrón anti-IA pedido por su nombre). - Convenciones selladas: se cambian borrando
conventions.*y re-ejecutando/adoptar(decisión del usuario).
4. Stacks y bundles
Sección titulada «4. Stacks y bundles»Cada stack define systemprompt evolutivo, mejores prácticas, prohibiciones, comandos de verificación,
formateadores, permisos y (en los de front) el perfil del buscador de diseño. init-project.ps1 -Stack <n>.
| Stack | Qué es | Perfil de front |
|---|---|---|
astro |
Astro | Astro + React islands + Tailwind |
laravel |
PHP / Laravel | Laravel + Inertia + Vue 3 + Tailwind |
next |
Next.js + TypeScript | Next.js (App Router) + React + Tailwind |
node-api |
Node API (Express / NestJS) | — (backend) |
nuxt |
Nuxt 3/4 + Vue 3 | Nuxt 3 + Vue 3 + Tailwind |
python-langgraph |
Python + LangGraph / LangChain | — (backend) |
sveltekit |
SvelteKit + Svelte 5 | SvelteKit + Svelte 5 + Tailwind |
vue-ts |
Vue 3 + TypeScript | Vue 3 + TypeScript + Tailwind |
wordpress |
WordPress / PHP clásico | WordPress + theme a medida (child theme) + CSS propio |
Lenguajes sin stack propio (referencias de code-quality, el router los enruta igual): Go (go.md),
Java/Spring (java.md), C#/.NET (csharp.md).
Bundles opcionales (init.mjs --bundle <nombre> o sync.ps1 -Bundle <nombre>)
Sección titulada «Bundles opcionales (init.mjs --bundle <nombre> o sync.ps1 -Bundle <nombre>)»| Bundle | Skills |
|---|---|
3d-authoring |
blender-web-pipeline, spline-interactive, rive-interactive, substance-3d-texturing |
3d-web |
threejs-webgl, react-three-fiber, gsap-scrolltrigger, web3d-integration-patterns |
animation-components |
react-spring-physics, animated-component-libraries, scroll-reveal-libraries, animejs, lottie-animations |
architecture |
ddd-hexagonal, code-quality |
core-3d-animation |
threejs-webgl, gsap-scrolltrigger, react-three-fiber, motion-framer, babylonjs-engine |
design-extras |
ui-ux-pro-max, ui-styling, design-system, graphic-design, slides, brand, banner-design, tanstack |
extended-3d-scroll |
aframe-webxr, lightweight-3d-effects, playcanvas-engine, pixijs-2d, locomotive-scroll, barba-js |
motion-web |
gsap-scrolltrigger, motion-framer, scroll-reveal-libraries |
web-design-meta |
web3d-integration-patterns, modern-web-design |