Każde narzędzie do kodowania AI chce pliku Markdown z regułami twojego projektu. Ale wszystkie chcą innego pliku Markdown.

Jeśli używasz wielu narzędzi AI (a większość deweloperów tak robi), szybko staje się to mylące. Oto ostateczny przewodnik po tym, których plików potrzebujesz i co umieścić w każdym z nich.

Pliki w Skrócie

Plik	Narzędzie	Lokalizacja	Zakres
`AGENTS.md`	Uniwersalny (wszystkie narzędzia)	Główny katalog projektu	Wspólne reguły dla wszystkich agentów AI
`CLAUDE.md`	Claude Code	Główny katalog projektu	Instrukcje specyficzne dla Claude’a
`.cursor/rules/*.md`	Cursor	Katalog `.cursor/rules/`	Reguły specyficzne dla Cursor
`.github/copilot-instructions.md`	GitHub Copilot	Katalog `.github/`	Instrukcje specyficzne dla Copilot
`.windsurf/rules`	Windsurf	Katalog `.windsurf/`	Reguły specyficzne dla Windsurf
`JULES.md`	Google Jules	Główny katalog projektu	Instrukcje specyficzne dla Jules

AGENTS.md: Uniwersalny Standard

Najlepsze dla: Zespołów używających wielu narzędzi AI, projektów open source

AGENTS.md to najbliżej, co mamy do universalnego standardu. Jest teraz używany przez ponad 60 000 repozytoriów i jest zarządzany przez Agentic AI Foundation Linux Foundation (wraz z MCP i goose).

Umieść tu swoje wspólne instrukcje --- rzeczy, które każde narzędzie AI powinno wiedzieć:

Struktura projektu i architektura
Polecenia budowania i testowania
Konwencje stylu kodu
Typowe wzorce i anty-wzorce
Zależności i kroki konfiguracji

Każde główne narzędzie do kodowania AI czyta AGENTS.md, czyniąc go jedynym źródłem prawdy dla instrukcji AI twojego projektu.

CLAUDE.md: Pamięć Claude Code

Najlepsze dla: Użytkowników Claude Code, zespołów standaryzujących się na Anthropic

CLAUDE.md jest automatycznie czytany na początku każdej sesji Claude Code. Obsługuje niektóre funkcje specyficzne dla Claude’a, takie jak trwałość pamięci i kontekst sesji.

Używaj CLAUDE.md dla:

Dostosowań zachowania specyficznych dla Claude’a
Funkcji obsługiwanych tylko przez Claude Code
Nadpisywania lub rozszerzania AGENTS.md dla Claude’a

Zalecany wzorzec: wspólne reguły w AGENTS.md, dodatki specyficzne dla Claude’a w CLAUDE.md.

.cursorrules / .cursor/rules/: Podejście Cursor

Najlepsze dla: Użytkowników Cursor, zespołów używających Cursor jako głównego IDE

Cursor pierwotnie używał pojedynczego pliku .cursorrules, a następnie ewoluował do katalogu .cursor/rules/ dla bardziej szczegółowej kontroli. Każdy plik w katalogu to oddzielna reguła, którą Cursor stosuje.

Używaj reguł Cursor dla:

Zachowania agenta specyficznego dla Cursor
Reguł dla trybów Composer i Agent w Cursor
Instrukcji specyficznych dla typów plików (np. różne reguły dla .tsx vs .py)

copilot-instructions.md: Konwencja GitHub

Najlepsze dla: Użytkowników GitHub Copilot, przepływów pracy skoncentrowanych na GitHub

GitHub Copilot czyta .github/copilot-instructions.md dla instrukcji na poziomie projektu. Podąża za konwencją GitHub umieszczania konfiguracji w katalogu .github/.

Zalecana Konfiguracja

Dla większości projektów potrzebujesz co najwyżej dwóch plików:

Jeśli używasz jednego narzędzia AI:

Po prostu użyj natywnego pliku tego narzędzia (CLAUDE.md dla Claude Code, .cursor/rules/ dla Cursor, itp.).

Jeśli używasz wielu narzędzi AI:

AGENTS.md --- wszystkie wspólne reguły (architektura, polecenia build, konwencje)
Plik specyficzny dla narzędzia --- tylko dla funkcji unikalnych dla tego narzędzia

Przykładowa struktura:

twoj-projekt/
  AGENTS.md              # Wspólne: polecenia build, architektura, konwencje
  CLAUDE.md              # Specyficzne dla Claude'a: preferencje pamięci, użycie narzędzi
  .cursor/rules/style.md # Specyficzne dla Cursor: zachowanie composer
  .github/copilot-instructions.md  # Specyficzne dla Copilot

Co Umieszczać w Regułach

Na podstawie analizy tysięcy repozytoriów, najskuteczniejsze pliki instrukcji zawierają:

Zawsze umieszczaj:

Jak budować i uruchamiać projekt
Jak uruchamiać testy
Kluczowe decyzje architektoniczne
Preferencje stylu kodu

Często pomocne:

Czego NIE robić (negatywne instrukcje działają zaskakująco dobrze)
Wyjaśnienia struktury plików
Typowe kroki debugowania
Polecenia zarządzania zależnościami

Pomijaj:

Oczywiste funkcje językowe
Rzeczy, które AI już zna
Zbyt szczegółowe reguły (zacznij minimalnie, dodawaj w miarę potrzeb)

Budowanie Reguł AI z Kontekstem Webowym

Pisanie dobrych plików instrukcji AI często wymaga odwoływania się do zewnętrznej dokumentacji, przewodników stylu lub wzorców architektonicznych. Tu właśnie pomocne jest posiadanie treści webowej w formacie Markdown.

Na przykład, jeśli twój projekt podąża za konkretnym wzorcem API ze strony dokumentacji, możesz:

Użyć Save do konwersji tej strony dokumentacji na Markdown
Odwołać się lub zacytować odpowiednie sekcje w AGENTS.md
Twój asystent kodowania AI ma teraz pełny kontekst

To samo dotyczy dokumentacji frameworków, przewodników stylu, artykułów o najlepszych praktykach i rozwiązań Stack Overflow. Czysty Markdown to format, z którym zarówno ty, jak i twoje narzędzia AI mogą pracować najefektywniej.

Wniosek

Ekosystem reguł kodowania AI wciąż się rozwija, ale wzorzec jest jasny: to wszystko Markdown. Niezależnie od tego, czy używasz jednego narzędzia czy pięciu, instrukcje AI twojego projektu żyją w plikach Markdown, które są kontrolowane wersyjnie, czytelne dla człowieka i parsowalny maszynowo.

Zacznij od AGENTS.md dla zasad uniwersalnych, dodawaj pliki specyficzne dla narzędzi w razie potrzeby i utrzymuj wszystko w minimum, dopóki nie zobaczysz powtarzającego się problemu wartego rozwiązania.

Save konwertuje dowolną stronę internetową na czysty Markdown --- idealny do budowania materiałów referencyjnych i kontekstu dokumentacji, których potrzebują twoi asystenci kodowania AI. Wypróbuj Save za darmo.