# Primeros pasos con Devin — Equipo de Ingeniería de Acme

## 1. Iniciar una sesión
| Método | Cuándo usarlo | Ejemplo |
|--------|-------------|--------|
| **Slack** — mensaje a @Devin | Tareas rápidas y acotadas | "Corrige el CI fallido en api-service" |
| **Aplicación web** — app.devin.ai | Tareas más largas que requieren archivos adjuntos o playbooks | Adjuntar un playbook de migración + archivo de especificaciones |

## 2. Cómo escribir prompts efectivos
Devin funciona mejor con solicitudes específicas y acotadas. Incluye siempre
la ruta del archivo, qué está fallando y cuándo comenzó el problema.

❌ "Corrige el bug de inicio de sesión"
✅ "El formulario de inicio de sesión en src/pages/Login.tsx devuelve un 401 para credenciales
   válidas desde la rotación de clave JWT del viernes. Revisa el
   middleware de autenticación en src/middleware/auth.ts."

## 3. Integración con Linear
Ve a Configuración > Conexiones > Linear y autoriza. Una vez
conectado, Devin puede:
- Tomar automáticamente los tickets que se le asignen
- Actualizar el estado del ticket mientras trabaja
- Vincular PRs al ticket de Linear de origen

Consulta la guía de configuración completa: docs.devin.ai/integrations/linear

## 4. Playbooks para tareas recurrentes
Crea prompts reutilizables en Configuración > Playbooks > Crear nuevo.
Para nuestra migración de Express a Fastify, el playbook debe incluir:
- La ruta del módulo de destino (p. ej., src/services/payments/)
- Comandos de prueba: npm run test:api && npm run test:integration
- Pasos de reversión si la migración rompe consumidores dependientes

## 5. Conocimiento — Enseñando a Devin nuestras convenciones
Agrega las convenciones del equipo en Configuración → Recursos → Conocimiento → Crear conocimiento.

Ejemplo de entrada:
  Disparador: "trabajando en rutas de API"
  Contenido: "Usamos Fastify, no Express. Todas las rutas están en
  src/routes/. Ejecuta npm run test:api antes de hacer commit.
  Las respuestas de error deben usar la clase ApiError de src/lib/errors.ts."