Por qué la mayoría de los fallos en los pipelines de Claude se deben a los prompts, no a los modelos, y cómo solucionarlo con habilidades

Una reciente publicación en r/ClaudeAI señala un patrón común: un prompt funciona de forma aislada, pero cuando se coloca en un pipeline, produce silenciosamente resultados incorrectos semanas después. La causa raíz no es el modelo, sino que el prompt asumía formatos de entrada no documentados y devolvía estructuras que solo un interlocutor sabía cómo analizar. La publicación argumenta que una habilidad —a diferencia de un prompt en bruto— exige tres cosas que previenen este tipo de fallos.

Contrato de Entrada

Define exactamente qué campos necesita el prompt, qué sucede si falta alguno y cuál es la entrada mínima viable. La publicación dice que esto toma diez minutos de escribir y evita fallos que de otro modo aparecerían a las 2 a.m.

Esquema de Salida

Especifica el formato de retorno con precisión, incluyendo estados de fallo. Ejemplo de la publicación:

éxito = {acción: string, confianza: float, razonamiento: string}
fallo = {acción: "saltar", razón: string}

"Devuelve un resumen" no es un esquema. El esquema hace que tanto el éxito como el fallo sean visibles para los nodos posteriores.

Archivo de Aprendizajes

Mantén un archivo que registre en qué ha fallado la habilidad, qué casos límite se han encontrado y qué se rompió en producción. Esto se completa con el tiempo —cada vez que la habilidad te quema, el dolor va allí en lugar de ser redescubierto por quienquiera que la ejecute después.

El autor de la publicación resume: "El prompt solo es v0. La habilidad es lo que promocionas a v1."