Una de las cosas mas importantes para el AI Assisted development es el contexto. Este es una forma de darle instrucciones a nuestros agentes para que alucinen lo menos posible y realicen lo que necesitamos.
Cada agente/asistente/tool tiene su forma de definir un archivo que sea su fuente de la verdad, muchos están adoptando el uso de un archivo especial AGENTS.md lo cual es genial porque los estandares son buenos para guiar una industria y darle cierta estabilidad.
Yo adopte este mindset y si bien hay algunas herramientas que adoptan esto, hay otras que tienen un soporte mixto dan soporte al AGENTS.md pero también a su propio archivo. Peeeeeeero también hay otras herramientas que no lo hacen.
Sincronizando contexto
Para resolver este "problema" cree una tool bastante simple (por ahora) llamada @dezkareid/ai-context-sync.
La cual usa el archivo AGENTS.md como fuente de la verdad y a traves de algunas estrategias configura/enlaza este archivo con el que necesitan algunas herramientas como Claude Code y Gemini CLI.
Pueden probarla usando npx
npx @dezkareid/ai-context-sync sync
Dependiendo de la estrategia que selecciones creará un archivo de configuración y así dependiendo de esta configuración puede generar esa sincronización nuevamente.
Como desarrolladores nunca es recomendable estar atado a una sola herramienta, es por eso estamos constantemente analizando e iterando.
Durante este pequeño desarrollo agregue soporte para seleccionar alguna estrategia directamente.
npx @dezkareid/ai-context-sync sync --strategy claude
npx @dezkareid/ai-context-sync sync --strategy gemini
npx @dezkareid/ai-context-sync sync --strategy all
npx @dezkareid/ai-context-sync sync --strategy "claude, gemini"
No es una herramienta que uses muchas veces en tu ciclo de desarrollo o quizás si, no lo se, solo las descargas lo dirán jeje.
Motivación
Esto no es un problema que vaya mas allá del copiar y pegar, el "problema" es tener que modificar o mas bien tener contexto de que cosas hay que modificar.
Tener un markdown para cada herramienta es una pesadilla pero es peor tener información y contexto duplicado.
El context engineering y el One Piece son reales.
Yo estoy tratando de definir mi estado del arte en AI y también para mis equipos de trabajo, entonces esto fue algo que solucionó mi problema por el momento, así que soy feliz.
Futuro
Algunos editores como cursor y windsurf ya incluyen el soporte para AGENTS.md pero no antigravity, así que probablemente en lo que dan soporte agregaré una regla que permita hacer referencia a este archivo.
Como dije antes, cada tool puede seleccionar el camino que desee, adoptar un estandar o salir de el para generar algo diferente. Lo hermoso de esta época es que ahora pasamos menos tiempo escribiendo código y mas tiempo diseñandolo.
Top comments (1)
Está genial la idea. Es como lo que hace open spec cuando inicializas un proyecto. Te genera los skills para tu herramientas de turno.
Gracias por crear este adaptador por asi decirlo. Que tedioso sería estar haciendo todo a mano cada vez que queremos usar una tool diferente (lo cual ocurre a menudo)
Y es verdad, son tiempos muy divertidos. Me recuerda a los viejos buenos tiempos de los hackers que se la pasaban creando tools diversas y creativas