user-story-standards
Buenas practicas, formato y ejemplos de historias de usuario para QA. Incluye principios INVEST, adaptacion por modo de prueba y guia de identificacion de historias.
SKILL.mdmastra-poc/.agents/skills/qa/user-story-standards/SKILL.md
GitHubUser Story Standards Skill
Estandares para redaccion de historias de usuario y criterios de aceptacion verificables.
Formato Base
## HU-NN: {Titulo descriptivo}
**Como** {rol del usuario}
**Quiero** {accion o funcionalidad}
**Para** {beneficio o valor de negocio}
### Criterios de Aceptacion
1. **CA-NN.1**: {Criterio verificable con condicion y resultado esperado}
2. **CA-NN.2**: {Criterio verificable}
3. **CA-NN.3**: {Criterio verificable}
### Datos de Prueba
- {Dato 1}: {valor especifico}
- {Dato 2}: {valor especifico}
### Notas
- {Observaciones del descubrimiento funcional}
Principios INVEST
- Independent: Cada historia se puede probar por separado
- Negotiable: Los detalles se pueden ajustar
- Valuable: Aporta valor al usuario/negocio
- Estimable: Se puede estimar el esfuerzo
- Small: Tamanio adecuado para una iteracion
- Testable: Criterios verificables con Si/No
Adaptacion por Modo de Prueba
Modo positivos
- Criterios orientados a flujos exitosos y resultados correctos
- NO incluir criterios de error ni de borde
- Minimo 3 criterios Happy Path por historia
Modo negativos
- Criterios orientados al manejo de errores y datos invalidos
- NO incluir criterios de flujo exitoso
- Minimo 3 criterios de error por historia
Modo borde
- Criterios orientados a valores limite y condiciones extremas
- Incluir limites inferiores, superiores, cadenas vacias, caracteres especiales
- Minimo 3 criterios de borde por historia
Modo e2e
- Una unica historia por flujo de negocio principal
- Criterios describen pasos del flujo completo en secuencia
- Minimo 1 historia E2E; maximo 2
Guia de Identificacion de Historias
| Funcionalidad observada | Tipo de historia |
|---|---|
| Formulario de busqueda | Consulta/Busqueda de {entidad} |
| Formulario de registro/creacion | Creacion de {entidad} |
| Tabla/listado de datos | Visualizacion de {entidad} |
| Botones de edicion en filas | Edicion de {entidad} |
| Menu de navegacion con secciones | Una historia por seccion funcional principal |
| Login/autenticacion | Acceso al sistema |
| Filtros y ordenamiento | Gestion de {entidad} |
Criterios de Calidad
- Criterios verificables con Si/No
- Datos especificos (no genericos)
- Enfoque por modo estricto
- Lenguaje de negocio, no tecnico
- Numeracion consecutiva: HU-01, HU-02
- Criterios: CA-{HU}.{n}