AGENTS.md

haladóelterjedt

Az AGENTS.md egy egyszerű szövegfájl a szoftverprojekt mappájában, amely leírja a kódoló AI-agenteknek, hogyan kell az adott projekten dolgozniuk.

Érthetően

Képzeld el, hogy új kolléga érkezik a munkahelyedre, és az asztalán egy lap várja: hol találja a dolgokat, mik a házirend szabályai, mihez ne nyúljon, és kinek szóljon, ha kész. Az AGENTS.md ugyanez a lap, csak nem embernek, hanem a kódoló agentnek szól.

Az agent magától nem tudja, hogy egy projektben hogyan szokás tesztelni, milyen stílusban írják a kódot, vagy mely fájlokhoz tilos hozzányúlni. Ha ezt egyszer leírod ebbe a fájlba, nem kell minden alkalommal újra elmagyaráznod.

Attól más, mint a korábbi megoldások, hogy közös, nyílt formátum. Korábban több eszköz saját nevű szabályfájlt várt, az AGENTS.md-t viszont sok különböző gyártó agentje egyformán elolvassa.

Hogyan működik

A projekt gazdája létrehoz egy AGENTS.md nevű fájlt a projekt főmappájában, és hétköznapi nyelven, egyszerű Markdown formázással beleírja a tudnivalókat.
Tipikus tartalma: hogyan kell a programot elindítani és tesztelni, milyen kódolási szokások érvényesek, mire kell vigyázni, és hogyan kell a kész munkát beadni.
Amikor az agent munkához lát, megkeresi és beolvassa ezt a fájlt, és a tartalma bekerül abba a szövegbe, amely alapján dolgozik.
Nagy projektben az almappáknak is lehet saját AGENTS.md fájljuk. Ha két fájl szabályai ütköznek, az számít, amelyik közelebb van ahhoz a fájlhoz, amelyen az agent éppen dolgozik. A felhasználó közvetlen utasítása mindkettőnél erősebb.
A fájl ugyanúgy változik és javítható, mint a kód: ha az agent rendszeresen hibázik valamiben, a csapat beír egy új szabályt.

Példa a mindennapokból

Egy webáruház fejlesztőcsapata azt tapasztalja, hogy az agent rendszeresen elfelejti lefuttatni a teszteket, mielőtt késznek jelenti a munkát. Beírják az AGENTS.md-be, hogy „minden módosítás után futtasd le a teszteket, és csak hibátlan eredménnyel add be”. Onnantól az agent többnyire magától is így dolgozik, a csapat pedig ellenőrzi, hogy a tesztek valóban lefutottak-e.

Kit érint

fejlesztőŐ írja és tartja karban a fájlt, és ezen múlik, mennyire használható munkát kap a kódoló agenttől. → Kód

vállalkozó, vezetőA cég fejlesztési szabályai így egy helyen, ellenőrizhetően rögzíthetők, és nem kötik a csapatot egyetlen gyártó eszközéhez.

szülő, diák, tanárAki programozni tanul vagy tanít AI-segítséggel, ebben a fájlban adhatja meg, hogy az agent magyarázzon, és ne csak kész megoldást adjon. → Oktatás és család

Gyakori félreértés

TévhitAmit az AGENTS.md-be írsz, azt az agent garantáltan betartja, mintha programkód lenne.

ValójábanA fájl útmutató, nem zár: az agent figyelembe veszi, de hosszú vagy ellentmondásos szöveg esetén figyelmen kívül hagyhat egy-egy szabályt. A valódi tiltásokat jogosultságokkal és ellenőrzésekkel kell megoldani.

Korlátok és kockázatok

Soha ne írj bele jelszót, hozzáférési kulcsot vagy más titkot, mert a fájl a kóddal együtt terjed, és bárki elolvashatja, aki a projekthez hozzáfér.
Idegen projekt AGENTS.md fájlja rosszindulatú utasítást is tartalmazhat, ezért ismeretlen forrásból letöltött kódnál nézd át, mielőtt agentet engedsz rá.
A túl hosszú, elavult vagy önellentmondó fájl ront az eredményen, ezért rendszeresen karban kell tartani.
Nem minden eszköz olvassa be magától: néhány agent saját nevű fájlt vár, ilyenkor hivatkozni kell rá, vagy külön be kell állítani.

Hasonló, de nem ugyanaz

README – A README embereknek mutatja be a projektet, az AGENTS.md az agentnek szóló gyakorlati munkautasítás.
Rendszerprompt – A rendszerpromptot az eszköz készítője írja, és minden projektre érvényes. Az AGENTS.md-t te írod, és csak az adott projektre szól.
CLAUDE.md – A CLAUDE.md ugyanilyen célú fájl, de csak egyetlen eszköz, a Claude Code használja. Az AGENTS.md ezzel szemben gyártófüggetlen. A CLAUDE.md-ből hivatkozni lehet egy AGENTS.md fájlra, így a kettő együtt is használható.

Kapcsolódó fogalmak

Tágabb

AI-agent, Kontextusmérnökség, Nyílt szabvány

Szűkebb

–

Rokon

Kódoló agent, Rendszerprompt, Model Context Protocol, Agent-készségek, Promptinjektálás

Röviden a története

Az AGENTS.md 2025 nyarán jelent meg közös, nyílt formátumként. Több kódoló agentet fejlesztő cég dolgozott rajta együtt, köztük az OpenAI, a Google, a Cursor, a Factory és a Sourcegraph. 2025 decemberében a Linux Foundation keretében létrejött Agentic AI Foundation gondozásába került.

Hol tart most

2026 végén a kódoló agentek többsége beolvassa, és nyílt forráskódú projektek tízezrei használják. Hivatalos szabványtestület nem rögzítette, de a gyakorlatban ez a közös megoldás, bár néhány eszköz továbbra is saját fájlnevet használ.

Állapot: 2026. november

A hírekben

5 Agent Age-sztoriban fordul elő; a görbe a hírmagazin heti előfordulása.

Kódoló agentek a Letöltések mappába tett rosszindulatú fájlokkal eltéríthetők2026. okt. 26. · Kód
AGENTS.md fájllal térítették el az AI-kódolóagenteket a Letöltések mappából2026. okt. 25. · Kód
Claude Code: az AGENTS.md támogatás és az adatvédelem között kell választani2026. szept. 24. · Kód
A Claude Code már olvassa az AGENTS.md fájlt, az auto mód ellenőrzése pedig ingyenes2026. szept. 21. · Kód
Az Anthropic Claude Code Projects bétát indított, és összevonta a Claude csevegőt a Cowork-kel2026. szept. 16. · Agent Age

Más nevei

AGENTS.md · agents.md · Agents.md fájl · AGENTS.md szabvány · AGENTS.md format · agent-utasításfájl · agent instructions file

Források

A szócikk gépi szerkesztéssel készült és gépi szakmai lektoráláson ment át; a „hírekben” rész az Agent Age sztorijaiból automatikusan frissül.