# 03. Zasady pracy agenta (tryby, anty-halucynacja, bezpieczeństwo, git)

Pełny kontrakt. Skrót jest w [`../AGENTS.md`](../AGENTS.md) i [00_START_TUTAJ.md](00_START_TUTAJ.md).

---

## 1. Tryby pracy (anty-halucynacja)

1. **Domyślnie PLAN, nie Agent.** Agent pisze kod dopiero po wyraźnym „OK, rób" właściciela.
2. **Plan Mode** = architektura, decyzje, warianty, ryzyka. **Zero edycji plików** (poza notatkami w `macius/`).
3. Przed każdą zmianą: **przeczytaj pliki**, nie zgaduj — **cytuj ścieżki** z repo.
4. „Zacznij od pierwszego punktu w handoff" to **backlog**, nie rozkaz implementacji — najpierw plan + pytanie o OK.
5. **Jeden priorytet z handoff** — reszta to backlog. Nie dokładaj etapów 7A.2 / swarm / VPS równolegle bez OK.
6. **Roadmapa:** Etapy 0–7B + 7A.1 = silnik dev ✅. **Etap 8** = domknięcie wizji Opusa (W5/W7). Szczegóły: `06_ROADMAPA_FUZJI.md`, checklist: `wizja-symbiont/07_ROADMAPA.md`.

## 2. Anty-halucynacja (twarda)

- Każde stwierdzenie o gema0/Kebabkillerze popieraj **cytatem ścieżki/pliku** (np. `gema0/src/x.js`).
- Nie wymyślaj API, zależności, wersji. Jeśli nie wiesz — sprawdź plik lub powiedz „nie ustalono".
- Audyt = **fakty z kodu** (lintery, AST, grep), nie wrażenia.

## 3. Kopie lokalne — wolno wszystko (ważne!)

`gema0/` i `kebabkiller/` w `macius/` to **lokalne kopie** wrzucone z repo. **Można je dowolnie
przerabiać, ciąć, usuwać i eksperymentować** — oryginały (zdalne repozytoria) zostają bezpieczne.

Rozsądne dobre praktyki (nie zakazy):
- **Audyt przed mocnym cięciem** `gema0/` — żeby wiedzieć, co wycinasz (audyt to fotografia stanu).
- **Commituj na bieżąco** — to kopie, więc baw się śmiało, ale miej historię do cofania.

## 4. Bezpieczeństwo zmian — TYLKO żywa produkcja (gdy wdrażamy produkt na realne serwery)

> Marzenie W3/W4. To dotyczy **wdrożonego produktu na prod**, NIE lokalnych kopii w `macius/`.

1. **Izolacja** — praca w osobnej gałędzi/worktree, nigdy w main/prod.
2. **Diff-only** + allowlista plików; brak edycji poza zakresem.
3. **Bramka polityk** — blokada `rm -rf`, `git push --force`, edycji sekretów, migracji bez rollbacku.
4. **Weryfikacja** — lint/testy/typy przed akceptacją.
5. **PR, nie auto-merge.** Agent nigdy nie zatwierdza własnej pracy.
6. **Rollback** — każda zmiana = 1 odwracalny commit; deploy etapowy.
7. **Audit log** — co agent zrobił.

(Rozwinięte w dołączonej wizji: [`../wizja-symbiont/05_BEZPIECZENSTWO.md`](../wizja-symbiont/05_BEZPIECZENSTWO.md).)

## 5. Git

- Osobna gałąź per temat; osobny PR; czytelne, atomowe commity (jeden logiczny zysk = jeden commit).
- Dla czytelności staraj się nie mieszać w jednym PR zmian z różnych obszarów (gema0 vs. macius vs. kebabkiller).
- Bez force-push i amendów bez wyraźnej zgody.

## 6. Dokumentowanie wyników

| Wynik | Szablon | Lokalizacja |
|-------|---------|-------------|
| Audyt | `templates/AUDYT_TEMPLATE.md` | `audyty/` |
| Decyzja | `templates/ADR_TEMPLATE.md` | `decyzje/` |
| Propozycja architektury/fuzji | `templates/PROPOZYCJA_TEMPLATE.md` | `docs/` lub `decyzje/` |
| Zadanie | `templates/ZADANIE_TEMPLATE.md` | gdzie pasuje |

## 7. Definition of Done (dla zadania w macius)

- [ ] Wynik oparty o fakty (cytaty ścieżek), nie zgadywanie.
- [ ] Zapisany w odpowiednim miejscu wg szablonu.
- [ ] `HANDOFF_AKTUALNY.md` zaktualizowany, wpis w `DZIENNIK_SESJI.md`.
- [ ] Jeśli zmiany w kopiach (`gema0/`/`kebabkiller/`): scommitowane, by dało się cofnąć.
- [ ] Jeśli wdrożenie na żywą produkcję: gałąź + PR + zielone testy; prod nietknięty wprost.