work-define
Skill: Historia de usuario
Guía para crear o actualizar historias de usuario en el repo del producto.
Alcance de una US: El
README.mdes un documento funcional. Registra el valor para el usuario, los criterios de aceptación (lista plana con idsAC-XXX, categoría entre paréntesis y enunciado RFC 2119) y el estado de avance. El detalle de implementación (DTOs, endpoints, esquemas) va endocs/specs/technical-docs/— creado y mantenido por el skilldesign-define, nunca directamente desde aquí — o en tareasTK-XXX, nunca en la narrativa de la historia. Los documentos técnicos no son parte de la descripción funcional; se enlazan desde la sección Referencias de la US y pueden citarse para justificar criterios de INVEST o condiciones del DoR.
La plantilla canónica está en assets/user-story-template.md (léela antes de escribir cualquier US).
Mapa de referencias
Carga el archivo correspondiente cuando vayas a ejecutar la tarea; el detalle íntegro vive en references/.
| Necesitas… | Archivo |
|---|---|
| Flujo paso a paso de crear y actualizar, cómo preguntar al usuario, validación antes de crear, checklist completo, ejemplos, anti-patrones y handoffs del ciclo | references/flow.md |
Cómo descomponer un SRS-XXX de /requirement-refine en una o más historias (mapeo FR-XXX/NFR-XXX → AC-XXX, herencia de repos/wireframes, escritura de vuelta en el SRS) — entrada alternativa, no la habitual |
references/flow.md |
| Cómo ordenar y encadenar IDs al proponer varias historias en una misma invocación (SRS descompuesto, migración descompuesta, o varias funcionalidades relacionadas pedidas juntas) | references/flow.md |
| Detalle de RFC 2119 (tabla de modalidades), ISO 25010 (categorías de criterios de aceptación no funcionales), rúbrica INVEST y DoR ampliado | references/quality-criteria.md |
Estructura del README.md de una US |
assets/user-story-template.md |