
Käytän useampaa koodausagenttia. Jokainen lukee ohjeensa omasta tiedostostaan: Claude Code tiedostosta ~/.claude/CLAUDE.md, Codex tiedostosta ~/.codex/AGENTS.md ja Gemini CLI tiedostosta ~/.gemini/GEMINI.md. Sisällön pitäisi olla sama, koska säännöt ovat minun eivätkä työkalun.
Käsin ylläpidettyinä ne eivät pysy samoina. Korjaat säännön yhteen tiedostoon ja unohdat muut. Agentit kirjoittavat näihin tiedostoihin myös itse, joten kopio voi muuttua koskematta. Tein siksi työkalun nimeltä agents-md-sync.
Ongelma
Kolme samansisältöistä tiedostoa on kolme paikkaa olla väärässä. Mikään ei kerro, kun ne eroavat. Vanhaa kopiota lukeva agentti ei tiedä sen olevan vanha. Se noudattaa sitä.
Symlinkki ratkaisee osan. Se lakkaa toimimasta sinä päivänä, kun jokin työkalu tai synkronointipalvelu korvaa linkin tavallisella tiedostolla, eikä sekään näy missään.
Mitä työkalu tekee
Valitset yhden tiedoston ja muokkaat vain sitä. publish kopioi sen jokaisen työkalun lukemaan paikkaan. check vertaa kopioita lähteeseen.
Työkalu muistaa, mitä se kirjoitti. Siksi se erottaa kaksi tapausta. Vanhentunut kopio vastaa edellistä julkaisua, ja publish päivittää sen. Muokattu kopio ei vastaa lähdettä eikä edellistä julkaisua, ja silloin publish pysähtyy. Se ei kirjoita mitään, ei muillekaan työkaluille, ennen kuin olet katsonut.
diff näyttää, mitä kopiossa muuttui. Siirrät haluamasi rivit lähteeseen ja julkaiset uudelleen. Jos et halua niistä mitään, --force kirjoittaa kopion yli ja jättää vanhan talteen.
check --quiet on hiljaa, kun kaikki on kunnossa, ja palauttaa virhekoodin, kun kopio poikkeaa. Sen saa yhdellä rivillä session aloitukseen tai croniin.
Sama työkalu toimii repon sisällä. Pieni asetustiedosto nimeää lähteeksi AGENTS.md:n ja kopioiksi CLAUDE.md:n ja GEMINI.md:n, ja CI:ssä check kaatuu, jos ne eroavat.
Turvallisuus
Kopio kirjoitetaan ensin väliaikaistiedostoon ja nimetään paikalleen, joten agentti ei lue puolikasta tiedostoa. Työkalu ei julkaise tyhjää, katkennutta tai yli 32 kibitavun lähdettä. Symlinkin läpi se ei kirjoita.
Reposta löytyvä asetustiedosto voi osoittaa vain oman kansionsa sisään. Kloonatussa projektissa ajettu publish ei siis voi korvata kotikansiosi ohjetiedostoa. Ensimmäisen version tietoturvakatselmointi löysi juuri tämän aukon, ja korjauksella on omat testinsä.
Mitä olen testannut
Testit rakentavat kotikansion väliaikaishakemistoon eivätkä lue oikeaa. Ne kattavat ensimmäisen julkaisun, vanhentuneen ja muokatun kopion, pakotetun ylikirjoituksen, symlinkit ja kahdeksan tapaa, joilla repon asetus voisi yrittää kansionsa ulkopuolelle. CI ajaa ne Linuxilla ja macOS:llä.
Olen ajanut koko työnkulun käsin synteettistä kotikansiota vasten. README:n esimerkit ovat siitä.
Sama idea on ollut käytössäni lyhyenä shell-skriptinä. Tämä työkalu on siitä kirjoitettu uudelleen. Omia koneitani en ole vielä siirtänyt siihen.
Mitä se ei tee
Kopiot ovat identtisiä. Työkalukohtaisia osioita tai muunnoksia ei ole. Muokattua kopiota se ei yhdistä puolestasi. Valmiit sijainnit on neljälle työkalulle, muut lisäät polkuna. Windowsilla sitä ei ole testattu.
Kokeile
Koodi on osoitteessa github.com/ollijunes/agents-md-sync. Aja init, sitten check ja publish. Jos työkalulla on jo oma ohjetiedosto, ensimmäinen julkaisu pysähtyy ja näyttää sen. Se on tarkoitus.
