Plantillas de Proyecto
Cómo las plantillas convierten las buenas prácticas en arranques de proyecto reproducibles para agentes.
Las plantillas de proyecto convierten el aprendizaje acumulado en arranques reproducibles. Un proyecto nuevo no debería empezar desde cero, sino desde una base que ya incluye las decisiones de stack, las reglas, las skills y la documentación.
Plantilla de Next.js
La plantilla principal está orientada al frontend moderno:
| Tecnología | Uso |
|---|---|
| Next.js 15 | App Router y estructura moderna. |
| React 19 | Interfaz y componentes. |
| TypeScript | Tipado estricto. |
| Tailwind CSS v4 | Estilos. |
| shadcn/ui + Radix | Componentes accesibles. |
| Zustand | Estado en cliente. |
| Vitest + Testing Library | Tests. |
| Supabase | Backend opcional cuando hace falta. |
Skills Incluidas
La plantilla incluye skills para guiar al agente:
next-best-practices;react-best-practices;shadcn-ui;vitest-testing;frontend-design;project-conventions;supabase-postgres-best-practices.
Documentación Obligatoria
Cada proyecto generado debería incluir:
| Archivo | Propósito |
|---|---|
docs/README.md | Introducción al proyecto, rutas y stack. |
docs/code-reference.md | Referencia viva de interfaces, funciones y flujos. |
docs/architecture.md | Decisiones técnicas y estructura. |
AGENTS.md | Reglas para los agentes que trabajen en el repositorio. |
Flujo Esperado
Loading diagram…
Aprendizaje
Las plantillas son memoria operativa empaquetada. Cada vez que el sistema aprende una buena práctica, esta puede convertirse en una regla, una skill, un script o un archivo base, para que los próximos proyectos arranquen en mejor estado.