Primer push Fase 0 de planificacion
This commit is contained in:
@@ -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.
|
||||
Reference in New Issue
Block a user