/updatekfg - Aktualizacja środowiska KFG

/​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

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)

# 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)

# 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

# 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ź:

# 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

# 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