Ir al contenido

Instalar Senzu (Claude Code y Codex)

Después de instalar, la guía del día a día (qué es automático, comandos, flujos) está en USO.md.

Senzu se instala en dos niveles:

  1. En tu agente (una vez por máquina): el plugin de Claude Code o de Codex. Con eso ya tienes las skills y el comando /instalar.
  2. En cada proyecto: /instalar deja en el proyecto las reglas (CLAUDE.md / AGENTS.md), los muros (hooks), los comandos y la carpeta senzu/ con el plan, el devlog y la memoria. Los muros solo actúan en los proyectos instalados.

Requisitos: Node 18 o superior y Git. Python 3 es opcional (lo usa el buscador de diseño de ui-ux-pro-max). Funciona en Windows, WSL, Linux y macOS.

1. Lo recomendado: plugin + /instalar (sin clonar nada)

Sección titulada «1. Lo recomendado: plugin + /instalar (sin clonar nada)»

Dentro de Claude Code:

/plugin marketplace add petersonsenadevs/senzu
/plugin install senzu-all@senzu

senzu-all es el paquete completo (recomendado). Hay versiones ligeras: senzu-front, senzu-backend y senzu-core (lo mínimo: devlog, enrutador y muros).

¿Dónde se instala? (el scope). Al instalar, Claude Code te pregunta para quién es el plugin:

Scope Dónde queda Para quién
user (recomendado) tu carpeta de usuario (~/.claude) Tú, en todos tus proyectos
project .claude/settings.json del repositorio (va en git) Todo el equipo que clone el repositorio
local .claude/settings.local.json (no va en git) Solo tú y solo en ese repositorio

Desde la terminal se elige con --scope: claude plugin install senzu-all@senzu --scope project. Lo normal es user y luego /instalar en cada proyecto; project tiene sentido si quieres que todo tu equipo tenga Senzu al abrir el repositorio sin instalar nada. Desinstalar: claude plugin uninstall senzu-all@senzu (con --scope si no era user).

En la app de Codex: añade el marketplace petersonsenadevs/senzu, instala senzu-all y aprueba los hooks cuando te lo pida (sin aprobarlos, los muros no actúan).

Abre una sesión del agente dentro de la carpeta del proyecto y escribe:

/instalar

El agente:

  1. Descarga Senzu en ~/.senzu (la carpeta .senzu de tu usuario) si no está, o lo actualiza.

  2. Detecta el stack (Laravel, Next, Astro, Vue, Nuxt, SvelteKit, WordPress, Node API, Python), o se lo dices tú: /instalar laravel.

  3. Te pregunta, en una sola pregunta, el stack, las herramientas (Claude, Claude + Codex o solo Codex) y qué hacer con tu CLAUDE.md, AGENTS.md o diario si ya existen (por defecto se respaldan).

  4. Te pregunta qué es el proyecto, y según eso instala lo que tiene sentido:

    Perfil Para Qué instala
    Web completa webs y apps con interfaz todo lo del stack
    Backend APIs, servicios, workers, herramientas de servidor (un agente de pentesting, un scraper) calidad, arquitectura y despliegue; nada de front: ni skills, ni muros, ni comandos de diseño
    Front landings, webs de marketing, interfaces sobre una API ajena diseño, animación, marca, SEO y despliegue (el 3D, aparte: --bundle core-3d-animation)
    Agente de IA agentes y apps con LLM (LangGraph, herramientas, RAG) sin interfaz web propia como backend
    Librería o CLI paquetes que publicas y herramientas de terminal calidad y despliegue

    O eliges tú: todo, por categorías (front, animación, 3D, calidad, arquitectura, marketing y SEO, operaciones, diseño gráfico) o a medida (skills, muros y comandos uno a uno). El núcleo (plan, devlog, calidad y enrutado) va siempre, con cualquier opción. Sin front, nada de front: aunque el stack lo tenga (un Laravel con perfil backend no lleva ni el muro de diseño ni /propuestas).

  5. Lo instala y te dice qué ha dejado. Abre una sesión nueva al terminar: los muros y las skills se cargan al arrancar.

Herramienta Archivos
Claude Code CLAUDE.md + .claude/skills/ + .claude/hooks/ (los muros) + .claude/commands/ (/plan, /verificar, /brief, /propuestas…) + .claude/settings.json
Codex AGENTS.md (las mismas reglas) + .agents/skills/ (Codex las descubre solo)
Los dos senzu/plan/, senzu/devlog/, senzu/senzu.json (lo que elegiste, para actualizar después)

