PTENES
4.3 ~45 min · Intermedio

⌨️ Slash commands y workflows

Crea atajos reutilizables y pipelines deterministas que orquestan varios agentes con un solo comando.

PIPELINE (secuencial) PARALELO (fan-out) Step 1 investigación Step 2 redacción Step 3 revisión ~9 min en total (3 × 3 min) Activador /workflow Worker A investigación Worker B redacción Worker C revisión Resultado agregado ~3 min en total (en paralelo) — 3× más rápido

⌨️ Qué son los slash commands

Los comandos slash son atajos de texto que se expanden a prompts completos. Al escribir /review en Claude Code, el harness expande a un prompt de revisión de código configurado.

Los comandos nativos incluyen /help, /clear, /config, /compact, /doctor. Las skills agregan sus propios comandos, como /code-review, /security-review, /schedule.

// Comandos nativos más útiles de Claude Code
/help          → lista todos os comandos disponíveis
/clear         → limpa o histórico da sessão atual
/compact       → comprime o contexto (reduz tokens usados)
/config        → abre configurações interativas
/doctor        → diagnóstico do ambiente
/status        → estado atual do agente

// Skills instaladas adicionam comandos:
/code-review   → revisão de código do diff atual
/security-review → análise de segurança
/schedule      → agendamento de tarefas recorrentes
/loop          → repete comando em intervalo

🛠️ Crear tus propios slash commands

Los comandos personalizados son archivos .md dentro de .claude/commands/. El nombre del archivo (sin extensión) se convierte en el comando. El contenido del archivo es el prompt expandido.

Puedes usar variables especiales: $ARGUMENTS (argumentos pasados después del comando), $FILE (archivo actual), $SELECTION (texto seleccionado).

// .claude/commands/component.md — comando /component
Crie um componente React TypeScript chamado $ARGUMENTS.

Requisitos:
- Arquivo em src/components/$ARGUMENTS/$ARGUMENTS.tsx
- Props interface tipada
- Export default
- Storybook em $ARGUMENTS.stories.tsx
- Teste em $ARGUMENTS.test.tsx

Siga os padrões do projeto (verifique componentes existentes).
Use a paleta de cores do design system em src/tokens.

📁 Alcance local (.claude/commands/)

Específico del proyecto. Se registra en el repositorio con un commit. Todo el equipo usa los mismos comandos. Ideal para los estándares del proyecto.

.claude/commands/component.md → /component
.claude/commands/migrate.md → /migrate
.claude/commands/release.md → /release

🌐 Alcance global (~/.claude/commands/)

Se aplica a todos los proyectos. Útil para preferencias personales. No se comparte con el equipo.

~/.claude/commands/standup.md → /standup
~/.claude/commands/summarize.md → /summarize

💡 Consejos para nombrar

  • • Nombres cortos e imperativos: /fix, /test, /deploy
  • • Usa kebab-case para varias palabras: /code-review, /add-feature
  • • Documenta con un comentario al inicio del .md:

🔄 Workflows deterministas

Un workflow determinista es una secuencia predefinida de steps donde cada paso tiene una entrada, una salida y un comportamiento deterministas. Ejecutar el mismo workflow con los mismos inputs siempre produce el mismo resultado.

Esto contrasta con el uso libre del agente, donde cada ejecución puede seguir un camino distinto. Los workflows cambian flexibilidad por previsibilidad, algo esencial en CI/CD y procesos críticos.

Ejemplo: workflow de lanzamiento

1

Verificar las pruebas

~2 min

Ejecuta la suite completa de pruebas. Si falla, el workflow se detiene y notifica.

2

Actualización de versión

~30s

Incrementa la versión en package.json según el tipo (patch/minor/major)

3

Generar CHANGELOG

~1 min

Analiza los commits desde la última etiqueta y genera entradas en CHANGELOG.md

4

Crear un PR y una tag

~1 min

Crea la branch release/vX.Y.Z, abre un PR con el changelog y crea una tag de git

🔀 Pipeline vs Parallel

🔗 Pipeline (secuencial)

Steps encadenados: la salida de A es la entrada de B. Úsalo cuando haya dependencia de datos entre steps.

  • → Fácil de depurar (error localizado en el paso)
  • → Predecible y auditable
  • → Más lento (N pasos × tiempo/paso)
  • → Ejemplo: compilar → probar → publicar

⚡ Paralelo (fan-out)

Steps simultáneos sin dependencias. Úsalos cuando las tareas sean independientes.

  • → Mucho más rápido (N pasos × tiempo/paso_más_lento)
  • → Requiere una barrera de sincronización
  • → Más difícil de depurar (error en cualquier worker)
  • → Ejemplo: lint + pruebas + análisis simultáneos
// .claude/commands/release.md — combina pipeline y ejecución en paralelo
## Workflow de release — versão $ARGUMENTS

FASE 1 (paralelo): Execute simultaneamente:
  - Verificar testes: npm test
  - Verificar lint: npm run lint
  - Verificar tipos: npm run typecheck

Aguarde todos completarem. Se qualquer um falhar, PARE e reporte.

FASE 2 (pipeline):
  1. Bump version para $ARGUMENTS em package.json
  2. Gere CHANGELOG com commits desde a última tag
  3. Commit: "chore: release $ARGUMENTS"
  4. Crie tag: git tag v$ARGUMENTS
  5. Abra PR com título "Release $ARGUMENTS"

Reporte ao final: versão, commits incluídos, link do PR.

🎯 Cuándo usar workflows

✓ Usa workflows CUANDO

  • ✓ La tarea se repite semanalmente o con mayor frecuencia
  • ✓ Involucra varios agentes o herramientas
  • ✓ Necesita poder ser ejecutada por otros miembros del equipo
  • ✓ El resultado debe ser auditable y reproducible

✗ No crees un workflow CUANDO

  • ✗ Es una tarea puntual o exploratoria
  • ✗ El proceso todavía está cambiando (estabilízalo antes)
  • ✗ La tarea es creativa y se beneficia de la variación
  • ✗ El costo de mantener el workflow supera el beneficio

📊 Regla de frecuencia

Si vas a hacer la misma tarea más de 5 veces, vale la pena crear un comando slash. Si vas a hacer más de 20 veces, vale la pena crear un workflow completo con pipeline y subagents.

🎭 Orquestar múltiples agentes

Uno metaagente puede invocar workflows completos como subtareas. Esto crea una jerarquía: meta-agente → workflows → subagents. Cada nivel tiene responsabilidades bien delimitadas.

🏗️ Jerarquía de 3 niveles

Nivel 1: Meta-agente (estrategia)
Nivel 2: Workflows (tácticas)
Nivel 3: Subagents (ejecución)

📋 Principios de composición

  • → Interfaces claras: inputs/outputs definidos
  • → Reemplazable: cada nivel se puede cambiar
  • → Probable: cada workflow se puede probar de forma aislada
  • → Observable: los logs se propagan por la jerarquía

🎯 Resumen del Módulo 4.3

✓
Comandos slash — atajos de texto que se expanden a prompts completos
✓
Comandos personalizados — archivos .md en .claude/commands/, variables $ARGUMENTS
✓
Workflows deterministas — secuencias predefinidas, idempotentes y auditables
✓
Pipeline frente a paralelo — dependencia de datos frente a independencia total
✓
Cuándo usar — tareas repetidas, equipo, auditabilidad

Siguiente módulo:

4.4 — ⏰ Cron y tareas recurrentes: agentes que no duermen