"Ko e ngaahi ma'u'anga tokoni lahi taha mei he kau fakafofonga coding 'o e AI 'oku 'ikai ke ha'u ia mei he ngaahi fakalelei'i 'o e sipinga — 'oku nau ha'u mei he tu'unga lelei ange. AGENTS.md ko e lever fakahangatonu taha ia 'oku ma'u 'e he kau developers ke fakalelei'i 'a e tonu 'o e fetu'utaki 'a e fakafofonga kotoa pe 'i honau fale tuku'anga koloa."

Ko e ngaahi ako fakaekeeke 'o e mamani mo'oni mei he ngaahi timi fakalakalaka 'o faka'aonga'i 'a e ngaahi me'angaue 'o e kau fakafofonga 'i he monorepos lalahi 'oku fakahaa'i ai 'oku fakasi'isi'i lahi 'e he AGENTS.md 'a e "hallucination drift" — 'a e hehema 'a e kau fakafofonga ke fakafe'iloaki 'a e ngaahi founga ta'emaheni pe hala 'a e ngaahi fakataha'anga 'o e poloseki. Ko e ngaahi timi 'oku nau tauhi 'a e ngaahi faile AGENTS.md fakamuimuitaha 'oku nau lipooti 'a e ngaahi siakale vakai'i si'isi'i ange mo e taimi fakataha'i vave ange 'i he ngaahi kole toho 'oku tokoni'i 'e he AI.

'Oku anga fefe hono fakafehoanaki 'o e AGENTS.md ki he ngaahi founga fakahinohino kehe 'a e kau fakafofonga?

AGENTS.md ki hono fakafekau'aki 'o e kau fakafofonga 'o e AI. 'Oku kau 'i he ngaahi founga kehe 'a e ngaahi faka'ai'ai 'o e sisitemi 'oku huhu 'i he tu'unga 'o e API, ngaahi fakamatala 'i he laine, mo e ngaahi tohi README 'o e poloseki-fakakatoa. ʻOku takitaha ʻi ai ʻene ngaahi fefakatauʻaki. 'Oku malohi 'a e ngaahi ue'i 'o e sisitemi ka 'oku ephemeral — 'oku 'ikai ke nau nofo 'i loto 'i he fale tuku'anga koloa 'iate ia pe, 'o 'ai ke nau faingata'a ange ke version-pule'i mo vahevahe 'i he ngaahi timi. 'Oku 'omi 'e he ngaahi faile README 'a e tu'unga 'oku lava ke lau 'e he tangata ka 'oku 'ikai ke parsed ma'u pe 'e he kau fakafofonga ko e ngaahi ma'u'anga fakahinohino 'oku ma'u mafai.

AGENTS.md nofo'i ha kelekele makehe 'i loto: 'oku version-pule'i 'i he tafa'aki 'o e codebase, 'oku lava ke lau 'e he tangata, pea 'oku fakautuutu hono 'ilo'i ko ha fotunga 'o e input angamaheni 'e he ngaahi me'angaue fakafofonga fakaonopooni. 'Oku ne toe scales fakanatula — 'e lava ke ke fokotu'u 'a e ngaahi faile kehekehe 'o e AGENTS.md 'i he ngaahi subdirectories ke 'oange ki he kau fakafofonga 'a e ngaahi fakahinohino granular ki he ngaahi modules pau pe ngaahi ngaue. Ki ha tu'unga hange ko Mewayz, 'a ia 'oku spans 'e he logic pisinisi 'a e me'a kotoa pe mei he CRM mo e e-commerce ki he pule'i 'o e ako mo e ngaahi me'angaue 'o e fengaue'aki 'a e timi 'i he 207 modules, 'Oku tautautefito ki he founga layered ko 'eni 'oku fe'unga lelei.

'Oku Totonu ke Fakahū Taimi 'e he Timi Fakalakalaka Kotoa pe ki hono Tohi 'o e Ngaahi Faile AGENTS.md?

Ki he ngaahi timi 'oku nau faka'aonga'i malohi 'a e kau fakafofonga coding 'o e AI — pea 'oku tupulaki vave 'a e fika ko ia — 'oku mahino 'a e tali 'io. Ko e taimi 'inivesi 'i hono tohi 'o ha faile AGENTS.md 'o e tu'unga lelei 'oku faka'apa'apa 'i hono fakafehoanaki ki he compounding 'o e tonu ange, contextually fe'unga 'a e 'ulungaanga fakafofonga 'i he tafa'aki 'o e ngaue kotoa pe 'oku hoko mai. Ko e feinga fakapepa taimi 'e taha ia 'oku totongi 'a e ngaahi vahenga 'i he fetu'utaki kotoa pe 'a e kau fakafofonga.

