requirement-refine

Installation
SKILL.md

Skill: Especificación de requisitos (SRS)

Guía para crear o actualizar una Especificación de Requisitos de Software (SRS-XXX) a partir de un requerimiento en bruto: una idea, un ticket, un correo, una conversación, una transcripción de reunión, un diseño o wireframes existentes, documentación técnica, o cualquier combinación de estos — todo insumo que dé contexto para definir el alcance sirve, y no hace falta un único formato. Si el insumo incluye imágenes o gráficas, se leen y se interpretan antes de continuar. El objetivo es dejar el requerimiento en una forma estándar, sin lagunas, lista para descomponerse en historias de usuario.

Alcance de un SRS: el README.md fija el contexto de implementación de un requerimiento antes de dividirlo en trabajo: qué stack tecnológico se va a usar (y con qué respaldo), en qué repositorios se materializa y si hay un proyecto base del que partir, y los requisitos funcionales y no funcionales de alto nivel. No contiene historias de usuario, AC-XXX ni tareas — eso lo produce work-define (y, para las tareas, work-plan) a partir de este documento. Tampoco contiene modelos de datos, contratos de API ni diagramas técnicos — eso es design-define. Este skill es el paso previo, opcional pero recomendado, cuando el requerimiento llega crudo o ambiguo; si ya está claro (stack, repos y alcance conocidos, sin decisiones pendientes), se puede ir directo a /work-define.

La plantilla canónica está en assets/srs-template.md (léela antes de escribir cualquier SRS).

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: cierre de lagunas funcionales (incluidas interfaces externas, datos y cumplimiento normativo), supuestos de funcionalidad transversal reutilizable, wireframes de UI en SVG enlazado (tipo de solución, mockup visual), verificación y trazabilidad, riesgos, la pregunta sobre el stack (investigar vs. ya decidido) y su delegación a /work-research, repositorios/proyecto base, equipo de desarrollo, checklist, ejemplos y anti-patrones references/flow.md
Guion de la entrevista: la secuencia de 17 etapas (idea → problema → objetivo de negocio → … → ready), las tres olas (Discovery / Definition / Validation), los tres roles (PO, UI/UX, Arquitecto) con su dominio y lenguaje de preguntas, la regla requisitos vs. decisiones de diseño, y la validación final con subagente sin contexto references/interview.md
Detalle de RFC 2119, categorías de FR-XXX (funcionales) y NFR-XXX (ISO 25010), prioridad, estado por requisito, métodos de verificación, verificabilidad, y la Definition of Ready (DoR) del SRS references/quality-criteria.md
Estructura del README.md de un SRS assets/srs-template.md
Estructura de un wireframe de pantalla assets/wireframe-template.md
Installs
2
First Seen
3 days ago
requirement-refine — juanca202/sdd-devkit