Skill: Historia de usuario

Guía para crear o actualizar historias de usuario en el repo del producto.

Alcance de una US: El README.md es un documento funcional. Registra el valor para el usuario, los criterios de aceptación (subsecciones Reglas de negocio con ids BR-XX y Escenarios con ids SC-XX) y el estado de avance. El detalle de implementación (DTOs, endpoints, esquemas) va en docs/specs/technical-docs/ o en tareas TK-XXX, nunca en la narrativa de la historia. Los documentos técnicos no son parte de la descripción funcional; pueden referenciarse únicamente 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).

Subagente requerido

Este skill debe ejecutarse bajo el agente/subagente docs-specialist (agents/docs-specialist.md; en el proyecto destino instalar como .cursor/agents/docs-specialist.md). No ejecutar el flujo normativo de la US sin ese contexto.

Cómo preguntar al usuario

Cuando este skill indique preguntar, pedir, confirmar, validar o sugerir algo al usuario, hacerlo mediante la herramienta de preguntas estructuradas que ofrezca el cliente (la que renderiza opciones tappables o un selector de respuesta) en lugar de redactar la pregunta como prosa libre. Reglas: