Rdzeń · krok 3/5Rdzeń programu czytasz bez konta. Quizy, zapis postępu i biblioteka — dla członków.
Agent wie tylko to, co mu pokażesz — i nie wszystko, co mu pokażesz, pomaga. Inżynieria kontekstu to decyzja, co trafia do jego pola widzenia, na jakim poziomie szczegółu i co z niego wyrzucić, zanim zacznie przeszkadzać.
- 1Wynik zależy od tego, co agent widzi — nie od tego, jak ładnie poprosisz. Lepszy kontekst daje lepszy wynik szybciej niż lepsze sformułowanie.
- 2Wskazujesz zamiast wklejać — agent sam czyta pliki, więc twoja praca to wybór i granice, nie kopiowanie.
- 3Wiesz, kiedy zacząć od nowa — zarośnięta sesja to częsta przyczyna „agent nagle zgłupiał". Czysta sesja z dobrym zleceniem wygrywa z kolejną poprawką.
- 4Mniej szumu, mniejszy koszt — kontekst bez śmieci to mniej tokenów i mniej pomyłek.
Kontekst to skończony budżet uwagi
Prompt engineering dopracowuje jedną wiadomość. Inżynieria kontekstu projektuje wszystko, co agent widzi: stałe reguły, materiał, stan sprawy, historię sesji. Agent pracuje dłużej niż jedną wiadomość — więc to drugie decyduje o wyniku.
Okno kontekstu jest duże, ale uwaga modelu nie rozkłada się po nim równo. Im więcej w nim rzeczy nieistotnych, sprzecznych albo nieaktualnych, tym łatwiej zgubić to, co ważne. Dlatego „daj wszystko" nie jest strategią — a „daj mało i licz, że się domyśli" też nie.
Pytanie, które zadajesz przed każdym zleceniem: co agent musi zobaczyć, żeby zrobić to dobrze — i co go od tego odciąga?
Zasada Złotowłosej
codeZa mało kontekstu → agent zgaduje, daje ogólne wyniki Za dużo kontekstu → agent się gubi, myli ważne z przypadkowym W sam raz → agent rozumie zadanie i jego granice
Cztery rodzaje kontekstu
- •Materiał — pliki, dokumenty, dane, na których agent pracuje.
- •Stan sprawy — co już wiadomo: komunikat błędu, wcześniejsze ustalenia, co nie zadziałało.
- •Wymagania — co ma powstać i po czym poznasz, że jest dobrze („skończone, gdy…").
- •Stała umowa — konwencje, ton, zasady, które obowiązują zawsze (moduł „Pliki kontekstowe").
Wskazanie, nie kopiowanie
Czat trzeba było karmić wklejonym tekstem. Agent czyta sam — więc zamiast kopiować 500 linii albo całą umowę, wskazujesz:
code❌ [wklejone 40 stron raportu] „streść to" ✅ „Przeczytaj raport_Q3.pdf, sekcje 2 i 4. Pomiń załączniki." ❌ [wklejony cały plik] „tu jest błąd" ✅ „Błąd jest w src/auth/login.ts, przy pobieraniu sesji. Komunikat: …"
W Claude Code wskazujesz plik albo folder przez @ (np. @src/auth/login.ts). W Cowork — pracujesz na wskazanym folderze. Zasada ta sama: agent sam doczyta, czego potrzebuje, a ty mówisz, od czego zacząć i czego nie ruszać.
Strategie
Minimum, które wystarcza
Zacznij od minimum i dodawaj, gdy agent pyta albo widać, że zgaduje. Możesz to zamówić wprost: „Zanim zaczniesz, zadaj mi pytania o to, czego nie wiesz".
Warstwy: od ogółu do szczegółu
codeWarstwa 1: o co chodzi „Raport dla zarządu, decyzja: który dostawca" Warstwa 2: materiał „Oferty w folderze /oferty, cennik z 2026" Warstwa 3: konkretny problem „Dostawca B ma dwie sprzeczne ceny — rozstrzygnij"
Poziom szczegółu pod poziom pytania
Pytasz o decyzję strategiczną, a dajesz same szczegóły techniczne — dostaniesz odpowiedź technicznie poprawną, strategicznie chybioną. Decyzja → cel, ograniczenia, alternatywy. Wykonanie → pliki, dane, konwencje.
Długie sesje: kontekst zarasta
Agent pracuje w jednej sesji i wszystko, co się w niej wydarzyło, zostaje w kontekście: próby, błędy, porzucone pomysły. Po godzinie pracy to już nie jest czysty stół.
To nie awaria ani „zmęczenie" modelu. Im dłuższe wejście, tym trudniej modelowi trafić w to, co ważne — uwaga rozkłada się na coraz więcej rzeczy. Kto tego nie wie, myśli, że „AI się popsuło". Kto wie, zaczyna od nowa: z krótkim podsumowaniem albo z plikiem z planem.
- •Nowe zadanie → nowa sesja. Nie ciągnij historii poprzedniego zadania do następnego. W Claude Code:
/clear. - •Długa sesja → kompaktowanie. Gdy historia rośnie, streszczenie zastępuje szczegóły (w Claude Code
/compact, czasem dzieje się to automatycznie). Wiedz, że szczegóły z początku mogą wtedy zniknąć. - •Plan i notatki w pliku. Przy długim zadaniu poproś agenta, żeby prowadził plik z planem i ustaleniami. Plik przetrwa nową sesję; historia rozmowy — nie.
- •Osobny kontekst na osobne zadanie. Subagent w Claude Code pracuje we własnym kontekście i oddaje tylko wynik — research nie zaśmieca głównej sesji.
Antywzorce
- •Zrzut wszystkiego — „oto cały projekt" → agent odpowiada ogólnikowo.
- •Zero kontekstu — „napraw to" → agent nie wie co, gdzie ani po czym poznać sukces.
- •Kontekst z innej bajki — pytasz o frontend, pokazujesz backend → agent myli się w domysłach.
- •Nieaktualna umowa — instrukcje sprzed trzech miesięcy mówią o narzędziu, którego już nie używacie. Nieaktualna notatka szkodzi bardziej niż jej brak.
Z życia: opisy produktów w tonie marki
Marek pisze opisy produktów dla sklepu. Na początku za każdym razem wklejał nazwę produktu i prosił o opis — i za każdym razem poprawiał ton w kilku rundach.
Zamiast poprawiać wyniki, poprawił kontekst:
Stała umowa — ton marki zapisany raz:
markdown# Marka: EcoNest ## Ton: ciepły, konkretny, nigdy nachalny ## Styl: krótkie zdania. Fakty > przymiotniki. ## NIE używaj: najlepszy, rewolucyjny, musisz mieć
Trzy przykłady najlepszych opisów (moduł „Ucz przez przykłady"):
codeProdukt: Bambusowa szczoteczka Opis: Biodegradowalny trzonek, nylonowe włosie. 12 miesięcy w ziemi — znika. Zero plastiku w ustach.
Format wyniku: nagłówek do 8 słów, opis 40–60 słów, 3 cechy.
Co zaobserwował: rundy poprawek tonu prawie zniknęły, a jego praca przesunęła się z przepisywania na wybór i drobne szlify. Nie dlatego, że AI „zrobiło więcej" — tylko dlatego, że wreszcie wiedziało, w czym pracuje.
Checklist przed zleceniem
code□ Czy agent wie, NA CZYM pracuje? (pliki, folder, źródła — wskazane, nie wklejone) □ Czy wie, CO JUŻ WIADOMO? (błąd, ustalenia, co nie zadziałało) □ Czy wie, PO CZYM POZNA, że skończył? (kryterium odbioru) □ Czy wie, CZEGO NIE RUSZAĆ? (granice) □ Czy w kontekście nie ma śmieci? (stara historia, nieaktualne instrukcje)