# Ścieżka dewelopera: plan czytania do inżynierii agentowej

URL: https://developertoolkit.ai/pl/start/developer/
Description: Ścieżka czytania dla programistów: od drabiny autonomii i szybkiego startu narzędzia do specyfikacji, pętli testów i oceniania dowodów zamiast diffów.

Ścieżka dewelopera to uporządkowany plan czytania dla programistów, którzy używają Cursora, Claude Code albo Codeksa. Zaczyna się od darmowego punktu odniesienia, scorecardu dewelopera, a potem prowadzi w górę drabiny autonomii: od pierwszego prawdziwego zadania do oceniania dowodów zamiast każdego diffa. Każdy krok kończy się artefaktem, który dowodzi, że krok jest ukończony.

Już używasz agenta. Czasem oszczędza ci popołudnie, a czasem spędzasz popołudnie na czytaniu tego, co napisał, bo nic ci nie mówi, czy możesz mu ufać. Ścieżka poniżej układa nawyki, które to naprawiają, w kolejności, w jakiej zaczynają się opłacać.

## Co daje ścieżka dewelopera

- **Kolejność, w której efekty się sumują.** Każdy krok zakłada poprzedni: plik instrukcji sprawia, że pętla informacji zwrotnej działa niezawodnie, a pętla sprawia, że równoległa praca agentów jest bezpieczna.
- **Kryterium „Gotowe, gdy” dla każdego kroku.** Idziesz dalej, gdy istnieje artefakt, a nie wtedy, gdy lektura wydaje się skończona.
- **Osobna gałąź dla każdego narzędzia** tam, gdzie narzędzia się różnią, i jeden wspólny krok tam, gdzie się nie różnią.

## Jak korzystać ze ścieżki dewelopera?

1. Najpierw wypełnij [scorecard dewelopera](/pl/scorecard/). Odpowiedzi pokażą, które kroki możesz pominąć, a [klucz odpowiedzi](/pl/developer-scorecard-guide/) przypisuje każde pytanie do strony, która je poprawia.
2. Kroki od 1 do 3 czytaj po kolei. Wszystko dalej zakłada zainstalowane narzędzie i przejrzany plik instrukcji.
3. Po kroku 3 pomijaj każdy krok, którego artefakt „Gotowe, gdy” już masz.
4. Po czterech tygodniach wypełnij scorecard ponownie i porównaj wyniki sekcji.

<TrackList role="developer" lang="pl" />

## Którą gałąź narzędzia wybrać?

Krok 2 rozgałęzia się według narzędzia; reszta ścieżki jest wspólna, a każda podlinkowana strona pokazuje wszystkie trzy narzędzia tam, gdzie się różnią. Jeśli narzędzie nie jest jeszcze wybrane, najpierw przeczytaj [porównanie narzędzi](/pl/comparison/).

| | Cursor | Claude Code | Codex |
| --- | --- | --- | --- |
| Szybki start | [Szybki start w Cursorze](/pl/cursor-ide/quick-start/) | [Szybki start w Claude Code](/pl/claude-code/quick-start/) | [Szybki start w Codeksie](/pl/codex/quick-start/) |
| Plik instrukcji (krok 3) | Rules | `CLAUDE.md` | `AGENTS.md` |
| Planowanie tylko do odczytu | Plan Mode | `claude --permission-mode plan` albo `/plan` | `/plan` |
| Praca równoległa | Worktrees | `claude -w <nazwa>` | `codex --worktree` |
| Kontrole w trybie headless | tryb print w CLI Cursora (`-p`) | `claude -p` | `codex exec` |

Polecenia Claude Code i Codeksa sprawdzono 26 września 2026 r. w Claude Code 2.1.283 i Codex CLI 0.157.1. Funkcje Cursora ostatnio zweryfikowano 28 sierpnia 2026 r. Claude Code czyta `AGENTS.md`, gdy projekt nie ma `CLAUDE.md`, od wersji 2.1.277, na obu kanałach wydań, odkąd `stable` doszedł do v2.1.287 (sprawdzone 2026-10-12).

**Prompt do skopiowania: zamień tę ścieżkę w plan dla swojego repozytorium**

```text
I am following a learning path for agentic engineering. Read this repository and tell me:
1) whether it has an agent instructions file (CLAUDE.md, AGENTS.md or Cursor project rules) and what is missing from it,
2) the single command that runs the tests, lint and type checks, or that there is none,
3) which of these is weakest here: instructions file, feedback loop, test coverage, parallel-work setup.
Recommend the one step to work on first and the evidence that would show it is done. Do not change any files.
```

