Wanbicoi/agent-config

El usuario ha solicitado una retrospectiva. Estás sugiriendo mejoras en el entorno del agente de codificación para mejorar ejecuciones futuras.

Pasos

1. Llama a la herramienta de habilidad con writing-for-agents para la guía de estilo de escritura.

2. Lee las fuentes principales de la sesión que el usuario especifique. Esto puede implicar buscar en los registros de sesión de esta máquina. Si el usuario no especifica una sesión, utiliza la actual por defecto.

3. Busca candidatos para mejorar en estas categorías.

• Navegación: ¿qué tan fácil fue para el agente encontrar los archivos correctos? ¿Existen dependencias ocultas entre archivos? ¿Un puntero de navegación facilitaría la tarea? Úsalo cuando la sesión haya tardado mucho en encontrar una pieza de información.
• Comprobaciones automatizadas: ¿existen comprobaciones automatizadas que podrían haber detectado errores del agente? ¿Linting, tipado, pruebas, linters del sistema de archivos? Lee primero el comando de verificación propio del repositorio (sus scripts package.json/lint/check de la herramienta de compilación, su flujo de trabajo de CI), de modo que una comprobación que ya existe pero está sin conectar o silenciosamente rota sea el hallazgo, no una reinvención. Un repositorio sin barrera de protección (sin hook de pre-commit ni trabajo de CI que ejecute su comando de lint/typecheck/test) es en sí mismo un hallazgo: un repositorio sin linting es una oportunidad perdida permanente, no un estado neutral por defecto. Úsalo cuando el agente haya cometido un error que una comprobación automatizada podría haber detectado, o el repositorio no tenga ninguna barrera de protección.
• Estándares de codificación: ¿se le debe dar una nueva regla al agente revisor? ¿Se debe eliminar o aclarar una regla existente? Primero clasifica la violación: una mecánica (un patrón sintáctico fijo, una API prohibida, una forma de importación, una regla de ubicación de archivo) recibe una comprobación determinista, sin discusión: una regla personalizada en el linter propio del repositorio, un nuevo hook de pre-commit, o un nuevo trabajo de CI, el que sea más económico según el lenguaje del repositorio y su barrera de protección existente. Por defecto, prioriza construir la comprobación sobre escribir la regla. Reserva CODING_STANDARDS.md para juicios de valor genuinos (coherencia entre archivos, "coincide con el estilo circundante", cualquier cosa que ninguna barrera de protección podría reemplazar). Úsalo cuando el agente revisor no haya detectado un error.
• AGENTS.md global: ¿hay instrucciones de dirección que deberían trasladarse a los estándares de codificación (o a comprobaciones automatizadas)? Úsalo cuando el archivo AGENTS.md sea particularmente grande, ya sea en el repositorio o en el ámbito global del usuario.
• Economía de herramientas: ¿el agente realizó llamadas costosas a herramientas que podrían simplificarse? ¿Hay alguna herramienta personalizada (CLI, MCP) que sea particularmente ineficiente en tokens? Úsalo cuando el agente haya realizado una llamada costosa a una herramienta.
• Sin operación: busca instrucciones en los archivos de dirección que no modifiquen el comportamiento del agente. Úsalo cuando los archivos de dirección sean grandes y difíciles de manejar.
• Acceso a información: busca oportunidades para aumentar el acceso del agente a la información. Redirigir registros del servidor de desarrollo, acceso de solo lectura a servicios de terceros. Úsalo cuando una pieza de información crucial no estuviera disponible para el agente.

4. Presenta estos candidatos al usuario, en orden de gravedad.

Referencia

Implementación vs Revisión

Recuerda que todo trabajo pasa por dos etapas: implementación y revisión. El agente de implementación tiene la mayor presión de contexto. Es responsable de la exploración, escribir código y depurar fallos.

El agente de revisión tiene la menor presión de contexto: recibe un diff, por lo que no necesita exploración. A menudo no necesita escribir código ni depurar.

Esto significa que el agente de revisión debería ser responsable de imponer los estándares de codificación, no el agente de implementación.

Archivos

Tienes acceso a varios archivos en el repositorio:

• CLAUDE.md/AGENTS.md: estos archivos se envían a la ventana de contexto de cualquier agente que trabaje en este repositorio. Deben usarse con mucha moderación, normalmente solo para punteros de navegación a otros archivos.
• CODING_STANDARDS.md: este archivo se lee durante la revisión, no durante la implementación. Agrega punteros de navegación a carpetas de documentación si el archivo de estándares supera las 1.000 líneas.
• Documentos: usa documentos como archivos de referencia, señalados por otros archivos. Busca documentos existentes antes de escribir nuevos.
• Habilidades: usa habilidades para documentos (ya que su descripción se incluye en la ventana de contexto del agente), o para comandos invocados por el usuario. Sigue los consejos de la habilidad writing-for-agents.