requirements-discovery

name	Requirements Discovery
description	DESCUBRIR sistemáticamente restricciones ocultas, definir métricas de éxito y prevenir la expansión del alcance antes de escribir código. Interceptar indicaciones vagas y ejecutar las cinco preguntas de descubrimiento. NO escribir código hasta que los requisitos estén documentados. Activadores: el usuario dice "build me", "can we add", "design a system for", o cualquier solicitud de proyecto/funcionalidad de alto nivel.
category	foundation
version	3.0.0
last_updated	2026-06-28T00:00:00.000Z
stacks	["All"]
triggers	[{"pattern":"build (a|me|an|the)","action":"INTERCEPTAR, ejecutar descubrimiento antes de código"},{"pattern":"can we add (a|an|a new)","action":"INTERCEPTAR, ejecutar descubrimiento antes de código"},{"pattern":"(design|architect|create) (a|the|an) (system|app|platform)","action":"INTERCEPTAR, ejecutar descubrimiento antes de código"},{"pattern":"el visitante pide una funcionalidad vaga","action":"INTERCEPTAR, ejecutar descubrimiento antes de código"}]
related_skills	["professional-project-intake","database-schema-design","saas-app-structure"]
lang	es
direction	ltr
source_version	3.0.0
translated_at	2026-06-29T00:00:00.000Z

Marco de Descubrimiento de Requisitos

IDENTIFICAR: Cuándo activarse

Activar esta habilidad cuando se cumplan TODOS:

• El usuario envía una indicación de alto nivel, vaga o incompleta
• La indicación describe una nueva aplicación, sistema o funcionalidad compleja
• No existe una especificación detallada en la conversación

NO activar cuando:

• La solicitud es una corrección de error (usar habilidades de manejo de errores)
• La solicitud es un ajuste específico de UI (usar habilidades de componentes)
• El usuario ya proporcionó criterios de aceptación detallados

DECIDIR: Selección de respuesta

SI la indicación del usuario es vaga Y describe un nuevo proyecto/funcionalidad →
  EJECUTAR las cinco preguntas de descubrimiento (EJECUTAR Paso 1)
  HASTA QUE el camino feliz, audiencia, datos, escala y modos de fallo estén respondidos
  LUEGO escribir plan de arquitectura (EJECUTAR Paso 2)
  LUEGO proceder a la implementación

SI la indicación es vaga Y describe un cambio en un sistema existente →
  ESCANEAR código existente primero (professional-project-intake)
  LUEGO ejecutar solo Pasos 1-2 de las preguntas de descubrimiento
  LUEGO escribir plan de cambio
  LUEGO proceder

SI la indicación es detallada Y específica →
  SALTAR esta habilidad
  Proceder directamente a las habilidades de implementación

EJECUTAR: Instrucciones

Paso 1: Responder las Cinco Preguntas de Descubrimiento

Responde cada pregunta que puedas desde el contexto existente. Para las incógnitas restantes, pregunta al usuario, máximo 3 preguntas por lote.

P1, CAMINO FELIZ: Define la acción de usuario más importante en una sola oración.

Plantilla: "Un(a) [ACTOR] puede [ACCIÓN] resultando en [RESULTADO]."
Ejemplo: "Un administrador puede ver una lista de pedidos y filtrar por estado."

Si NO PUEDES expresar el camino feliz en una oración → DETENTE. Pregunta al usuario que aclare el alcance antes de continuar.

P2, AUDIENCIA: Identifica quién usa esto.

SI equipo interno (3-50 personas)   → UI simple, rendimiento menos crítico, sin pulido necesario
SI consumidores públicos (miles+)   → Pulido, accesibilidad, diseño responsivo, rendimiento requerido
SI desarrolladores (consumidores API) → Documentación, versionado, límites de tasa, formatos de error consistentes
SI tanto interno COMO externo       → Diferentes UI por rol (ver saas-app-structure/SKILL.md)

P3, DATOS: Mapear flujo de datos.

ENTRADAS:  [ ] Entrada de usuario  [ ] Carga de archivos  [ ] Cargas útiles API  [ ] Webhooks
ALMACENAMIENTO: [ ] Cuentas de usuario  [ ] Pedidos  [ ] Contenido  [ ] Analíticas  [ ] Registros de auditoría
SALIDAS: [ ] Respuestas API  [ ] Correos electrónicos  [ ] Exportaciones  [ ] Informes  [ ] Eventos en tiempo real
CUMPLIMIENTO: [ ] PII  [ ] GDPR  [ ] HIPAA  [ ] PCI-DSS  [ ] SOC2