<!--
  TYLKO DLA WŁAŚCICIELA — NIE DLA AGENTA CURSOR
-->

# Start tutaj (Damian / właściciel)

**Ostatnia aktualizacja:** 2026-05-19 18:30

## Co to jest „sesja”? (nie musisz znać gita)

**Sesja** = jeden odcinek pracy nad projektem, **nieważne w ilu oknach czatu Cursora**.

- Zaczynasz rano w oknie A, kończysz wieczorem w oknie B → to **jedna sesja** (albo dwie: rano / wieczór — jak wolisz liczyć).
- Okna czatu **nie trzymają kodu** — kod jest w folderze `gema0` na dysku.
- GitHub **nie wie** o oknach czatu. Widzi tylko: czy zapisałeś zmiany w git (`commit`) i czy wysłałeś na serwer (`push`).

**Bałagan zwykle nie z czatów, tylko gdy:** pliki są zmienione, ale nie ma commita / pusha — wtedy nie wiadomo, co jest „oficjalne”.

---

## Minimum gita (żeby nie narobić chaosu)

Nie musisz znać gałęzi, merge, rebase. Na co dzień wystarczy **tylko `main`** i **3 komendy**:

| Kiedy | Komenda |
|-------|---------|
| Siadasz do projektu (raz na dzień / po przerwie) | `git pull origin main` |
| Kończysz pracę (dzień, temat, „na dziś koniec”) | `git add -A` → `git commit -m "opis"` → `git push origin main` |
| Chcesz sprawdzić, czy coś wisí | `git status` |

**Czego NIE ruszasz bez powodu:** `checkout` na `cursor/...`, `merge`, nowe gałęzie, GitHub Desktop „na próbę”.

To zastępuje stary porządek „jeden folder na dysku” — z tym, że kopia jest też na GitHubie (backup).

---

## Po zakończeniu pracy (2 minuty)

„Koniec” = kończysz temat, dzień, albo mówisz agentowi „zapisz i kończymy”. **Nie** po każdym pojedynczym zdaniu w czacie.

Otwórz PowerShell w folderze projektu i wklej:

```powershell
cd c:\xampp\htdocs\programdocursora\_RPA_AUTOMATION\gema0
git checkout main
git status
```

### Co widzisz?

| `git status` mówi | Co zrób |
|-------------------|---------|
| `ahead of 'origin/main'` | **`git push origin main`** — inaczej GitHub nie ma Twojej pracy |
| `Changes not staged` lub `to be committed` | Poproś agenta o commit **albo** sam: `git add -A` → `git commit -m "opis"` → `git push origin main` |
| `nothing to commit, working tree clean` i **brak** `ahead` | OK — wszystko zapisane lokalnie i na GitHubie |

**Nie musisz** wracać do starych okien czatu w Cursorze. Kod jest w folderze i w gicie, nie w czacie.

---

## Push zawsze? A jak coś jest niedokończone?

| Sytuacja | Co robić |
|----------|----------|
| Sesja skończona, działa / testy OK | `commit` → **`git push origin main`** |
| Niedokończone, ale chcesz backup na GitHubie | `commit -m "WIP: opis co zostało"` → **`push`** — bezpieczny zapis, można dokończyć później |
| Niedokończone, **nie** chcesz tego na GitHubie | **Nie commituj** — pliki zostają tylko na dysku (ryzyko przy awarii PC) |
| `nothing to commit` i `up to date` | **Push nie jest potrzebny** — nic nowego |

**`git pull`** — nie po każdej sesji, tylko:
- **na początku** pracy (gdy siadasz do projektu): `git pull origin main` — żeby mieć to, co wypchnąłeś z innego PC;
- **nie** w środku sesji „na wszelki wypadek”, jeśli masz niezacommitowane zmiany (może skomplikować sprawę).

**Push ≠ pull:** push **wysyła** Twoje commity na GitHub; pull **ściąga** cudze/Twoje starsze z chmury. Po udanym pushu drugi push zwykle mówi „Everything up-to-date”.

---

## Raz na tydzień (kontrola)

```powershell
git pull origin main
npm run test:apex
```

Jeśli testy przechodzą — V10 na dysku jest spójne.

---

## Gdzie szukać historii „co było kiedy”

→ [02_DZIENNIK_ZMIAN.md](02_DZIENNIK_ZMIAN.md) (najnowsze wpisy **na górze**).

---

## Co dalej z produktem?

→ [04_ROADMAP.md](04_ROADMAP.md) — jedna strona: ✅ gotowe / 🔧 teraz / ⏳ później

## Więcej szczegółów

- Git, backup, gałęzie: [01_GIT_BACKUP_I_MAIN.md](01_GIT_BACKUP_I_MAIN.md)
- Co gdzie leży w folderach: [03_MAPA_PROJEKTU.md](03_MAPA_PROJEKTU.md)