updatekfg

# /updatekfg - Aktualizacja środowiska KFG

Skill do synchronizacji zmian KFG na wszystkie urządzenia.

## Architektura KFG (PRZECZYTAJ!)

```
KFG/.claude/           →  ~/.claude/ (instalatory kopiują)
├── CLAUDE.md          →  CLAUDE.md (globalne instrukcje)
├── settings.json      →  settings.json (permissions + hooks + statusLine)
├── rules/*.md         →  rules/*.md (reguły automatyczne)
├── hooks/*            →  hooks/* (skrypty walidacji)
├── welcome.txt        →  welcome.txt
├── statusline-wrapper.ps1/.sh  →  statusline wrapper
├── analyze-history.ps1         →  analiza historii (Windows)
└── export-device-stats.ps1     →  eksport stats (Windows)

KFG/platform/
├── android/           →  Android-specific overrides (merge przy instalacji)
└── windows/           →  Windows-specific overrides

KFG/setup/config/
├── termux/.bashrc     →  ~/.bashrc (Android - append)
├── termux/.tmux.conf  →  ~/.tmux.conf (Android)
├── ccstatusline/      →  ~/.config/ccstatusline/ (statusline config)
└── .templates/        →  ~/.templates/ (szablony walidacji)

KFG/desktop/
├── install.ps1        →  Jednorazowy instalator Windows (generuje inline)
├── sync-env.ps1       →  Auto-sync przy każdym `cc` (kopiuje z KFG)
└── config/            →  Windows-specific configs
```

## Mechanizmy synchronizacji

| Platforma | Instalacja | Codzienna sync |
|-----------|------------|----------------|
| **Windows** | `desktop/install.ps1` | Junction (jak symlink) LUB sync-env.ps1 |
| **Android** | `install.sh` (symlink) | Automatyczny (symlink) |

**WAŻNE:**
- Android używa SYMLINK ~/.claude/ → KFG/.claude/ - zmiany w KFG są natychmiast widoczne
- Windows: install.ps1 tworzy JUNCTION ~/.claude/ → KFG/.claude/ (jak symlink)
  - Edycja ~/.claude/* = edycja KFG/.claude/* (ten sam plik!)
  - Git widzi zmiany w KFG/.claude/ automatycznie
  - Jeśli junction nie działa: sync-env.ps1 kopiuje przy `cc`

**UWAGA dla Claude:** Edytuj ~/.claude/CLAUDE.md LUB KFG/.claude/CLAUDE.md - to ten sam plik (junction)!

## Checklist: Co zaktualizować

Przed commitem sprawdź które pliki dotyczą zmiany:

### 1. Instrukcje Claude (CLAUDE.md, rules/)
```
[ ] KFG/.claude/CLAUDE.md - główne instrukcje
[ ] KFG/.claude/rules/*.md - reguły automatyczne
```
**Sync:** Android=natychmiast, Windows=przy `cc`

### 2. Settings (permissions, hooks, statusLine)
```
[ ] KFG/.claude/settings.json - base settings
[ ] KFG/platform/android/settings-override.json - Android override
[ ] KFG/platform/windows/settings-override.json - Windows override (jeśli istnieje)
```
**Sync:** Android=natychmiast, Windows=sync-env kopiuje tylko jeśli nie istnieje lub -Force

### 3. Hooks (walidacja, pre-compact)
```
[ ] KFG/.claude/hooks/*.ps1 - Windows hooks
[ ] KFG/.claude/hooks/*.sh - Android hooks
```
**Sync:** Android=natychmiast, Windows=sync-env

### 4. StatusLine scripts
```
[ ] KFG/.claude/statusline-wrapper.ps1 - Windows wrapper
[ ] KFG/.claude/statusline-wrapper.sh - Android wrapper
[ ] KFG/.claude/analyze-history.ps1 - analiza historii (Windows only)
[ ] KFG/.claude/export-device-stats.ps1 - eksport stats (Windows only)
[ ] KFG/setup/config/ccstatusline/settings.json - ccstatusline config
```
**Sync:** Windows=sync-env, Android=symlink (ale .sh tylko!)

### 5. Bashrc / Shell functions
```
[ ] KFG/setup/config/termux/.bashrc - funkcje bash (p, np, cc, gs...)
[ ] KFG/setup/config/bashrc - alternative location
```
**Sync:** Android=wymaga `source ~/.bashrc` lub reinstall

### 6. Templates
```
[ ] KFG/setup/config/.templates/ - szablony walidacji
[ ] KFG/.templates/ - alternative location
```
**Sync:** Android=install.sh kopiuje, Windows=install.ps1 generuje inline

### 7. Instalatory (jeśli zmiana wymaga)
```
[ ] KFG/install.sh - Android/Linux instalator
[ ] KFG/desktop/install.ps1 - Windows instalator
[ ] KFG/desktop/sync-env.ps1 - Windows daily sync
```

## Workflow aktualizacji

### Mała zmiana (reguły, instrukcje)
```bash
# 1. Edytuj pliki w KFG/.claude/
# 2. Commit + push
git add -A && git commit -m "update: [co]" && git push

# Android: automatycznie (symlink)
# Windows: przy następnym `cc` (sync-env.ps1)
```

### Duża zmiana (nowy feature, settings)
```bash
# 1. Edytuj pliki źródłowe w KFG/
# 2. Sprawdź czy sync-env.ps1 obsługuje nowe pliki
# 3. Commit + push
# 4. Na innych urządzeniach: git pull (Android) lub cc (Windows)
```

### Zmiana wymagająca reinstalacji
```bash
# Jeśli zmieniłeś:
# - install.sh / install.ps1
# - strukturę katalogów
# - nowe pliki których sync-env nie kopiuje

# Android: ./install.sh --force
# Windows: .\desktop\install.ps1 (lub cc z -Force sync)
```

## Przykłady

### Dodanie nowej reguły
```
1. Utwórz: KFG/.claude/rules/nowa-regula.md
2. git add && commit && push
3. Android: automatycznie działa (symlink)
4. Windows: przy następnym `cc`
```

### Zmiana statusline
```
1. Edytuj: KFG/.claude/statusline-wrapper.ps1 (Windows)
2. Edytuj: KFG/.claude/statusline-wrapper.sh (Android) - jeśli dotyczy
3. sync-env.ps1 już kopiuje te pliki
4. git add && commit && push
```

### Nowy skrypt do sync
```
1. Utwórz skrypt w KFG/.claude/
2. Dodaj do sync-env.ps1 $statuslineScripts array (jeśli .ps1)
3. Dla Android: utwórz .sh wersję (symlink = auto)
4. git add && commit && push
```

## Weryfikacja

Po aktualizacji sprawdź:
```powershell
# Windows - sprawdź czy pliki są aktualne
ls ~/.claude/*.ps1
cat ~/.claude/CLAUDE.md | head -20

# Porównaj z KFG
diff ~/.claude/CLAUDE.md $KFG/.claude/CLAUDE.md
```

```bash
# Android - symlink powinien działać
ls -la ~/.claude/  # powinno pokazać -> KFG/.claude/
cat ~/.claude/CLAUDE.md | head -20
```

## TODO (brakujące)

- [ ] Android: analyze-history.sh (bash wersja)
- [ ] Android: export-device-stats.sh (bash wersja)
- [ ] Cross-device stats agregacja na Androidzie