Escribir un PRD que los desarrolladores realmente lean, con Claude como editor
Los desarrolladores se saltan los PRD que se leen como ensayos. Una estructura estrecha y Claude como editor severo hicieron que la mía se abriera.
Mis primeros PRD respondieron con '¿puedes decirnos qué construir?' Así que dejé de escribir documentos y comencé a escribir especificaciones que un ingeniero cansado toleraría. El trabajo de Claude en esto es cortar, no inventar.
Primero la estructura: una línea sobre el problema, una línea sobre el usuario, una breve lista de lo que significa "hecho" y los casos extremos que los desarrolladores realmente encuentran. Sin novela de fondo. Si necesita un párrafo de contexto, pertenece a un hilo vinculado.
Redactelo claramente y luego péguelo en Claude con una instrucción: "elimine todas las oraciones que un desarrollador pueda inferir y marque cualquier requisito sin prueba de aceptación". Ese único mensaje acaba con la tontería que hace que los PRD sean omitibles.
Luego agrego las pruebas de aceptación que Claude marcó como faltantes. Un requisito sin prueba es una opinión. Los desarrolladores leen especificaciones que pueden verificar; hojean el resto.
El hábito que lo cambió todo: escribo el PRD asumiendo que el lector tiene contexto y no tiene paciencia. Claude me ayuda a mantener esa línea eliminando la prosa de cortesía.
Claude (claude.ai)
Ideal para: redacción extensa, edición y razonamiento a través de estructuras.
Características clave: modo documento, contexto extenso, artefactos para borradores, edición cuidadosa.
Plan gratuito: un nivel gratuito con límites diarios.
Precio: Pro alrededor de $20 al mes para un uso mayor.
Ventajas: fuerte en recortes y reestructuraciones, se mantiene breve.
Contras: suavizará una punta contundente a menos que le indiques que no lo haga.
Mi veredicto: escribo los huesos, Claude quita la grasa, vuelvo a añadir los casos extremos. El documento resultante es lo suficientemente breve como para leerlo y lo suficientemente específico como para compilarlo.
Preguntas frecuentes:
P: ¿Claude debería escribir el PRD desde cero?
R: Yo escribo la estructura; Claude edita. La generación completa se aleja de lo que realmente necesita el equipo.
P: ¿Qué tan corto es demasiado corto?
R: Si un desarrollador puede compilarlo y probarlo desde el documento, es suficiente. Por lo general, el acolchado es más largo.
P: ¿Necesito pruebas de aceptación para cada línea?
R: Para cualquier cosa que una persona de control de calidad verifique, sí. Los requisitos vagos se convierten en la culpa más adelante.