Skip to content

Referencia completa

Todos los slash commands, agentes, hooks y variables de entorno disponibles en una sola página.


Slash commands (dentro de Claude Code)

Gestión de sesión

ComandoQué haceCuándo
/compactLibera contexto sin perder el hilo de trabajoDespués de explorar mucho código

Memoria automática

La memoria del proyecto se gestiona automáticamente por el Stop hook (session-consolidate.sh). Al terminar la sesión, el hook revisa el trabajo y actualiza .claude/memory/ sin que tengas que hacer nada. Claude también lee .claude/CLAUDE.md al iniciar — mantén ese archivo actualizado para retomar el contexto rápido.


Planificación y desarrollo

ComandoQué haceCuándo
/plan "descripción"Genera plan con fases, dependencias y riesgos antes de escribir códigoAntes de cualquier feature
/tddGuía el ciclo RED → GREEN → REFACTOR paso a pasoAl implementar features con tests
/tdd "feature"Inicia TDD sobre un feature específicoAl empezar una tarea nueva

Ejemplo:

text
/plan "añadir autenticación Sanctum a la API"
→ Fase 1: Instalar laravel/sanctum, publicar config, migrar tabla
→ Fase 2: Endpoints login/logout/me
→ Fase 3: Middleware auth:sanctum en rutas protegidas
→ Riesgos: CORS en SPA, stateful domains para cookies

/tdd "endpoint POST /api/login"
→ Escribe primero: tests/Feature/Auth/LoginTest.php
→ Test debe fallar (RED) → implementa → pasa (GREEN) → refactoriza

Revisión de código

ComandoQué haceCuándo
/jedi-review3 subagentes en paralelo: Kent Beck + Martin Fowler + Mike ActonDespués de escribir código importante
/security-scanAuditoría de seguridad enfocada en OWASP Top 10Antes de cada release
/code-reviewReview rápido de calidad y patronesDespués de cambios menores

Salida típica de /jedi-review:

text
[KENT BECK] El controlador está limpio. Pero login/logout juntos violan SRP.
[MARTIN FOWLER] Línea 23: $request->all() — usar siempre $request->validated().
[MIKE ACTON] createToken('token') sin nombre descriptivo — usar createToken('spa-web').

Veredicto: B — funcional con 3 correcciones antes de PR.
Top 3 acciones: 1) LoginRequest, 2) createToken('spa-web'), 3) AuthService

Post-deploy y workflows especiales

ComandoQué haceCuándo
/canary-watch URLPlaywright comprueba errores de consola, peticiones fallidas, tiempos de cargaDespués de desplegar
/workflow featureEjecuta pipeline completo: planner → tdd-guide → code-reviewer → security-reviewerFeatures nuevos
/workflow hotfixPipeline rápido: tdd-guide → security-reviewer → auditFixes urgentes
/workflow refactorPipeline de refactor: planner → code-simplifier → code-reviewerRefactorizaciones

Ejemplo:

text
/canary-watch https://blog-api.tudominio.com
→ Verificando consola JS... ✅ 0 errores
→ Verificando red... ✅ 0 requests fallidas
→ Tiempo de carga: 1.2s ✅
→ Veredicto: DEPLOY OK

Selección de modelo

ComandoQué hace
/model opusCambia a Opus 4.6 — para decisiones arquitectónicas complejas
/model sonnetCambia a Sonnet 4.6 — trabajo general (valor por defecto)
/model haikuCambia a Haiku 4.5 — tareas simples, más económico
/costMuestra el gasto de tokens en la sesión actual

Comandos universales (disponibles en todos los stacks)

