Lecciones Prácticas de Ingeniería de Prompts al Usar Claude Code

Lo que funcionó: Implementar código en producción

El usuario, un director de proyecto sin experiencia en desarrollo, logró construir e implementar código en producción utilizando Claude Code. La aplicación resultante se ejecuta en un navegador e incluye más de 1.200 pruebas.

El desafío principal: La calidad de las indicaciones

La dificultad principal identificada fue que Claude Code producirá resultados deficientes o incorrectos si las indicaciones no son precisas. El usuario afirma que "definitivamente te dejará chocar contra una pared a toda velocidad si tu indicación no es hermética".

Tres técnicas que mejoraron los resultados

• Indicaciones en dos fases: En lugar de escribir indicaciones de una sola vez, el usuario adoptó un enfoque en dos fases. Fase 1 implica escribir el qué en tu propio lenguaje del dominio, incluyendo reglas y resultados deseados. Fase 2 implica reescribir la indicación desde la perspectiva de un ingeniero de confiabilidad, agregando compuertas de verificación, objetivos únicos, límites de sesión explícitos y reglas anti-atajos. El usuario descubrió que una fase produce resultados decentes, pero dos fases producen resultados de calidad de producción.
• Una indicación = Un objetivo: Agrupar múltiples metas en una sola indicación consistentemente llevaba a resultados deficientes. Claude Code priorizaría un objetivo, los fusionaría de manera descuidada o proporcionaría soluciones incompletas para ambos. El usuario enfatiza una "disciplina de alcance implacable" con un objetivo por indicación, llamando a esto el mayor "multiplicador de calidad" descubierto.
• Definiciones de roles específicas: Las instrucciones de roles genéricas como "Actúa como un desarrollador senior" resultaron ser "casi inútiles". Los roles efectivos deben nombrar la combinación exacta de experiencia requerida para la tarea. El usuario proporciona un ejemplo: "Teórico musical formado en conservatorio que ha construido motores de composición comerciales" produce resultados fundamentalmente diferentes y mejores que una instrucción vaga como "experto en música". La especificidad cambia el proceso de pensamiento subyacente del modelo, no solo el tono de la salida.