Instruction file imported from ergrato-dev/bc-tanstack (
.github/instructions/teoria-conventions.instructions.md). Copyright stays with the author.
Convenciones de Teoría — bc-tanstack Bootcamp
Límites de extensión (NON-NEGOTIABLE)
| Restricción | Valor |
|---|---|
| Líneas por archivo | Máximo 120 |
| Objetivos | 3–4 ítems |
| Secciones numeradas | 4–6 (## 1., ## 2.…) |
| Ejemplos de código por sección | Máximo 2 |
| Checklist final | 4 ítems como preguntas concretas |
| Referencias | 2–3 links |
Estructura obligatoria de cada archivo de teoría
# Título del Concepto
## Objetivos
- Objetivo 1 (verbo de acción)
- Objetivo 2
- Objetivo 3
## Diagrama
## 1. Primera sección
...
## 2. Segunda sección
...
## Checklist
- [ ] ¿Pregunta concreta 1?
- [ ] ¿Pregunta concreta 2?
- [ ] ¿Pregunta concreta 3?
- [ ] ¿Pregunta concreta 4?
## Referencias
- [Título](url)
- [Título](url)Qué NO incluir
- ❌ Tablas de comparación de más de 4 filas
- ❌ Bloques de código de más de 25 líneas
- ❌ Secciones "Herramientas recomendadas" (van en
4-recursos/) - ❌ Notas de compatibilidad extensas (una línea
>es suficiente) - ❌ Más de 2 ejemplos de código por sección
- ❌ Explicaciones de API completa (enlazar a docs oficiales de TanStack)
Idioma
- Texto explicativo: español
- Código TypeScript/React (nombres, props, variables, hooks): inglés
- Comentarios dentro del código: español
Numeración de archivos
Prefijo de dos dígitos: 01-, 02-, 03-…
Archivo de nivelación (si existe): 00-nivelacion.md