| 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
