maxirest-claude-setup

CLI para instalar y mantener actualizados los agentes y la configuración de Claude Code para el equipo Maxirest.

1️⃣ Instalación (una sola vez)

npm install -g maxirest-claude-setup
maxirest-claude install

Esto instala automáticamente:

• ✅ Todos los agentes de Maxirest en ~/.claude/agents/
• ✅ Todas las skills en ~/.claude/skills/
• ✅ Documentación de referencia en ~/.claude/maxirest/
• ✅ Archivo base CLAUDE.md en tu home (si no existe)
• ✅ Hook de seguridad DB en ~/.claude/hooks/ — protege contra operaciones destructivas (DELETE, DROP, TRUNCATE)

2️⃣ Verificar que funciona

Abrí Claude Code en cualquier proyecto:

claude

Y probá /agents — deberías ver todos los agentes de Maxirest disponibles.

3️⃣ Auto-actualización al inicio (recomendado)

Para que el CLI chequee actualizaciones cada vez que abrís la terminal, agregá esto a tu ~/.zshrc o ~/.bashrc:

macOS con zsh (la mayoría):

echo 'maxirest-claude update 2>/dev/null' >> ~/.zshrc
source ~/.zshrc

Linux/bash:

echo 'maxirest-claude update 2>/dev/null' >> ~/.bashrc
source ~/.bashrc

🔄 Actualizar manualmente

maxirest-claude update

El CLI también se actualiza solo al ejecutarse: si hay una versión nueva en npm, se actualiza antes de correr.

Comandos

| Comando | Descripción | |---------|-------------| | install | Instala agentes y configuración | | update | Actualiza todo a la versión más reciente | | version | Muestra la versión instalada | | help | Muestra la ayuda |

Skills incluidos

Los skills están organizados por stack tecnológico en ~/.claude/skills/:

| Directorio | Contenido | |---|---| | angular-frontend-expert/ | frontend-design, web-artifacts-builder | | angular-microfrontend-expert/ | Workflows MFE con Native Federation | | spring-boot-backend/ | api-decision-tree, asignacion-roles, mro-exceptions, dependency-version-manager, limpiar-proyecto-back, crear-usuario-mro | | devops-deployment-expert/ | maxirest-k8s, server-monitoring | | mobile/ | nueva-feature-kmp-back/front/fullstack, kmp-navigation-mapper, kotlin-multiplatform-expert, formatter-screen-kmp | | qa-api-testing-expert/ | webapp-testing, design-review-master | | generic/ | pdf, docx, pptx, xlsx, cartographer, jira-connector, session-retrospective, start-session, skill-creator, prd, ralph, mcp-builder, y más |

Hook de seguridad DB

A partir de v1.2.0, el installer registra automáticamente un hook PreToolUse que intercepta cualquier operación destructiva sobre la base de datos:

• Detectado: DELETE FROM, DROP TABLE/DATABASE/SCHEMA, TRUNCATE, ALTER TABLE … DROP
• Avisa si falta cláusula WHERE en un DELETE
• Requiere escribir Acepto consecuencias en el terminal para proceder
• Compatible con Windows (Git Bash) y Unix/Mac

¿Cómo se publican nuevas versiones?

Automático. Cada vez que el equipo hace push a main con cambios en agents/, skills/ o Claude/, GitHub Actions publica una nueva versión en npm. Los devs reciben la actualización la próxima vez que ejecuten el CLI.

Ver el historial completo de cambios en CHANGELOG.md.