CLAUDE.md, AGENTS.md i meta-prompting — zamknięcie cyklu

Problem: Agent nie zna Twojego projektu

Każdy agent AI zaczyna sesję od zera. Nie wie jaki masz stack, jak uruchomić testy, jakie macie konwencje. Za każdym razem tłumaczysz to samo.

Rozwiązanie: pliki instrukcji w repozytorium — agent czyta je automatycznie.

Przegląd plików

Plik	Agent	Opis
CLAUDE.md	Claude Code	Pamięć projektu, czytany automatycznie
AGENTS.md	Codex, Copilot, Cursor	Standard otwarty (Linux Foundation)
DEVIN.md	Devin	Konfiguracja per-repo
docs/	Wszystkie	Szczegółowa dokumentacja on-demand

Co powinien zawierać?

Myśl o tym jak o onboardingu nowego członka zespołu z amnezją:

• Komendy — jak uruchomić dev server, testy, linter
• Architektura — katalogi, stack, zależności
• Konwencje — format commitów, code style, branching
• Ważne zasady — co NIE wolno robić (np. modyfikować migracje)
• Workflow testowy — pattern, reporting, tagowanie

Progressive Disclosure

CLAUDE.md powinien mieć poniżej 300 linii. Szczegóły w docs/:

CLAUDE.md              ← Krótki briefing
docs/
  architecture.md      ← Szczegóły architektury
  test-strategy.md     ← Strategia testowa
  api-spec.md          ← Specyfikacja API

Czego NIE wrzucać

• Reguły stylu kodu — od tego jest linter
• Oczywistości — „to jest projekt React” (widać z package.json)
• Sekrety — hasła, tokeny, klucze API
• Całą dokumentację — użyj docs/

---

Meta-prompting: prompt tworzący prompt

Najważniejsza rada z całego cyklu:

Jeśli nie wiesz jak napisać dobry prompt — poproś AI, żeby go napisał za Ciebie.

Szablon uniwersalny

Chcę użyć frameworka [NAZWA] do [CEL].
Kontekst: [krótki opis sytuacji]
Wygeneruj mi gotowy prompt do skopiowania.

Cheat sheet: jeden prompt, żeby rządzić wszystkimi

Jestem testerem QA. Chcę osiągnąć: [CEL].
Mój kontekst: [2-3 zdania].

Zaproponuj:
1. Który framework promptowy będzie najlepszy
2. Który model/narzędzie AI użyć
3. Gotowy prompt do skopiowania

Ten jeden prompt zastępuje całą wiedzę z tego cyklu — AI samo dobierze framework i model.

---

Podsumowanie cyklu

• Framework promptowy to nie magia — to struktura myślenia
• Auto QA ≈ Dev — narzędzia do auto QA to narzędzia deweloperskie
• Multi-agent to przyszłość — żaden agent nie jest najlepszy we wszystkim
• Eksperymentuj — ten sam prompt w ChatGPT, Claude i Gemini da różne wyniki
• Niech AI pisze prompty za Ciebie — z czasem zaczniesz robić to intuicyjnie

Dziękuję za wspólną podróż przez 16 wpisów. Mam nadzieję, że przynajmniej jeden framework lub scenariusz znajdzie zastosowanie w Twojej codziennej pracy.

Grzegorz Holak — Test Architect & AI Ambassador