Ki he ngaahi timi fo'ou ki he fakalakalaka faka'asenita, kamata faingofua 'oku 'aonga haohaoa. Na'a mo ha 20-laine AGENTS.md 'oku ne 'ufi'ufi ho'o fekau 'o e sivi 'o e lele, ngaahi manako 'o e sitaila coding, mo e ngaahi fakahinohino 'o e off-limits 'e fakatupu 'e he ngaahi fakalakalaka 'oku fakatokanga'i. 'I ho'o faka'aonga'i 'o e kau fakafofonga 'o e AI matu'otu'a, 'e lava ke tupulaki 'a e faile ke fakahaa'i 'a e ngaahi fie ma'u 'o e poloseki nuanced ange.

Ngaahi Fehuʻi ʻoku Faʻa ʻEke

'Oku tatau 'a e AGENTS.md mo e CLAUDE.md pe ko ha ngaahi faile fakahinohino kehe 'oku fakatefito 'i he AI?

ʻOku nau fakahoko ha ngaahi taumuʻa tatau ka ʻoku ʻikai ke nau tatau. 'Oku fakatefito 'a e CLAUDE.md ki he me'angaue 'a e Anthropic 'a e Claude Code, lolotonga ia ko e AGENTS.md ko ha fotunga lahi ange 'oku ne ma'u 'a e ohi 'i he ngaahi tu'unga fakafofonga lahi kau ai 'a kinautolu 'oku langa 'i he ngaahi sipinga 'o e OpenAI. ʻOku lau fakatouʻosi ʻe he ngaahi meʻangāue ʻe niʻihi; ko e ni‘ihi ‘oku nau fakamu‘omu‘a ‘a e taha ‘i he taha. Ko e founga lelei ke tauhi fakatou'osi kapau 'oku faka'aonga'i 'e ho'o timi 'a e ngaahi fakafofonga coding AI lahi, mo e ngaahi fakataha'anga vahevahe 'oku fakahaa'i 'i he takitaha.

Ko e hā hono lahi ʻo e taimi ʻoku totonu ke fakafoʻou ai ʻa e ngaahi faile AGENTS.md?

AGENTS.md 'oku totonu ke ngaue'aki hange ko e ngaahi tohi mo'ui — fakafo'ou 'i ha taimi pe 'oku liliu lahi ai 'a e 'atakai 'o ho'o poloseki, tooling, pe ngaahi fakataha'anga. 'E lava ke mo'oni 'a e stale AGENTS.md counterproductive, taki 'a e kau fakafofonga ke faka'aonga'i 'a e ngaahi founga motu'a. 'Oku ngaue lelei 'a e cadence 'o e vakai'i fakakuata ki he ngaahi poloseki tu'uma'u, lolotonga ia 'e fie ma'u nai 'e he codebases 'oku nga'unu vave 'a e ngaahi fakafo'ou 'i he liliu faka'ata lahi takitaha.

'E lava ke fakamamahi'i 'e he AGENTS.md 'a e fakahoko ngaue kapau 'e kovi hono tohi?

'Io, 'e lava ke fakafe'iloaki 'e he ngaahi faile AGENTS.md 'oku kovi hono tohi 'a e puputu'u kae 'ikai ko e mahino. 'E lava ke fakatupu 'e he ngaahi fakahinohino fepakipaki, fu'u fakangatangata 'a e ngaahi faka'uhinga 'o e scope, pe lea 'oku 'ikai mahino 'a e kau fakafofonga ke nau toumoua, fakatupu 'a e ngaahi outputs suboptimal, pe ta'etokanga'i 'a e ngaahi konga 'o e faile 'o faka'aufuli. Ko e kī ko e pau mo e tu'uma'u — mahino, ta'e-mahino 'a e ngaahi fakahinohino 'oku makatu'unga 'i ho'o ngaahi fie ma'u mo'oni 'o e poloseki 'e outperform ma'u pe 'a e fakahinohino fakalukufua pe faka'amu.