Files

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/ 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:
    - [ ] **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.