---
name: safe-code-edit
description: Technika bezpiecznej edycji cudzego kodu przez agenta - minimalny diff, zasady użycia narzędzi plikowych, weryfikacja po każdej zmianie i postępowanie przy nieudanej edycji. Użyj przy każdej modyfikacji plików w repozytorium.
license: Apache-2.0
metadata:
  owner: pubi-platform
  version: "1.0.0"
---

# Bezpieczna edycja kodu

## Twarde zasady

1. **Czytaj przed pisaniem.** Nigdy nie wywołuj `replace_in_file` na pliku, którego nie odczytałeś
   w tym przebiegu. Treść z planu nie jest dowodem na aktualny stan pliku.
2. **Najmniejszy możliwy diff.** Zmieniaj wyłącznie linie, które muszą się zmienić.
   `write_file` (nadpisanie całości) jest dozwolone tylko dla plików, które sam utworzyłeś.
3. **Jedna intencja na edycję.** Nie łącz migracji API z poprawą literówki w komentarzu.
4. **Weryfikuj natychmiast.** Po zmianie pliku uruchom `run_verification`.
   Jeśli wynik jest czerwony, napraw przyczynę zanim dotkniesz kolejnego pliku.
5. **Nie walcz z narzędziem.** Jeśli `replace_in_file` dwa razy nie znajdzie dopasowania -
   odczytaj plik ponownie i dopasuj dokładny fragment ze spacjami. Trzecia porażka = zgłoś
   `requires_human` z treścią fragmentu, zamiast nadpisywać plik w całości.
6. **Nie dotykaj plików spoza planu.** Rozszerzenie zakresu wymaga nowego planu.

## Gdy weryfikacja jest czerwona

- Przeczytaj **pełny** komunikat błędu, nie tylko ostatnią linię.
- Zlokalizuj plik i linię z traceback; napraw przyczynę, nie objaw.
- Nie modyfikuj testów, żeby przeszły. Test jest kontraktem.
- Jeśli po trzech próbach ten sam błąd - zatrzymaj się i zgłoś `requires_human` z pełnym logiem.