Dev Commands

Commands para tareas de desarrollo y productividad.

/plan

Planifica antes de implementar con entrevista estructurada.

Uso 

/plan

¿Qué hace?

  1. Captura la idea del usuario
  2. Hace preguntas para refinar requerimientos
  3. Documenta el spec en /docs/wip/
  4. Crea tareas con TodoWrite
  5. Confirma antes de empezar a implementar

Output 

Plan de implementación creado:
- Documento: /docs/wip/dark-mode-plan.md
- Tareas creadas: 7

¿Empezamos con la primera tarea?

Relacionado

/fix

Corrige el error más reciente automáticamente.

Uso 

/fix

¿Qué hace?

  1. Detecta el último error (terminal, tests, build)
  2. Analiza el stack trace
  3. Identifica la causa raíz
  4. Aplica la corrección
  5. Verifica que el error se resolvió

Contexto detectado

  • Errores de compilación/build
  • Test failures
  • Runtime exceptions
  • Lint errors
  • Type errors

Ejemplo 

Error detectado: TypeError: Cannot read property 'name' of undefined
Archivo: src/components/UserCard.tsx:15

Causa: user puede ser null pero no se verifica
Fix aplicado: Added null check before accessing user.name

Verificando... ✓ Error resuelto

/check

Corre validaciones del proyecto (lint, types, tests, build).

Uso 

/check

¿Qué hace?

  1. Detecta scripts disponibles en package.json
  2. Ejecuta en orden: lint → typecheck → test → build
  3. Reporta resultados de cada paso
  4. Ofrece corregir errores encontrados

Scripts detectados

Script Descripción
lint ESLint, Prettier
typecheck TypeScript compiler
test Vitest, Jest
build Next.js, Vite build

Output 

Running project checks...

✓ lint passed
✓ typecheck passed
✗ test failed (2 tests)
  - UserCard.test.tsx: assertion failed
  - api.test.ts: timeout

Build skipped (tests failed)

¿Quieres que corrija los tests fallidos?

/interview

Entrevista para refinar specs y planes.

Uso 

/interview

¿Qué hace?

  1. Hace preguntas estructuradas sobre requerimientos
  2. Profundiza en respuestas vagas
  3. Identifica edge cases
  4. Documenta decisiones
  5. Genera spec refinada

Áreas cubiertas

  • Funcionalidad deseada
  • UI/UX esperada
  • Datos y persistencia
  • Integraciones
  • Restricciones técnicas
  • Prioridades (MVP vs nice-to-have)

/prototype

Crea POCs rápidos en múltiples lenguajes.

Uso 

/prototype
/prototype in:python
/prototype in:typescript

¿Qué hace?

  1. Crea código funcional mínimo
  2. Prioriza velocidad sobre perfección
  3. Incluye ejemplos de uso
  4. Documenta limitaciones

Características

  • Código ejecutable inmediatamente
  • Sin setup complejo
  • Demuestra la idea core
  • Fácil de iterar

/summary

Resume conversaciones y contexto.

Uso 

/summary

¿Qué hace?

  1. Analiza la conversación actual
  2. Extrae puntos clave discutidos
  3. Lista decisiones tomadas
  4. Documenta próximos pasos pendientes

Output 

## Resumen de la sesión

### Discutido
- Implementación de dark mode
- Estrategia de persistencia de preferencias
- Componentes afectados

### Decisiones
- Usar CSS variables para theming
- Persistir en localStorage
- Detectar preferencia del sistema

### Pendiente
- Implementar ThemeContext
- Agregar toggle en settings
- Tests

Referencia rápida 

# Planificación
/plan        # Planifica con entrevista

# Corrección
/fix         # Corrige último error

# Validación
/check       # Corre lint + types + tests + build

# Specs
/interview   # Entrevista para refinar specs

# Prototipos
/prototype          # POC en lenguaje del proyecto
/prototype in:python # POC en Python

# Resumen
/summary     # Resume la conversación