2.6 KiB
2.6 KiB
name, description
| name | description |
|---|---|
| sdd | Ú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/conspec.md,plan.mdytasks.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>.
- Ubicuo:
- 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:
- [ ] **Tn. <Descripción de la tarea>.** RF-x, RF-y - Hecho cuando: <comprobación verificable>.
Implementación de Tareas
- Una sola tarea cada vez:
- Escribir primero los tests y verificar que fallan (en rojo).
- Escribir el código hasta que los tests pasen (en verde).
- Ejecutar la suite de pruebas.
- Marcar la tarea en
tasks.md, actualizarMEMORY.mdy parar.