--- 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 , quiero para `. - **Requisitos funcionales en EARS (en español):** - Ubicuo: `EL SISTEMA `. - Con evento: `CUANDO , EL SISTEMA `. - Con condición no deseada: `SI , ENTONCES EL SISTEMA `. - Con estado: `MIENTRAS , EL SISTEMA `. - **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. .** RF-x, RF-y - Hecho cuando: . ``` ## 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.