ComandoQué hace
/continuous-learningExtrae patrones de la sesión y los persiste como skills
/continuous-learning-v2v2 con confidence scoring y project-scoped instincts
/ckMemoria persistente per-project, git-aware
/plankton-code-qualityAuto-format y lint en cada edición vía hooks
/strategic-compactSugiere /compact en puntos lógicos de la sesión
/security-scanEscanea .claude/ por vulnerabilidades y misconfigs
/context-budgetAudita consumo de tokens del contexto
/skill-complyVerifica que skills y rules se siguen realmente
/skill-stocktakeAudita calidad de skills instaladas
/prompt-optimizerMejora prompts del developer
/repo-scanAuditoría cross-stack del código fuente
/product-lensDiagnóstico de producto pre-feature
/token-budget-advisorControla profundidad y longitud de respuestas
/team-builderCompone equipos de agentes para tareas paralelas
/rules-distillExtrae principios cross-cutting → nuevas rules

Agentes especializados

Claude los activa automáticamente o puedes pedirlos explícitamente:

text
"Usa el agente architect para diseñar el módulo de pagos"
"Lanza code-reviewer y security-reviewer en paralelo sobre los cambios de auth"

Agentes principales (22 instalados globalmente)

AgentePropósitoSe activa automáticamente cuando...
plannerPlan de implementación con fases y riesgosSolicitas un feature complejo
architectDiseño de sistemas y decisiones técnicasHay una decisión arquitectónica
tdd-guideTDD enforcement RED→GREEN→REFACTOREscribes features nuevas o corriges bugs
code-reviewerCalidad, patrones, best practicesEscribes o modificas código
security-reviewerVulnerabilidades OWASP Top 10Tocas auth, inputs de usuario, pagos
typescript-reviewerIssues específicos de TypeScript/JSEn proyectos TypeScript
python-reviewerIssues específicos de PythonEn proyectos Python
database-reviewerQueries, schemas, índices, migracionesEscribes SQL o modelos de datos
build-error-resolverFix de errores de build y TypeScriptCuando el build falla
e2e-runnerTests end-to-end con PlaywrightPara flujos críticos de usuario
performance-optimizerBottlenecks, bundle size, memoriaAl investigar rendimiento
refactor-cleanerDead code, duplicados, análisis con knip/depcheckPara mantenimiento de código
doc-updaterREADMEs, codemaps, documentaciónAl actualizar docs
silent-failure-hunterDetecta catch vacíos, fallbacks peligrosos, errores silenciadosAntes de release
pr-test-analyzerAnaliza coverage de tests en un PRAntes de hacer merge
comment-analyzerEvalúa calidad de comentarios: precisión, obsolescenciaEn archivos de lógica crítica
conversation-analyzerAnaliza la sesión para detectar fricción, correcciones repetidasCuando la sesión se siente atascada
code-simplifierRefactoriza para legibilidad sin cambiar comportamientoDespués de que una feature funciona
loop-operatorEjecuta loops multi-paso con detección de bloqueosPara tareas de 5+ pasos secuenciales
memory-consolidatorConsolida .claude/memory/ cuando crece demasiadoCuando un archivo supera 150 líneas
docs-lookupBusca documentación actualizada de librerías y APIs vía Context7Al necesitar docs de una lib específica
github-orchestratorPublica resultados de agentes en GitHub: comentarios en PRs, issues desde auditoríasAl publicar reviews o reportes en GitHub

Hook de sesión

session-consolidate.sh

Se ejecuta automáticamente al terminar cada sesión de Claude Code (Stop hook).

Qué hace:

  1. Revisa git log, git diff y git status del proyecto
  2. Identifica decisiones, problemas resueltos y reglas de dominio de la sesión
  3. Escribe o actualiza archivos en .claude/memory/

Archivos que puede crear/actualizar:

  • architecture.md — Decisiones de arquitectura y por qué
  • domain-rules.md — Reglas de negocio explicadas en la sesión
  • auth.md — Configuraciones de autenticación
  • Cualquier archivo temático relevante

Formato de cada archivo en .claude/memory/:

markdown
---
name: nombre-descriptivo
description: una línea — qué contiene este archivo
type: project
updated: YYYY-MM-DD
---

- Decisión tomada — por qué — cuándo revisar
- Problema encontrado y solución
- Configuración o integración nueva