Si el proyecto ya tenía un CLAUDE.md o AGENTS.md propio, se respalda en CLAUDE.project.md. Revísalo y fusiona lo que quieras conservar.

2. Con el instalador de terminal (sin agente)

Sección titulada «2. Con el instalador de terminal (sin agente)»

Útil para instalar en varios proyectos seguidos o si prefieres un menú. Descarga Senzu una vez, en la misma carpeta que usa /instalar:

git clone https://github.com/petersonsenadevs/senzu.git ~/.senzu

(En PowerShell, ~ también vale: git clone https://github.com/petersonsenadevs/senzu.git $HOME\.senzu.)

Y ejecuta el instalador:

node $HOME/.senzu/tools/init.mjs

Sin argumentos abre un menú que comprueba los requisitos y pregunta la carpeta del proyecto, el stack (lo detecta solo; confirmas con Enter), las herramientas y qué es el proyecto (los perfiles de arriba, o elegir tú).

Sin menú, con los mismos resultados:

node $HOME/.senzu/tools/init.mjs --stack astro --path ./mi-proyecto --tools claude,codex
node $HOME/.senzu/tools/init.mjs --path ./mi-proyecto --perfil backend
node $HOME/.senzu/tools/init.mjs --path ./mi-proyecto --seleccion categorias --grupos front,motion
node $HOME/.senzu/tools/init.mjs --help # todas las opciones
  • --stack: laravel · next · astro · vue-ts · nuxt · sveltekit · wordpress · node-api · python-langgraph.
  • --tools: claude, codex, cursor, windsurf, antigravity (las que uses, separadas por coma).
  • --bundle core-3d-animation añade el paquete de animación y 3D (Three.js, GSAP, R3F, Motion).
  • --lang es pone en castellano los avisos de Senzu en ese proyecto (lo que dicen los muros, el arranque y el cierre). Sin él, salen en inglés. Ver Idioma.

Senzu habla en inglés por defecto y en castellano si se lo pides. El idioma se guarda en senzu/senzu.json ("lang": "es") y se conserva al actualizar:

node $HOME/.senzu/tools/init.mjs --path ./mi-proyecto --lang es
  • Afecta a los mensajes de Senzu: por qué bloquea un muro, el estado al empezar la sesión, los avisos de cierre. La variable SENZU_LANG=es (o en) manda sobre lo guardado, para una sesión concreta.
  • Cada comando tiene nombre en inglés y en castellano (/install es /instalar, /next es /siguiente…); la tabla de equivalencias está en comandos. --lang no los renombra.
  • El enrutador entiende peticiones en los dos idiomas.
  • No cambia el idioma en que te responde el agente (te contesta en el tuyo) ni el de las skills, que son instrucciones para el agente.

Modo ahorro de tokens (opcional; el menú lo pregunta al final): --ahorro deja el CLAUDE.md compacto (sin la lista de skills, que Claude ya carga por su cuenta, y con el devlog y el flujo de git en una línea, porque los muros los hacen cumplir). Ahorra en torno a un 30 % del CLAUDE.md; AGENTS.md no cambia. --sin-ahorro lo quita.

  • El plugin: en Claude Code, /plugin marketplace update senzu y actualiza el plugin desde /plugin. En Codex, desde la app.
  • Cada proyecto: vuelve a escribir /instalar en una sesión del proyecto, o en la terminal node $HOME/.senzu/tools/init.mjs --path ./mi-proyecto. Se actualiza ~/.senzu y se reinstala respetando lo que elegiste (guardado en senzu/senzu.json); si reduces la selección, se quita lo que ya no elegiste (tus skills propias no se tocan). Abre una sesión nueva después.

Perfil de front: se detecta del package.json real (un Astro sin React ni Tailwind queda como «Astro + CSS propio»). Para fijarlo a mano, edita senzu/senzu.json y vuelve a actualizar; lo manual gana:

"frontProfile": { "label": "Astro + CSS propio + GSAP + Three.js", "stacks": ["astro"] },
"frontProfileSource": "manual"

4. Solo las skills, sin proyecto (Codex, Cursor, Windsurf)

Sección titulada «4. Solo las skills, sin proyecto (Codex, Cursor, Windsurf)»

Para tener las skills en todos tus proyectos sin instalar los muros en ninguno (en PowerShell):

irm https://raw.githubusercontent.com/petersonsenadevs/senzu/main/tools/install.ps1 | iex

Instala en ~/.codex/skills y ~/.agents/skills el set por defecto (project-planner, skill-router, front-activation, ui-ux-pro-max, ui-verify, image-gen, gsap-scrolltrigger, threejs-webgl, code-quality). Repetir el comando actualiza. En Codex se invocan también a mano con $ui-ux-pro-max.

  • Claude Code (sesión nueva en el proyecto): escribe «haz la landing de X»: el aviso del enrutador debe sugerir ui-ux-pro-max, y /plan y /brief deben aparecer como comandos.
  • Codex (sesión nueva): pide «genera una imagen del producto flotando para el hero»: debe usar image-gen (en la app genera la imagen directamente; en la CLI usa tu OPENAI_API_KEY).
  • Verificación de interfaz: instala Playwright en el proyecto (npm i -D playwright && npx playwright install chromium) y prueba /verificar con la web en marcha. Deja en senzu/ui-verify/ las capturas de cada ancho, la anotada con los avisos numerados y, en móvil, la del menú abierto (fuera de git).

6. Vienes de dev-standards (la versión 1.x)

Sección titulada «6. Vienes de dev-standards (la versión 1.x)»

Senzu es dev-standards con otro nombre y la casa ordenada. Una vez por máquina y una vez por proyecto:

  1. Claude Code: quita el plugin y el marketplace viejos y añade los nuevos:
    /plugin uninstall dev-standards-all@dev-standards
    /plugin marketplace remove dev-standards
    /plugin marketplace add petersonsenadevs/senzu
    /plugin install senzu-all@senzu
  2. Codex: en la app, desinstala dev-standards-all, añade el marketplace senzu, instala senzu-all y aprueba los hooks otra vez (Codex los pide de nuevo con el nombre nuevo).
  3. Cada proyecto: sesión nueva y /instalar. Mueve devlog/, plan/, design-system/, conventions.*, .ui-verify/ y .dev-standards.json a senzu/ con git mv (el historial se conserva). Revisa después tus propios documentos si citaban esas rutas. Para no mover nada: --sin-migrar (todo sigue funcionando).

Siguen funcionando los nombres viejos: DEV_STANDARDS_* (ahora SENZU_*) y el comentario dev-standards-allow (ahora senzu-allow).

Quiero… Cómo
Instalar el plugin en Claude Code /plugin marketplace add petersonsenadevs/senzu → /plugin install senzu-all@senzu
Instalar o actualizar Senzu en un proyecto /instalar en una sesión del proyecto (o node $HOME/.senzu/tools/init.mjs --path <ruta>)
Instalar solo backend (sin nada de front) node $HOME/.senzu/tools/init.mjs --path <ruta> --perfil backend (también agente-ia, libreria, front, web)
Plugin para todo el equipo del repositorio claude plugin install senzu-all@senzu --scope project
Dejar que el agente haga push (no a main) en este proyecto node $HOME/.senzu/tools/init.mjs --path <ruta> --permitir push (push-main y commit-main para main)
Apagar un muro en este proyecto node $HOME/.senzu/tools/init.mjs --path <ruta> --apagar-hooks format-on-save (--encender-hooks los vuelve a encender)
CLAUDE.md compacto (modo ahorro) node $HOME/.senzu/tools/init.mjs --path <ruta> --ahorro
Avisos de Senzu en castellano node $HOME/.senzu/tools/init.mjs --path <ruta> --lang es (o SENZU_LANG=es para una sesión)
Añadir animación y 3D después node $HOME/.senzu/tools/init.mjs --path <ruta> --bundle core-3d-animation
Solo las skills, sin proyecto irm https://raw.githubusercontent.com/petersonsenadevs/senzu/main/tools/install.ps1 | iex
Usar tu propia copia de Senzu (para desarrollarlo) define SENZU_HOME con su ruta: /instalar la usará en vez de ~/.senzu

Clona el repo donde quieras y define SENZU_HOME con esa ruta. Scripts de mantenimiento: tools/check-skills.ps1 y tools/test-router.ps1 (el paquete está sano), tools/vendor-effects.ps1 -Missing (descarga la colección de efectos, que no va en git) y, en Windows, las versiones PowerShell del instalador (tools/init-project.ps1, tools/sync.ps1), que dan el mismo resultado que init.mjs.

Documentación en inglés: las guías llevan su .en.md al lado; lo generado (comandos, muros, skills, referencia, novedades, créditos) sale en inglés de tools/build-docs.ps1 con los datos de core/i18n/. Las skills y los comandos se traducen para la documentación en docs/en/skills/ y docs/en/comandos/ (no se instalan: el agente lee el original). Al cambiar uno, retradúcelo y séllalo: node tools/traducciones.mjs --sellar <nombre>; sin argumentos, el script dice cuáles faltan o se han quedado atrás, y tools/test-i18n.mjs falla si falta alguno.