Primer push Fase 0 de planificacion

This commit is contained in:
Carlos Tello
2026-10-13 15:01:04 -03:00
parent e2a5f1c1cd
commit 12c5649427
15 changed files with 1350 additions and 0 deletions
+50
View File
@@ -0,0 +1,50 @@
---
name: sdd
description: Úsala siempre que trabajes con Spec-Driven Development en OnEverControl (docs/constitution.md o cualquier archivo dentro de specs/) - redactar, revisar o cambiar specs, planes y tareas, o implementar y validar tareas de una spec.
---
# Spec-Driven Development (SDD) — OnEverControl
## Flujo
Constitución → Spec → Clarificación → Plan → Tareas → Implementación → Validación → Cambio.
- **Nunca pases a la siguiente fase sin la aprobación explícita del usuario.**
- **La spec manda:** si algo no está en la spec activa, no se implementa. Si falta una decisión, para y pregunta.
- **Un cambio de requisitos** se hace primero en la spec, luego en el plan y las tareas, y por último en el código.
- Cada spec vive en su carpeta: `specs/NNN-nombre/` con `spec.md`, `plan.md` y `tasks.md`.
- Al terminar cada fase o tarea, actualiza `MEMORY.md`.
## Estructura de la Spec (`spec.md`)
- **Contexto y objetivo:** Qué problema resuelve y por qué.
- **Usuarios / actores:** Quién lo usa (Operador de garita, Supervisor, etc.).
- **Historias de usuario:** `Como <rol>, quiero <acción> para <beneficio>`.
- **Requisitos funcionales en EARS (en español):**
- Ubicuo: `EL SISTEMA <comportamiento permanente>`.
- Con evento: `CUANDO <evento>, EL SISTEMA <respuesta>`.
- Con condición no deseada: `SI <condición de error/excepción>, ENTONCES EL SISTEMA <respuesta>`.
- Con estado: `MIENTRAS <estado>, EL SISTEMA <respuesta>`.
- **Requisitos no funcionales:** Rendimiento, diseño Touch-First, plataformas táctiles.
- **Casos límite:** Datos vacíos, desconexiones, terminal no autorizada, credenciales inválidas.
- **Fuera de alcance:** Lo que explícitamente no se implementa en esta iteración.
- **Criterios de finalización:** Tests en verde + demo verificable.
## Estructura del Plan (`plan.md`)
- Archivos y responsabilidades (Backend FastAPI + Frontend Node.js).
- Contratos de datos (Pydantic schemas y TypeScript interfaces).
- Decisiones técnicas justificadas con alternativas descartadas.
- Estrategia de tests (pytest para backend, vitest/playwright para frontend).
## Estructura de Tareas (`tasks.md`)
- Tareas pequeñas (máximo 20-30 minutos cada una), en orden de dependencia estricta.
- Formato:
```markdown
- [ ] **Tn. <Descripción de la tarea>.** RF-x, RF-y
- Hecho cuando: <comprobación verificable>.
```
## Implementación de Tareas
- **Una sola tarea cada vez:**
1. Escribir primero los tests y verificar que fallan (en rojo).
2. Escribir el código hasta que los tests pasen (en verde).
3. Ejecutar la suite de pruebas.
4. Marcar la tarea en `tasks.md`, actualizar `MEMORY.md` y parar.