Regla importante: El hook solo ve commits y cambios de git. Si tomaste decisiones importantes en la conversación sin hacer commit, escríbelas manualmente en .claude/memory/ antes de terminar la sesión — o dile a Claude "guarda esta decisión en la memoria del proyecto".


Memoria del proyecto

Los archivos en .claude/memory/ son la memoria persistente del proyecto:

text
blog-api/.claude/memory/
├── architecture.md     ← Decisiones de stack y arquitectura
├── auth.md             ← Configuración de Sanctum, CORS, tokens
├── domain-rules.md     ← Reglas de negocio (posts, comentarios, usuarios)
└── index.md            ← Índice generado por memory-consolidator

Se versiona con git — todos los desarrolladores del equipo comparten la misma memoria.

Cuándo consolidar: Cuando un archivo supera 150 líneas o el directorio supera 600 líneas en total.

text
"Usa el agente memory-consolidator para consolidar .claude/memory/"

Variables de entorno (settings.json)

Configuradas en ~/.claude/settings.json bajo env:

VariableValor por defectoEfecto
MAX_THINKING_TOKENS10000Límite de tokens para razonamiento interno
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE50Compacta contexto al 50% (por defecto 80%)
CLAUDE_CODE_SUBAGENT_MODELhaikuModelo para subagentes (más económico)

Estructura de archivos clave

text
proyecto/
├── .claude/
│   ├── CLAUDE.md              ← Contexto del proyecto (se lee al iniciar cada sesión)
│   ├── settings.json          ← Modelo, tokens, permisos locales
│   ├── memory/                ← Memoria persistente (versionada en git)
│   │   ├── architecture.md
│   │   ├── auth.md
│   │   └── domain-rules.md
│   ├── commands/              ← Slash commands standalone (/nombre)
│   │   ├── jedi-review.md
│   │   ├── git-workflow.md
│   │   └── ...
│   ├── agents/                ← Agentes COMPILADOS con skills embebidas
│   │   ├── planner.md         ← Incluye skills del stack dentro del agente
│   │   ├── code-reviewer.md
│   │   └── ...
│   ├── pipeline.yaml          ← Workflows orquestables (/workflow feature)
│   └── rules/
│       ├── common/            ← Reglas universales — siempre activas
│       └── stack/             ← Reglas del stack + domain elegidos — siempre activas
│           ├── laravel.md
│           └── react.md

~/.claude/                     ← Instalación global (make install)
├── settings.json              ← Configuración global con Stop hook
├── agents/                    ← 22 agentes base disponibles en todos los proyectos
├── rules/common/              ← Reglas comunes en todos los proyectos
└── hooks/
    └── session-consolidate.sh ← Se ejecuta al terminar cada sesión

Domain overlays

Los domains añaden conocimiento de dominio a cualquier tech stack sin reemplazar sus skills:

DomainQué añade
healthcareEMR, CDSS, HIPAA compliance, PHI protection
ai-agentMulti-agent systems, evals, LLM pipelines, cost optimization
content-creatorEscritura, social media, video, newsletters
supply-chainLogistics, inventory, carrier management, customs
bash
# Usar un domain overlay al inicializar
make init-project STACK=python-api DOMAIN=healthcare PROJECT=/ruta

El domain merge skills extra en los agentes del stack. Por ejemplo, DOMAIN=healthcare añade healthcare-emr-patterns al agente architect además de los skills que ya tiene del stack python-api.


Resumen rápido — cuándo usar cada cosa

  • Voy a implementar algo: /plan "descripción"
  • Escribo código nuevo: /tdd + agente tdd-guide
  • Terminé de escribir código: /jedi-review o /code-review
  • Código de auth o pagos: /security-scan + agente security-reviewer
  • Deployo a producción: /canary-watch URL
  • El contexto está lleno: /compact
  • Memoria creció demasiado: Agente memory-consolidator
  • Cierro la sesión: nada, el Stop hook actualiza la memoria

Claude God Mode Template