## Jak udowodnić, że krok jest ukończony, bez czytania każdej linii?

Kryteria ukończenia są tak zbudowane, żeby na pytanie „czy to gotowe” odpowiadała kontrola, a nie twoja lektura. Uczciwość zapewniają trzy zasady:

- **Rozstrzyga jedno polecenie.** Od kroku o pętli informacji zwrotnej każde zadanie kończy się tym, że agent uruchamia jedno polecenie repozytorium do testów, lintu i sprawdzania typów, a potem raportuje jego status wyjścia. Dowodem jest zerowy status polecenia, któremu ufasz, a nie podsumowanie agenta.
- **Agent nie może osłabić kontroli.** Testy, które agent może edytować, niczego nie dowodzą. Zablokuj kontrole, których nie wolno mu osłabić, hookiem albo regułą CI (to krok 8 tej ścieżki, [ochrona wyroczni](/pl/workflows/test/protect-the-oracle/)), a CI niech uruchamia to samo polecenie przy każdym pull requeście.
- **Czytasz kontrakt, a nie diff.** Od kroku o łańcuchu artefaktów oceniasz intencję, specyfikację i plan, zanim agent napisze kod, a po zakończeniu porównujesz z nimi dowody. Kod linia po linii nadal czytasz tam, gdzie zmiana jest wysokiego ryzyka albo brakuje dowodów.

**Prompt do skopiowania: zbierz dowody dla jednego ukończonego zadania**

```text
You just finished the task. Do not change any code. Produce an evidence report:
1) the acceptance criteria you worked to, quoted from the spec or issue,
2) for each criterion, the test that covers it and whether it passed,
3) the exact command you ran for tests, lint and type checks, with its exit status,
4) every test file you added, changed or deleted, and why,
5) anything you could not verify.
If any criterion has no test, say so first.
```

## Kiedy ścieżka dewelopera utyka?

Powtarzają się cztery blokady i każda ma szybkie wyjście:

- **Agent czyta nie te pliki.** W dużych repozytoriach wyniki budowania i pliki generowane zalewają kontekst. Wskaż w prompcie pliki i katalogi, które się liczą, a te do pominięcia zapisz w pliku instrukcji.
- **Serwer MCP nie łączy się.** Zwykle brakuje zmiennej środowiskowej. Najpierw uruchom serwer osobno, sprawdź, czy token jest wyeksportowany, a potem zrestartuj agenta; w Claude Code `claude --debug "mcp"` wypisuje błąd połączenia, a `/mcp` pokazuje stan każdego serwera.
- **Jakość nagle spada.** Zanim zrobisz cokolwiek innego, sprawdź aktywny model i poziom wysiłku (effort): `/model` w Claude Code i Codeksie, wybór modelu w Cursorze. Zacznij od domyślnego modelu narzędzia, podnieś poziom wysiłku, zanim zmienisz model, i zmieniaj model tylko wtedy, gdy twoje ewaluacje tak mówią. Aktualne ustawienia domyślne są na [stronie modeli](/pl/ecosystem/models/).
- **Uruchomienia w trybie headless wiszą.** Uruchomienie w CI czeka na prośbę o akceptację, na którą nikt nie odpowie. W Claude Code z góry zatwierdź narzędzia, których potrzebuje zadanie, flagą `--allowedTools` albo w ustawieniach projektu. W Codeksie podaj politykę akceptacji przed podkomendą, na przykład `codex -a never exec …`, w runnerze z sandboxem.

**Prompt do skopiowania: ustal, dlaczego agent ciągle chybia**

```text
Your last three attempts did not do what I asked. Before trying again:
1) restate the goal and the acceptance check in one sentence each,
2) list the files you read and the ones you did not open,
3) name the instruction in CLAUDE.md / AGENTS.md / project rules that you followed, if any.
Then tell me what context you are missing. Do not edit anything yet.
```

Pełny katalog komunikatów o błędach i poprawek jest w [przewodniku rozwiązywania problemów](/pl/resources/troubleshooting/).

## Dokąd iść dalej ze ścieżki dewelopera

- [Szybkie efekty w pierwszej dobie](/pl/start/quick-wins/) — Techniki, które opłacają się, zanim zaczniesz ścieżkę
- [Zacznij tutaj](/pl/start/) — Wybierz inny punkt startu: szybki start narzędzia albo sekcję dla swojej roli
- [Ścieżka tech leada](/pl/start/tech-lead/) — Ta sama zmiana dla całego zespołu: harness, weryfikacja i przepustowość review
- [Co zostaje człowiekowi](/pl/ladder/the-humans-job/) — Co zostaje przy tobie na każdym szczeblu drabiny
