---
title: "Yksi ohjetiedosto kaikille koodausagenteille – Olli Junes"
url: https://ollijunes.com/fi/agents-md-sync-yksi-ohjetiedosto-kaikille-koodausagenteille/
description: "Claude Code, Codex ja Gemini CLI lukevat kukin omaa ohjetiedostoaan. agents-md-sync kopioi yhden lähteen kaikille ja huomaa, jos kopiota on muokattu."
language: fi
alternate_en: https://ollijunes.com/agents-md-sync-one-instruction-file-for-every-coding-agent/index.md
index: https://ollijunes.com/llms.txt
---

19.11.2026[AI & Growth](https://ollijunes.com/fi/category/ai-growth-fi/) 3 min luku

# Kolme koodausagenttia, kolme kopiota säännöistäni. Tein työkalun, joka pitää yhtä.

Claude Code, Codex ja Gemini CLI lukevat kukin omaa ohjetiedostoaan. agents-md-sync kopioi yhden lähteen kaikille ja huomaa, jos kopiota on muokattu.

[Read in English](https://ollijunes.com/agents-md-sync-one-instruction-file-for-every-coding-agent/)

![agents-md-sync: yksi ohjetiedosto kaikille koodausagenteille ja varoitus, kun kopio poikkeaa. Claude Code, Codex, Gemini CLI.](https://ollijunes.com/_emdash/api/media/file/01M7TB09P305D0Q3T47MAY36CV.png)

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](https://github.com/ollijunes/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](https://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.

[![Olli Junes](https://ollijunes.com/wp-content/themes/ollijunes-theme/assets/img/olli-junes.webp)](https://gravatar.com/resacolli)

[Olli Junes](https://ollijunes.com/fi/tarina/)

Olli Junes on Resacon, Resapin ja ResaHostin perustaja ja toimitusjohtaja Rovaniemeltä. Yrittäjä vuodesta 2007\. Taustalla on valokuvausta, myyntiä ja myynnin johtamista Suomessa ja Ruotsissa. Kirjoittaa yrittäjyydestä, myynnistä ja RevOpsista.

Olli muualla: [Resaco Suomi](https://resaco.fi/olli-junes/) · [Resaco International](https://resaco.co/olli-junes/) · [ResaHost](https://resahost.net/tiimi/olli-junes/) · [Yrittäjäopas](https://yrittajaopas.com/kirjoittajat/olli-junes/)

[LinkedIn](https://www.linkedin.com/in/ollijunes/) [GitHub](https://github.com/ollijunes) [Gravatar](https://gravatar.com/resacolli) [X](https://x.com/resacolli) [Instagram](https://www.instagram.com/ollijunes/) [Threads](https://www.threads.net/@resacolli)

[ EdellinenPäivitän muiden repoja lukematta. Tein työkalun, joka lukee ensin.](https://ollijunes.com/fi/upstream-watch-git-kloonit-ennen-pullia/)

[ Takaisin blogiin](https://ollijunes.com/fi/blogi/)
