Pliki instrukcji agentów
Każdy agent do programowania przed rozpoczęciem pracy wczytuje plik projektu ze stałymi instrukcjami. Sprawdź, gdzie szuka go każde narzędzie, jakie frontmatter rozpoznaje oraz jak łączone są pliki globalne, projektowe i zagnieżdżone. Informacje zweryfikowano z dokumentacją dostawców 2026-10-01.
Które narzędzie odczytuje który plik
| Narzędzie | Odczytuje | AGENTS.md |
|---|---|---|
| OpenAI Codex | AGENTS.mdAGENTS.override.md~/.codex/AGENTS.md | Natywnie |
| Claude Code | CLAUDE.mdCLAUDE.local.md.claude/rules/*.md~/.claude/CLAUDE.mdAGENTS.md | Natywnie |
| Cursor | .cursor/rules/*.mdcAGENTS.md | Natywnie |
| GitHub Copilot | .github/copilot-instructions.md.github/instructions/*.instructions.mdAGENTS.mdCLAUDE.mdGEMINI.md | Natywnie |
| Gemini CLI | GEMINI.md~/.gemini/GEMINI.md.gemini/settings.json | Przez konfigurację |
| Devin Desktop (dawniej Windsurf) | .devin/rules/*.md.windsurf/rules/*.md.windsurfrules~/.codeium/windsurf/memories/global_rules.mdAGENTS.md | Natywnie |
| Cline | .clinerules/*.md.cline/rules/*.mdAGENTS.md.cursorrules.windsurfrules | Natywnie |
| Aider | .aider.conf.yml | Przez konfigurację |
| OpenClaw | AGENTS.mdSOUL.mdIDENTITY.mdUSER.mdMEMORY.md | Natywnie |
Używaj jednego pliku AGENTS.md jako źródła prawdy i odsyłaj do niego pozostałe narzędzia. Siedem z dziewięciu wymienionych narzędzi odczytuje go bez dodatkowej konfiguracji; Gemini CLI i Aider wymagają po jednej linii konfiguracji, a plik CLAUDE.md zawierający wyłącznie @AGENTS.md pozwala zachować zgodność ze starszymi wersjami Claude Code. Używaj natywnego formatu reguł danego narzędzia tylko w przypadku reguł przypisanych do ścieżek, których nie da się opisać w AGENTS.md.
Wszystkie pliki instrukcji
AGENTS.mdAGENTS.md
AGENTS.md to zwykły plik Markdown z instrukcjami dla projektu, który większość agentów programistycznych odczytuje bez dodatkowej konfiguracji. OpenAI przekazało go Agentic AI Foundation działającej przy Linux Foundation. Korzysta z niego ponad 60k projektów open source.
CLAUDE.mdCLAUDE.md (Claude Code)
CLAUDE.md to plik pamięci, który Claude Code wczytuje przy uruchomieniu z katalogu domowego, projektu i każdego katalogu nadrzędnego. Reguły zależne od ścieżki w .claude/rules/ dostarczają wskazówek wczytywanych tylko podczas odczytu pasujących plików.
GEMINI.mdGEMINI.md (Gemini CLI)
GEMINI.md to plik kontekstu, który Gemini CLI dołącza do każdego promptu. Może też odczytywać AGENTS.md lub dowolną inną nazwę ustawioną w context.fileName.
.cursor/rules/*.mdcCursor Project Rules (.cursor/rules/*.mdc)
Reguły projektu Cursor to pliki .mdc w .cursor/rules/, których frontmatter określa, kiedy dana reguła jest dołączana. Cursor odczytuje też AGENTS.md, a także reguły użytkownika i zespołu skonfigurowane poza repozytorium.
.github/copilot-instructions.mdGitHub Copilot custom instructions
GitHub Copilot odczytuje jeden plik dla całego repozytorium: .github/copilot-instructions.md, a także pliki .instructions.md przeznaczone dla konkretnych ścieżek. Uwzględnia też AGENTS.md albo pojedynczy plik CLAUDE.md lub GEMINI.md w katalogu głównym.
.devin/rules/*.mdDevin Desktop (Windsurf) rules
Devin Desktop, nowa nazwa Windsurf od 2026-06-02, odczytuje pliki reguł z .devin/rules/ i nadal obsługuje .windsurf/rules/ oraz starszy plik .windsurfrules. Ustawienie wyzwalacza każdej reguły decyduje, czy jest ona zawsze aktywna, dopasowywana przez glob, wybierana przez model czy wywoływana ręcznie.
.clinerules/Cline Rules (.clinerules/)
Reguły Cline to pliki Markdown w .clinerules/, które Cline łączy z regułami globalnymi i AGENTS.md. Opcjonalny frontmatter paths ogranicza regułę do pasujących plików.
~/.openclaw/workspace/AGENTS.mdOpenClaw workspace bootstrap files
OpenClaw buduje kontekst każdego agenta na podstawie plików startowych Markdown w jego obszarze roboczym. Najważniejszy z nich to wymagany plik AGENTS.md. Pliki te są wstrzykiwane do system promptu w pierwszej turze każdej nowej sesji.