Co pisać w CLAUDE.md, a co dołączać do pojedynczego zadania
Claude Code przy starcie czyta CLAUDE.md z repozytorium. Codex i wiele innych agentów ma taki sam plik, AGENTS.md. Wygodnie jest w nim trzymać wszystko, co agent powinien wiedzieć o projekcie: jak uruchomić testy, co gdzie leży, jakie są zasady kodu.
Z czasem plik rośnie i pojawiają się w nim instrukcje, które nie są potrzebne w każdym zadaniu.
Przykład: recenzenci po programowaniu
Przydatny sposób w zadaniach z kodem to niezależni recenzenci. Po programowaniu agent uruchamia osobnych subagentów, którzy nie widzieli, jak powstawał kod. Czytają zmiany i porównują je z zadaniem oraz zasadami projektu. Jeden sprawdza, czy zrobiono to, o co prosiliśmy. Drugi - styl i zbędny kod. To, co znajdą, agent poprawia, zanim napisze „gotowe”.
Taka instrukcja zajmuje kilkanaście linijek. Jeśli trafi do CLAUDE.md, agent dostanie ją w każdej sesji: i w zadaniu o tekście na landing page, i przy analizie logów, gdzie nie ma kodu do recenzji. To zbędny kontekst, a czasem zbędna praca.
Wpisywanie jej ręcznie w każdym zadaniu też jest niewygodne. Łatwo o niej zapomnieć, a przy kopiowaniu ze starego zadania łatwo wziąć nieaktualną wersję.
Instrukcja dla jednego rodzaju zadań
W Tascue taka instrukcja staje się wstawką, na przykład „Niezależni recenzenci”. Zaznacza się ją w zadaniach, w których zmienia się kod, a przy kopiowaniu trafia na koniec promptu. W zadaniach o tekstach i badaniach po prostu jej nie ma.
Jeśli wstawka pojawiła się, gdy w backlogu jest już dużo zadań, można dodać ją do wszystkich naraz: „Zastosuj do wszystkich zadań w backlogu”. Zadania w toku i zrobione się nie zmienią.
Co gdzie wpisać
| Instrukcja | Gdzie ją trzymać |
|---|---|
| Potrzebna w każdym zadaniu w tym repozytorium: jak uruchomić testy, jak zbudowany jest projekt | CLAUDE.md |
| Potrzebna w zadaniach jednego rodzaju: recenzja kodu, sprawdzanie w przeglądarce, zasady tekstów | Wstawka projektu |
| Potrzebna we wszystkich projektach: „nie rób commitów” | Wspólna wstawka, domyślnie uwzględniana w nowych zadaniach |
| Potrzebna w jednym zadaniu | Treść zadania |
Prosty test dla nowej instrukcji: czy jest potrzebna w każdym zadaniu? Jeśli nie, jej miejsce jest we wstawce, a CLAUDE.md zostaje krótki i da się go przeczytać w minutę.
Prompt z zadania składa się sam: intro, pola, tekst, wstawki. W Claude Code można go wkleić po „Kopiuj” albo przekazać przez MCP - agent dostaje to samo zadanie w całości.