| name | onboarding |
| description | Jednorazowy wizard setup Osobistego Asystenta AI — wywiad, generacja persona.md, soul.md, opcjonalnie biznes.md i content/voice-of-tone.md, zawsze content/ai-writing-patterns.md, struktura folderów, CLAUDE.md |
| disable-model-invocation | true |
| allowed-tools | ["Read","Write","Edit","Glob","Bash","AskUserQuestion"] |
Onboarding — Setup Osobistego Asystenta AI
Jednorazowy wizard, który prowadzi usera przez konfigurację Personal OS. Wywiad → generacja plików kontekstowych → struktura folderów → CLAUDE.md.
Czas: ~15-20 minut
Wynik: persona.md, soul.md, opcjonalnie biznes.md, CLAUDE.md, struktura folderów
Wspólny pattern: generacja → review → zapis
Kroki 7, 8, 9 używają tego samego workflow:
- Wygeneruj plik na podstawie zebranych danych
- Wyświetl pełną zawartość userowi
- Zapytaj: "Przeczytaj i powiedz co zmienić."
- Jeśli user chce zmiany → popraw i pokaż ponownie (bez limitu iteracji)
- Jeśli user akceptuje → zapisz do docelowej ścieżki (utwórz folder jeśli nie istnieje)
KROK 0: GATEWAY CHECK
- Sprawdź czy istnieje
.claude/.onboarded
- Jeśli TAK → wyświetl i STOP:
System już skonfigurowany ✅
Pliki kontekstowe: .claude/rules/persona.md, soul.md
Jeśli chcesz zresetować i przejść onboarding od nowa → usuń plik .claude/.onboarded
- Jeśli NIE → kontynuuj do kroku 0.5
KROK 0.5: WYKRYCIE ŚRODOWISKA
Wykryj środowisko maszyny RAZ i zapisz wynik — skille korzystają z tego pliku zamiast wykrywać środowisko od nowa w każdej sesji (i od nowa się mylić).
- Uruchom (Bash):
UNAME=$(uname -s 2>/dev/null || echo unknown)
case "$UNAME" in
Darwin) OS="macOS";;
Linux) OS="Linux";;
MINGW*|MSYS*|CYGWIN*) OS="Windows";;
*) OS="$UNAME";;
esac
PYTHON=""
for cand in python3 python; do
p=$(command -v "$cand" 2>/dev/null) || continue
case "$p" in *WindowsApps*) continue;; esac
PYTHON="$p"; break
done
PY_VER=$([ -n "$PYTHON" ] && "$PYTHON" --version 2>&1 || echo BRAK)
NODE=$(command -v node 2>/dev/null || echo BRAK)
NODE_VER=$(node --version 2>/dev/null || echo "-")
echo "OS: $OS"
echo "PYTHON: ${PYTHON:-BRAK} ($PY_VER)"
echo "NODE: $NODE ($NODE_VER)"
- Zapisz wynik do
.claude/rules/environment.md (utwórz folder jeśli trzeba):
# Środowisko — wykryte przez /onboarding ([dzisiejsza data YYYY-MM-DD])
- **System:** [OS]
- **Python:** `[pełna ścieżka]` ([wersja]) — do skryptów używaj TEJ ścieżki
- **Node:** `[ścieżka]` ([wersja])
Jeśli OS = Windows, dopisz na końcu:
- ⚠️ **Windows:** `python3` ze Sklepu Microsoft to stub — NIE używaj. Pliki tymczasowe
zapisuj w `.claude/tmp/` (NIE w `/tmp` — ścieżka MSYS, niewidoczna dla narzędzia Read).
- Jeśli Python = BRAK → poinformuj usera, że część skilli wymaga Pythona (instalacja: https://python.org, na Windows zaznaczyć "Add to PATH") — ale kontynuuj onboarding, nie blokuj.
KROK 1: POWITANIE
Wyświetl tekst (NIE AskUserQuestion — to intro):
👋 Cześć! Zaraz skonfigurujemy Twojego AI pod Ciebie.
Co się stanie:
1. Pogadamy — poznam Cię (kilka pytań, ~15-20 min)
2. Wygeneruję persona.md — Twój profil, który AI czyta na starcie
3. Wygeneruję soul.md — osobowość AI dopasowaną do Ciebie
4. Postawię strukturę folderów i system zadań
5. Wygeneruję CLAUDE.md — "mózg" systemu
Na końcu będziesz mieć działający Personal OS. Lecimy 🚀
KROK 2: KIM JESTEŚ
Pytanie otwarte (zwykły tekst, NIE AskUserQuestion — potrzebna rozbudowana odpowiedź):
Opowiedz o sobie — kim jesteś, czym się zajmujesz, jaka firma/projekt?
I skąd przyszedłeś zawodowo — chcę znać Twoją drogę, nie jednozdaniowiec.
Czekaj na odpowiedź. Jeśli zbyt krótka → dopytaj: "Możesz rozwinąć? Co robiłeś wcześniej?"
Zapisz odpowiedź do kontekstu (użyjesz w kroku 7).
KROK 3: STYL KOMUNIKACJI
AskUserQuestion — 4 pytania na raz:
| # | Pytanie | Header | Opcje (label · description) |
|---|
| 1 | Jak formalnie ma gadać AI? | Formalność | Luźno (1-2/5) · Jak z kumplem, humor, zero dystansu · Pośrodku (3/5) · Naturalnie, bez sztywności ale bez wulgaryzmów · Profesjonalnie (4-5/5) · Biznesowo, precyzyjnie, z dystansem |
| 2 | Jak podejmujesz decyzje? | Analityczność | Intuicja · Czuję co jest dobre, nie potrzebuję danych · Mix · Dane tam gdzie ważne, intuicja w reszcie · Dane i liczby · Fakty, metryki, porównania — bez tego nie ruszam |
| 3 | Jak wolisz dostawać odpowiedzi? | Format | Krótko · Mięso, zero wody · Z opcjami do wyboru · 3-5 wariantów z trade-offami · Z przykładami · Pokaż na przykładzie, potem teoria · Szczegółowo · Pełen kontekst, wyjaśnienia |
| 4 | Jak chcesz feedback od AI? | Feedback | Prosto w twarz · Bez owijania, jeśli słabe to słabe · Konstruktywnie · Wskaż problem i zaproponuj rozwiązanie · Delikatnie · Sugestie zamiast krytyki |
Wszystkie pytania: multiSelect: false
Zapisz odpowiedzi do kontekstu.
KROK 4: WARTOŚCI I PRACA
Pytanie otwarte (jedno, wieloczęściowe):
Teraz kilka pytań o to jak pracujesz:
- Jakie masz twarde zasady w pracy? Czego ZAWSZE się trzymasz?
- Czego NIGDY nie akceptujesz?
- Jakich narzędzi/technologii używasz na co dzień?
- Nad czym teraz pracujesz? Główne projekty?
Jeśli odpowiedź ogólnikowa → dopytaj: "Możesz dać konkretny przykład?"
Zapisz do kontekstu.
KROK 5: RELACJA Z AI + FRUSTRACJE
AskUserQuestion — 1 pytanie:
| # | Pytanie | Header | Opcje (label · description) |
|---|
| 1 | Jak widzisz AI? | Relacja z AI | Partner · Współpracownik na równi, ma opinię, calloutuje błędy · Narzędzie · Robisz co mówię, bez inicjatywy · Mentor · Prowadzi, uczy, podpowiada kierunek · Asystent · Pomaga, wspiera, wykonuje polecenia |
multiSelect: false
Potem pytanie otwarte:
Dwa ważne pytania — im szczerzej, tym lepiej AI się do Ciebie dostosuje:
-
Co Cię WKURZA w AI / chatbotach? Co robią, czego nie znosisz?
(np. "zaczyna od Świetne pytanie!", "pisze za dużo", "nie ma opinii")
-
Jak chcesz żeby TWOJE AI z Tobą rozmawiało? Jaki ton, jaki styl?
(np. "jak kumpel", "bez bullshitu", "z humorem", "profesjonalnie ale luźno")
Zapisz do kontekstu.
KROK 6: MOTYWATORY + BLOKERY
Pytanie otwarte:
Ostatnia runda — o Twoją energię:
- Kiedy czujesz flow? Co Cię nakręca? (podaj min. 3 sytuacje)
- Co Cię drenuje? Co zabiera energię?
- Jakie masz wady/blokery? (perfekcjonizm? prokrastynacja? shiny object syndrome?)
— bądź szczery, to zostaje między Tobą a AI
Potem AskUserQuestion — 1 pytanie:
| # | Pytanie | Header | Opcje (label · description) |
|---|
| 1 | Masz wyniki testów osobowości? | Testy | Tak, wkleję · Gallup, MBTI, DISC, cokolwiek — wklej w następnej wiadomości · Nie mam · Pomijamy — nie jest wymagane |
multiSelect: false
Jeśli "Tak, wkleję" → czekaj na wklejenie wyników. Potem kontynuuj.
Jeśli "Nie mam" → kontynuuj od razu.
KROK 7: GENERACJA persona.md
- Przeczytaj
prompt-persona.md z tego skilla (ten sam folder co SKILL.md)
- Na podstawie WSZYSTKICH odpowiedzi z kroków 2-6 wygeneruj persona.md zgodnie z instrukcjami z prompt-persona.md
- Zastosuj pattern: generacja → review → zapis (ścieżka:
.claude/rules/persona.md)
KROK 8: KONTEKST BIZNESOWY (opcjonalny)
AskUserQuestion — 1 pytanie:
| # | Pytanie | Header | Opcje (label · description) |
|---|
| 1 | Chcesz dodać kontekst biznesowy? AI lepiej zrozumie Twój świat zawodowy. | Biznes | Tak · Opowiem o firmie/projekcie — AI będzie lepiej dopasowane · Nie, pomiń · Dodasz później jeśli będziesz chcieć |
multiSelect: false
Jeśli TAK:
Pytanie otwarte:
Opowiedz o swoim biznesie/pracy:
- Czym się zajmujesz zawodowo? (firma, branża, model)
- Kto jest Twoim klientem/odbiorcą?
- Na jakich platformach/kanałach działasz?
- Jaki masz stack technologiczny?
Wygeneruj biznes.md z sekcjami:
- Działalność (firma, branża, model, skala)
- Grupa docelowa
- Platformy i kanały
- Stack technologiczny
- Aktualne projekty (jeśli wspomniał)
Zastosuj pattern: generacja → review → zapis (ścieżka: .claude/rules/biznes.md)
Jeśli NIE → pomiń, kontynuuj do kroku 9. Zapamiętaj że biznes.md nie powstał (potrzebne w krokach 12 i 14).
KROK 9: GENERACJA soul.md
AskUserQuestion — 2 pytania:
| # | Pytanie | Header | Opcje (label · description) |
|---|
| 1 | Humor i przeklinanie w AI? | Humor | Pełen luz · Humor + przeklinanie kiedy pasuje · Humor tak, przeklinanie nie · Luźny ton, ale bez wulgaryzmów · Profesjonalnie · Zero humoru w pracy, rzeczowo i na temat |
| 2 | AI ma mieć mocne opinie? | Opinie | Mocne · Calloutuje błędy, nie jest yes-manem, mówi wprost · Wyważone · Wskazuje lepszą opcję, ale nie narzuca · Neutralne · Fakty na stole, user decyduje |
Wszystkie: multiSelect: false
Potem pytanie otwarte:
Ostatnie pytanie: opisz swoimi słowami jakiego "charakteru" ma mieć Twoje AI.
Np. "jak kumpel developer z którym siedzisz do 2 w nocy nad projektem"
albo "jak senior mentor który nie oszczędza krytyki ale zawsze ma rozwiązanie"
albo cokolwiek innego — tu nie ma złej odpowiedzi.
Generacja:
- Przeczytaj
prompt-soul.md z tego skilla
- Wygeneruj soul.md na podstawie:
- persona.md (cały profil wygenerowany w kroku 7)
- biznes.md (jeśli utworzony w kroku 8)
- Odpowiedzi z tego kroku (humor, opinie, charakter)
- Zastosuj pattern: generacja → review → zapis (ścieżka:
.claude/rules/soul.md)
KROK 9B: VOICE OF TONE (opcjonalny — wymaga próbek)
Plik content/voice-of-tone.md opisuje JAK user pisze treści. Tworzymy go TYLKO jeśli
user pisze content I dostarczy próbki — bez realnych tekstów byłby zmyślony i bezużyteczny.
AskUserQuestion — 1 pytanie:
| # | Pytanie | Header | Opcje (label · description) |
|---|
| 1 | Tworzysz treści (posty, maile, wpisy) i chcesz, żeby AI pisało Twoim głosem? | Voice | Tak, mam próbki · Wkleję 5-15 swoich tekstów — AI wyłapie styl · Tak, ale później · Tworzę content, dorzucę próbki kiedy indziej · Nie tworzę treści · Pomiń — nie dotyczy mnie |
multiSelect: false
Jeśli "Tak, mam próbki":
- Poproś: "Wklej 5-15 swoich tekstów (posty/maile/wpisy) — im więcej, tym lepiej AI złapie styl."
- Czekaj na wklejenie. Jeśli <5 próbek → poproś o więcej albo zaproponuj wariant "później".
- Przeczytaj
prompt-voice-of-tone.md z tego skilla.
- Wygeneruj
content/voice-of-tone.md zgodnie z instrukcją z prompta.
- Pattern: generacja → review → zapis (ścieżka:
.claude/rules/content/voice-of-tone.md).
Jeśli "Tak, ale później" lub "Nie tworzę treści":
Pomiń. Zapamiętaj, że voice-of-tone NIE powstał (potrzebne w kroku 12). Jeśli "później" →
powiedz: "Spoko — skille /reflect i /x-weekly-analysis zbudują go z czasem z Twoich tekstów."
NIEZALEŻNIE od odpowiedzi (zawsze, bez pytania):
Skopiuj templates/ai-writing-patterns.md z tego skilla do .claude/rules/content/ai-writing-patterns.md
(mkdir -p na folder). To uniwersalny, statyczny dokument referencyjny (wzorce usuwania artefaktów AI
z polskich tekstów) — NIE jest personalizowany i NIE zależy od voice-of-tone. Przyda się przy każdej
pracy z tekstem (posty, maile, wpisy). (Plik zasiewa też hook seed-base-files przy starcie sesji,
gdyby onboarding był pomijany.)
KROK 10: STRUKTURA FOLDERÓW
Utwórz automatycznie (bez pytania):
Zadania/
├── to_do.md ← skopiuj z templates/to_do.md, zamień {{DATE}} na dzisiejszą datę YYYY-MM-DD
├── projekty/
├── w_trakcie/
├── zrobione/
├── cykliczne/
│ └── recurring.md ← skopiuj z templates/recurring.md
└── .szablony/
└── szablon-zadania.md ← skopiuj z templates/szablon-zadania.md
Zasoby/
Pliki template'ów: przeczytaj z folderu templates/ w tym skillu i skopiuj do docelowych lokalizacji.
AskUserQuestion — 1 pytanie, multiSelect:
| # | Pytanie | Header | multiSelect | Opcje (label · description) |
|---|
| 1 | Jakie dodatkowe foldery chcesz? | Foldery | true | Marketing/ · Wpisy, media, pomysły — do contentu i social media · Notatki/ · Spotkania, rozmowy, braindumpy · Brudnopis.md · Szybkie notatki, scratch pad — jeden plik na wszystko |
Utwórz wybrane:
Marketing/ → utwórz subfoldery: wpisy/, media/, i plik pomysły.md (pusty z nagłówkiem)Notatki/ → utwórz subfoldery: spotkania/Brudnopis.md → pusty plik z nagłówkiem # Brudnopis
Zapamiętaj co zostało utworzone (potrzebne w kroku 12).
KROK 11: PRZEGLĄD SKILLI
Wyświetl tekst (bez pytań):
📦 Twój system ma 5 wbudowanych skilli — działają od razu:
/daily — codzienne porządki: archiwizacja zrobionych zadań,
regeneracja dashboardu, raport co nowego
/memory-update — aktualizuje NOW.md (bieżący kontekst pracy) z logów
sesji — dzięki temu AI wie nad czym pracujesz
/reflect — odpal po sesji, AI analizuje rozmowę i kalibruje
Twoje pliki kontekstowe (persona.md, soul.md, voice-of-tone.md)
/utworz-zadanie — tworzy zadanie w systemie Obsidian z priorytetem,
terminem i projektem
/skill-scout — raz w tygodniu przegląda Twoje logi i wyławia powtarzalną
ręczną robotę, którą warto opakować w kolejny skill
Wszystkie działają od razu — wystarczy wpisać /nazwa w Claude Code.
Dodatkowe skille (email, social media, generowanie grafik...) to osobny
materiał — możesz je doinstalować w dowolnym momencie.
KROK 12: GENERACJA CLAUDE.md
- Przeczytaj
template-claude.md z tego skilla
- Wypełnij placeholder'y:
{{RULES_LIST}} — tabela z plikami w .claude/rules/:
| Plik | Opis | Kiedy się ładuje |
|---|
rules/persona.md | Profil użytkownika, styl komunikacji, wartości | Zawsze |
rules/soul.md | Osobowość AI, charakter, styl myślenia | Zawsze |
rules/environment.md | Wykryte środowisko maszyny (OS, Python, node) | Zawsze |
rules/NOW.md | Bieżący kontekst pracy (tworzy i aktualizuje /memory-update) | Zawsze |
rules/biznes.md | Kontekst biznesowy (firma, branża, stack, platformy) | Zawsze |
rules/content/voice-of-tone.md | Styl pisania treści (posty, maile) | Przy pracy z contentem |
rules/content/ai-writing-patterns.md | Wzorce usuwania artefaktów AI z tekstów | Przy pracy z contentem |
Wiersz NOW.md wpisuj ZAWSZE, nawet jeśli plik jeszcze nie istnieje —
powstanie przy pierwszym /memory-update.
Pomiń wiersz rules/biznes.md jeśli user nie utworzył go w kroku 8.
Pomiń content/voice-of-tone.md jeśli nie został utworzony w kroku 9B.
Wiersz content/ai-writing-patterns.md wpisuj ZAWSZE (plik kopiowany bezwarunkowo w kroku 9B / seed hookiem).
{{SKILLS_LIST}} — lista 4 skilli core:
**Workflow / Zarządzanie:**
- `daily` - codzienna aktualizacja systemu zadań (archiwizacja, regeneracja dashboardu, raport)
- `memory-update` - aktualizacja NOW.md (bieżący kontekst pracy) z logów sesji
- `reflect` - walidacja obserwacji o użytkowniku → aktualizacja plików kontekstowych
- `utworz-zadanie` - tworzenie nowego zadania w systemie Obsidian
- `skill-scout` - tygodniowy przegląd logów: wykrywa powtarzalną ręczną robotę do opakowania w skill
{{FOLDER_STRUCTURE}} — mapa workspace na podstawie FAKTYCZNIE utworzonych folderów:
- `.claude/` - konfiguracja Claude Code
- `Zadania/` - system zarządzania zadaniami
- `to_do.md` - główna lista zadań
- `projekty/` - aktywne projekty
- `w_trakcie/` - zadania w toku
- `zrobione/` - ukończone zadania
- `cykliczne/recurring.md` - zadania cykliczne
- `.szablony/szablon-zadania.md` - szablon zadania
- `Zasoby/` - materiały zewnętrzne
Dodaj Marketing/, Notatki/, Brudnopis.md jeśli zostały wybrane w kroku 10.
{{CONVENTIONS}} — konwencje systemu:
- Pliki markdown w formacie Obsidian
- Checkboxy w formacie `- [ ]` / `- [x]`
### System zadań
- **Tworzenie zadań:** ZAWSZE używaj komendy `/utworz-zadanie` — nigdy nie twórz plików zadań ręcznie
- **Nazwy zadań:** kebab-case (np. `moje-nowe-zadanie.md`)
- **Podzadania:** prefiks `_` w nazwie pliku (np. `_podzadanie.md`)
- **Emoji priorytetów w dashboard:** 🔴 pilne | 🟡 wazne | 🟢 normalne
- Zapisz do
.claude/CLAUDE.md
- Wyświetl krótkie podsumowanie: "CLAUDE.md wygenerowany — zawiera rules, skille, strukturę folderów i konwencje."
KROK 13: WALIDACJA SPÓJNOŚCI
Przeczytaj wygenerowane pliki i sprawdź:
| Check | Co sprawdzam | Jak naprawić |
|---|
| persona ↔ soul | Czy soul.md odzwierciedla preferencje z persona.md? | Automatycznie dopasuj soul.md |
| Anty-wzorce | Czy "czego nie robię" w soul.md pokrywa "co wkurza w AI" z persona? | Dodaj brakujące punkty do soul.md |
| Formalność | Czy ton soul.md pasuje do formalności z persona? | Dostosuj język soul.md |
| CLAUDE.md kompletność | Czy router wskazuje na wszystkie utworzone pliki? | Dodaj brakujące wpisy |
| Struktura | Czy wszystkie foldery wymienione w CLAUDE.md istnieją? | Utwórz brakujące lub usuń z listy |
Drobne poprawki → napraw automatycznie bez pytania.
Duże niespójności → zgłoś userowi i zapytaj co zrobić.
Ślad walidacji jest OBOWIĄZKOWY — po wykonaniu checków wypisz userowi wynik,
jedna linia per check (✅ persona ↔ soul — spójne / ⚠️ Anty-wzorce — dopisałem 2 punkty do soul.md).
Bez wypisanego śladu NIE przechodź do kroku 14.
KROK 14: FINALIZACJA
- Zapisz flagę
.claude/.onboarded:
onboarded: true
date: [dzisiejsza data YYYY-MM-DD]
version: 1.0
- Wyświetl podsumowanie:
✅ Personal OS skonfigurowany!
Utworzone pliki:
📄 .claude/rules/persona.md — Twój profil
📄 .claude/rules/soul.md — osobowość AI
📄 .claude/rules/environment.md — środowisko maszyny (OS, Python, node)
📄 .claude/rules/biznes.md — kontekst biznesowy [TYLKO jeśli utworzony]
📄 .claude/rules/content/voice-of-tone.md — styl pisania treści [TYLKO jeśli utworzony]
📄 .claude/rules/content/ai-writing-patterns.md — wzorce unikania "AI voice" w tekstach
📄 .claude/CLAUDE.md — router systemu
📁 Zadania/ — system zadań (z dashboardem, cyklicznymi, szablonami)
📁 Zasoby/ — materiały
📁 [dodatkowe foldery jeśli wybrane]
Co dalej:
1. Pogadaj z AI o czymkolwiek — poczuj różnicę w stylu
2. Po kilku sesjach odpal /reflect — AI się skalibruje
3. Wpisz /daily rano — system posprząta i pokaże co na dziś
Pomiń linijkę z biznes.md jeśli nie został utworzony.
Constraints
- Jednorazowy — po zapisaniu
.onboarded skill się blokuje (krok 0)
- Nie wymyślaj — persona i soul bazują TYLKO na odpowiedziach usera
- Review obowiązkowy — persona.md i soul.md MUSZĄ być pokazane userowi do akceptacji przed zapisem
- Iteracja — jeśli user chce zmiany → popraw i pokaż ponownie, bez limitu iteracji
- Templates z tego skilla — pliki do Zadania/ kopiuj z
templates/ w tym skillu, NIE twórz od zera
- Foldery — twórz wszystkie potrzebne foldery automatycznie (mkdir -p)
- Język — pisz w języku w jakim mówi user (jeśli po polsku → wszystko po polsku)
