feat: initial commit

2026-08-29 13:17:59 +02:00
commit 142f5f5759
91 changed files with 6155 additions and 0 deletions
@@ -0,0 +1,31 @@
+---
+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.