La calidad del código generado por AI depende casi por completo de lo que pides y de cómo lo pides. Esta guía cubre los patrones que constantemente producen mejores resultados con Claude Code.
Desde el análisis de tareas hasta los impulsos del sistema, desde el perfeccionamiento iterativo hasta instrucciones específicas para el papel. Técnicas prácticas que puedes aplicar en tu próxima sesión de codificación.
Cuando usted hace a un desarrollador humano para 'construir una página de inicio de sesión', hacen preguntas aclaratorias: ¿qué proveedor de austeridad? ¿Qué campos? ¿Debería manejar OAuth? ¿Mensajes de error? ¿Estaciones de carga?
Los agentes de codificación de AI intentarán responder a todas esas preguntas. A veces adivinan bien. A menudo adivinan algo razonable pero no lo que querías. La brecha entre 'razonable' y 'exactamente correcto' es lo que la ingeniería rápida cierra.
Los buenos avisos no necesitan ser largos. Necesitan ser específicos sobre las cosas que importan y en silencio sobre las cosas que no. Ese equilibrio es de lo que se trata esta guía.
Patrones que mejoran los resultados independientemente de la tarea.
En lugar de 'crear un componente React, luego añadir estado, luego añadir estilo', describir el resultado final: 'Construir una barra lateral plegable que muestra nombres de proyectos, soporta arrastrar a reorden, y utiliza nuestro tema Tailwind existente.' Que el agente decida cómo llegar allí.
Avoid
Cree un componente. Añadir Estado de uso. Añadir un botón para cambiar. Disfrútalo con Tailwind.
Better
Construir un componente de barra lateral plegable que lista proyectos por nombre. Debe apoyar el drag-to-reorder y coincidir con nuestro tema oscuro (bg-[#111318], frontera-[#262b38]). El estado colapsado debe persistir a través de las recargas de página.
Los agentes funcionan mejor cuando conocen los límites. Especifique los archivos a tocar (o evitar), qué patrones a seguir, y qué 'hace' parece. Las tareas sin límites conducen a cambios que son difíciles de revisar.
Avoid
Refactor el sistema de autenticación.
Better
Refactor el controlador de inicio de sesión en src/api/auth/login.ts para utilizar la bcrypt en lugar de sha256 para el almacenamiento de contraseñas. No cambie la lógica JWT ni el manejo de cookies de sesión. Actualizar las pruebas relacionadas en pruebas/auth/.
Claude Code puede leer sus archivos de proyecto, pero no puede leer su mente. Si hay una convención que sigues, una biblioteca que prefieras, o un patrón que ya has establecido, digamos. Esto ahorra trabajo.
Avoid
Añadir validación de formularios.
Better
Añadir validación de formulario al formulario de registro utilizando zod (ya lo utilizamos para el formulario de configuración en src/forms/settings.ts). Mostrar mensajes de error en línea debajo de cada campo. Siga el mismo estilo de error que el formulario de inicio de sesión.
Compound prompts ('construir la API, escribir pruebas, actualizar los documentos y desplegar') obligan al agente a tener demasiados objetivos a la vez. Rompe el trabajo complejo en tareas secuenciales y centradas. Cada uno se basa en el resultado anterior.
Avoid
Construya la página de perfil de usuario, escriba los puntos finales de API, agregue pruebas, actualice el README y corrija la barra nav mientras esté en ella.
Better
Construya el punto final GET /api/user/profile. Volver id, nombre, correo electrónico y campos de plan. Utilice la auth middleware existente para la autenticación.
Si el primer resultado no es correcto, refina el impulso en lugar de empezar de nuevo. Claude conserva el contexto de conversación completo. Di lo que está mal, qué cambiar y qué guardar. La iteración es más rápida que la reinvención.
Avoid
Eso está mal. Comience de nuevo y construya el componente de manera diferente.
Better
El diseño es bueno pero el punto de ruptura móvil está equivocado. A continuación 768px, apilar las tarjetas verticalmente en lugar de usar una cuadrícula. Mantenga todo lo demás como es.
Los avisos del sistema establecen el comportamiento de referencia para un agente antes de decir cualquier cosa. Son la herramienta más infrautilizada en la codificación AI.
Un impulso de sistema le dice al agente quién es, en qué debe enfocarse, y qué debe evitar. Se aplica a todos los mensajes del período de sesiones. Piénsalo como la descripción del trabajo del agente.
AgentsRoom barcos con 14 consejos de sistema específicos para función: uno para cada tipo de agente. El impulso del agente Frontend le dice que se centre en componentes, accesibilidad y diseño sensible. El aviso del agente de QA le dice que piense en casos de borde y escriba pruebas completas. Usted puede personalizar estos o escribir su propio.
Eres un desarrollador de frontend senior. Enfóquese en los componentes React, estilo CSS/Tailwind, accesibilidad (WCAG AA), y diseño sensible. Utilice la biblioteca de componentes existente del proyecto antes de crear nuevos componentes. Preferir la composición sobre la herencia. Escribe HTML semántico. Nunca modifique los archivos backend.
El impulso más eficaz no se escribe en un chat. Vive en tu depósito.
CLAUDE.md es un archivo de marcado en la raíz de su proyecto que Claude Code lee automáticamente. Contiene estructura de proyectos, convenciones, detalles de pila y directrices que se aplican a cada sesión de agentes en el proyecto.
En lugar de repetir 'usamos Tailwind CSS 4, Prisma ORM, y Next.js 16' en cada conversación, escríbalo una vez en CLAUDE.md. Cada agente hereda este contexto. AgentsRoom incluye un editor integrado para CLAUDE.md para que pueda actualizarlo sin dejar la aplicación.
Un CLAUDE.md bien escrito vale más de docenas de consejos individuales cuidadosamente elaborados. Se complica: cada período de sesiones se beneficia de ella.
Deja de escribir las mismas instrucciones. Guarda lo que funciona y reutilizarlo.
Si te encuentras escribiendo el mismo tipo de solicitud a través de proyectos ('escribir pruebas unitarias para este archivo', 'refactor esto para utilizar el patrón de repositorio', 'add error handling to all API route'), guardarlo como un aviso reutilizable.
AgentsRoom incluye una función de biblioteca rápida con dos niveles: los impulsos por proyecto para tareas específicas, y los impulsos globales (sincronizados en voz alta) para patrones que utiliza en todas partes.
Buenos candidatos para avisos de biblioteca: listas de revisión de códigos, plantillas de escritura de pruebas, scripts de migración, instrucciones de andamio de componentes, pasos de auditoría de seguridad. Cualquier cosa que pusieras en un wiki de equipo como procedimiento estándar.
Escribe pruebas de unidad para [archivo]. Usa la prueba. Cubrir el camino feliz, los casos de borde (entrada vacía, nulos, tipos inválidos) y el manejo de errores. Mock dependencias externas. Objetivo para la cobertura de sucursal del >0%.
Revise los cambios en el actual git diff. Check for: unused imports, missing error handling, type safety issues, potential race conditions, and naming inconsistencies. Sugerir correcciones para cada problema encontrado.
Crear un punto final REST para [resource]. Incluya validación de entrada con zod, respuestas de error adecuadas (400, 401, 404, 500), Tipos de script para petición/respuesta, y un comentario JSDoc que describe el punto final. Siga el patrón existente en src/api/.
Técnicas para tareas complejas que van más allá de simples indicaciones.
Rompe una gran tarea en pasos ordenados. Comience el primer agente con el primer paso, espere la terminación, luego comience el siguiente agente con el paso dos (referenciando la salida del primer paso). Cada paso es más pequeño y más concentrado. Ejemplo: Agent 1 diseña el esquema de base de datos, Agent 2 escribe la API usando ese esquema, Agent 3 escribe pruebas contra la API.
Después de que un agente termine, apunta un agente diferente a su salida. 'Revise los cambios que el agente de frontend acaba de hacer en src/components/. Compruebe los problemas de accesibilidad y los estados de error desaparecidos.' Un agente fresco con un papel diferente atrapa cosas que el agente original perdió.
Comience con un impulso suelto para ver cómo el agente se acerca al problema. A continuación, añadir restricciones en mensajes de seguimiento: 'Buena estructura, pero utilizar componentes del servidor en lugar de componentes del cliente.' 'Mantenga el gancho, pero retírese el usoEfecto y use una mutación React Query.' Cada iteración se estrecha hacia la solución que desea.
Indicar el agente en el código existente: 'Construir una página de configuración siguiendo el mismo patrón que src/pages/profile.tsx. La misma estructura de diseño, el mismo manejo de formularios, la misma pantalla de error.' Esto es a menudo más eficaz que describir el patrón en palabras.
Patrones que producen resultados peores.
Decir al agente exactamente qué funciones escribir, qué variables nombrar, y qué orden de implementar las cosas. Esta microgestión elimina la capacidad del agente para encontrar un mejor enfoque. Describir el resultado, no el procedimiento.
Pedir a un agente que "mejorar la base de código" sin restricciones. Sin límites, el agente podría refactorar archivos que no quería tocar, cambiar APIs que otro código depende o gastar fichas en mejoras de baja prioridad.
Sin mencionar que ya existe un patrón, utilidad o componente en el proyecto. El agente creará uno nuevo. Un simple 'ya tenemos un usoAuth gancho en src/hooks/' ahorra un trabajo significativo.
Recortar cinco tareas en un mensaje. El agente intentará a todos ellos, pero la calidad cae al malversar los objetivos competidores. Dividirlos en solicitudes secuenciales y enfocadas.
AgentsRoom le da instrucciones del sistema, una biblioteca rápida, y la edición CLAUDE.md construida en. Menos tiempo fabricando los avisos, más tiempo construyendo.
App complementaria: supervisa tus agentes en movimiento
Usa Claude, Codex, Antigravity CLI u otro proveedor de IA.
Envía bugs y peticiones directamente a tu backlog público.
Un vistazo a AgentsRoom en acción.