Cómo un Desarrollador Usó Claude Code con Linear y Discord para una Construcción en Solitario de 30 Días

El Proyecto y la Tecnología

Un desarrollador creó VGC Team Report (pokemonvgcteamreport.com), un constructor de informes de equipos para Pokémon competitivo (VGC) que genera análisis detallados con planes de enfrentamientos, cálculos de daño, niveles de velocidad e informes compartibles. El proyecto se construyó en 30 días de tardes y fines de semana con 274 commits, ~42,000 líneas de TypeScript, 25 funciones implementadas mediante Linear, 66 componentes React, 41 rutas API y 22 hooks personalizados. La tecnología incluyó Next.js 16 (App Router), React 19, TypeScript (modo estricto), Tailwind CSS v4, Clerk para autenticación, Neon para Postgres serverless y Vercel para alojamiento y despliegues.

El Flujo de Trabajo: Linear → Claude → Discord → Vercel

El desarrollador conectó Claude Code con Linear para seguimiento de tickets y Discord para notificaciones de compilación, creando una canalización de desarrollo automatizada. Una sesión típica seguía esta secuencia:

1. Claude ejecuta linear_get_in_progress para revisar el tablero de Linear en busca de tickets
2. Selecciona el ticket de mayor prioridad (errores primero)
3. Lee los archivos relevantes e implementa la función o corrección
4. Ejecuta tsc --noEmit && npm run build — si falla, Claude corrige los errores
5. Realiza commit con el formato de ID de ticket: VGC-42: Agregar gráfico de niveles de velocidad
6. Hace push a main
7. Publica un comentario en el ticket de Linear vía GraphQL con URL del commit y archivos modificados
8. Mueve el ticket a En Revisión
9. Llama a discord_notify_build — publica un embed en Discord #builds con commit, lista de archivos modificados y estado del despliegue
10. Vercel despliega automáticamente desde main
11. Pasa al siguiente ticket

Esto se implementó mediante un script bash linear.sh con funciones que Claude llama directamente: linear_get_in_progress (consulta GraphQL de Linear para tickets En Progreso), linear_move_issue (mueve un ticket a un nuevo estado), linear_comment_with_changes (publica un comentario con enlace del commit y archivos modificados), y discord_notify_build (envía un embed de Discord con información del commit y estado del despliegue).

El Manual de Operaciones CLAUDE.md

Un archivo CLAUDE.md en la raíz del repositorio proporciona contexto para cada sesión de Claude. Las secciones clave incluyen:

• Estrategia Git: Desarrollo basado en tronco con pushes directos a main para trabajo rutinario, ramas de características solo para cambios grandes o riesgosos, y npx tsc --noEmit && npm run build antes de cada push como no negociable
• Flujo de trabajo Linear: IDs de estado exactos para "En Progreso" y "En Revisión", cómo consultar e implementar tickets, commit con prefijo VGC-XX, publicar comentarios de commit, mover estados de tickets, con tickets de errores siempre trabajados primero
• Notificaciones Discord: Formato de función discord_notify_build con embeds diferentes para pushes directos a main vs flujos de PR
• Manejo de fallos: Fallo de compilación → corregir y reintentar, nunca hacer push de código roto; Fallo de API Linear → aún así hacer commit y push, notificar fallo al usuario; Ruptura en producción → git revert, push a main, notificar en Discord, mover ticket de vuelta
• Convenciones de código: Seguir patrones existentes, sin refactorizaciones improvisadas, mensajes de commit: VGC-XX: descripción para trabajo rastreado

Monitoreo Automatizado

Se configuraron dos trabajos cron de Vercel: una verificación diaria a las 9 AM para salud del sitio, escaneo de tickets estancados, auditoría SEO y salud de la base de datos (publica alertas en Discord solo si hay problemas), y un resumen semanal los viernes a las 5 PM para progreso en Linear, crecimiento de usuarios y actualizaciones de dependencias (siempre publica un resumen en Discord). El monitoreo de tiempo de actividad en tiempo real utilizó UptimeRobot con pings cada 5 minutos.

Lo que Funcionó

El desarrollador destacó varias prácticas efectivas: desarrollo basado en tronco con comprobaciones de tipos (tsc --noEmit && npm run build) asegurando que cada push a main se despliegue automáticamente en Vercel con un ciclo de retroalimentación de minutos; rastreabilidad de tickets Linear con cada commit vinculado a un ticket y cada ticket teniendo un comentario con URL del commit y archivos modificados; Discord como registro de auditoría con cada compilación publicada en #builds; y el archivo CLAUDE.md como el componente más valioso del proyecto para mantener contexto consistente entre sesiones.