Escribe documentos de requisitos de producto que agentes de IA pueden actuar fiablemente, con restricciones explícitas, casos edge y criterios de aceptación que minimizan la brecha entre lo que quieres y lo que el agente construye. Esta habilidad cierra la ambigüedad de specs de producto en lenguaje natural y la precisión que los agentes de IA requieren para producir resultados consistentes.
Casos de uso
- Escribiendo requisitos para una funcionalidad a ser implementada por un asistente de codificación de IA donde lenguaje natural vago llevaría a resultados inconsistentes
- Especificando criterios de aceptación para una funcionalidad donde diferentes intérpretes implementarían la misma descripción de manera diferente
- Creando un PRD para una tarea de agente de IA autónoma donde el agente necesita tomar decisiones consistentes en situaciones ambiguas
- Alineando a un equipo cruzado donde ingenieros, diseñadores y product managers tienen diferentes modelos mentales
- Definiendo los límites de una funcionalidad de IA: qué debe manejar la IA de manera autónoma versus qué requiere escalada humana
Funciones principales
- Define el objetivo de usuario explícitamente, incluyendo qué información proporciona el usuario, qué debe producir el sistema y qué restricciones se aplican al output
- Lista casos edge explícitamente: qué debe pasar cuando el input está vacío, malformado, ambiguo o en el límite del alcance definido
- Estado criterios de aceptación en términos verificables y testables: 'el sistema debe X cuando Y' en lugar de 'el sistema debe manejar X apropiadamente'
- Incluye anti-ejemplos junto a ejemplos positivos: 'cuando el usuario pregunta por X, el sistema debe NO hacer Y' para prevenir malinterpretaciones comunes
- Revisa el PRD pidiéndole a un colega o IA que actúe sobre él y notando dónde su interpretación diverge de tu intent: esas brechas revelan ambigüedad a corregir
Relacionados
Relacionados
3 Entradas indexadas
Receiving code review
Estructura cómo respondes al feedback de revisión de código para que el proceso de revisión se mantenga enfocado, respetuoso y productivo. Esta habilidad separa feedback sustantivo de-nitpicks, rastrea seguimientos sin perderlos y produce un registro que hace los merges más rápidos y los post-mortems más claros.
Writing implementation plans
Convierte requisitos vagos o estancados en planes de implementación precisos con pasos definidos, puntos de contacto por archivo, puntos de control de decisión y criterios de aceptación verificables antes de escribir cualquier código. Esto cierra la brecha entre lo que los interesados quieren y lo que los ingenieros realmente pueden entregar, reduciendo sorpresas a mitad de sprint y refactorizaciones desperdiciadas.
Documentation from code
Extrae decisiones arquitectónicas, contratos de API y patrones de uso directamente del código para producir documentación precisa que se mantiene en sync con la implementación. Documentation-from-code trata el código como la fuente de verdad y genera prosa desde él en lugar de mantener documentación como un artefacto separado que diverge con el tiempo.