Contexto
Tenía 20 proyectos activos con stacks inconsistentes: Next.js 14, 15 y 16 corriendo en paralelo, Tailwind v3 en la mayoría y v4 en los más nuevos, y bases de datos mezcladas sin criterio claro (MongoDB, Supabase, Prisma, Airtable). Cada vez que abría un proyecto distinto había que reconstruir contexto: ¿cómo se configura Tailwind acá? ¿este tenía auth o no?
Además, descubrí vercel-labs/opensrc, una herramienta para darle a los agentes IA el código fuente real de las librerías (no solo los tipos).
Qué hicimos
1. Fijamos el stack base para todos los proyectos:
Next.js 16 · React 19 · Tailwind v4 · TypeScript 5
La DB queda como única variable, se decide al cotizar según tipo de proyecto.
2. Clonamos e instalamos opensrc globalmente:
gh repo clone vercel-labs/opensrc
cd opensrc && npm install && npm run build
npm install -g .
El CLI queda disponible en PATH. Los sources se corren por proyecto (opensrc next react tailwindcss desde el root).
3. Creamos templates por tipo de proyecto en proyectos/internos/_PLANTILLA/ y proyectos/clientes/_PLANTILLA/:
_BASE/— fuente de verdad del stack (stack.md, CLAUDE.md, opensrc.md)landing/— sin auth, sin DB, SEO-firstsaas/— con auth, rutas protegidas, DB pendientedirectorio/— listados con búsqueda y filtros
Cada template incluye CLAUDE.md, checklist.md, README.md y .estado.md.
4. Documentamos opensrc en _BASE/opensrc.md con instrucciones de uso, paquetes recomendados por tipo y flujo de trabajo.
Resultado
- Stack unificado documentado y listo para usar en cualquier proyecto nuevo
- 3 templates completos con checklists concretas (landing, saas, directorio)
opensrcinstalado globalmente, documentado, listo para correr por proyecto- Estructura espejada en
internos/yclientes/
Lo que quedó pendiente: correr opensrc dentro de cada proyecto activo existente — se hará proyecto por proyecto según necesidad, no de una vez.
Aprendizaje clave
La fricción más costosa no es la técnica — es la fricción de contexto. Cada vez que tenés que pensar "¿cómo era acá?" estás perdiendo energía que debería ir a construir. Unificar el stack elimina esa categoría entera de preguntas.
opensrc resuelve el mismo problema pero para los agentes IA: en vez de trabajar solo con tipos, tienen la implementación real. La diferencia en calidad de respuestas es notable en librerías como Next.js donde el comportamiento interno importa tanto como la API pública.