Rozdział 6: Pierwszy ingest i codzienna praca z agentem
Mamy schemat, czas na agenta. W tym rozdziale uruchamiamy Claude Code w folderze vaulta, wykonujemy pierwszy ingest (dodanie źródła) i zobaczysz, jak z jednego tekstu powstaje kilka połączonych stron wiki. Potem poznasz dwie pozostałe operacje: query (pytania) i lint (przegląd).
Po tym rozdziale masz działający „drugi mózg”: wiki z pierwszymi stronami, wypełniony
index.mdilog.mdoraz wiesz, jak na co dzień rozmawiać z agentem.
Krok 1 — Uruchom agenta w folderze vaulta 💻
Agent musi pracować w folderze vaulta, bo wtedy sam znajdzie CLAUDE.md i będzie się trzymał zasad.
W terminalu:
cd ~/Projekty/moja-baza
claude
W aplikacji desktop Claude (zakładka Code) wybierz po prostu folder moja-baza jako folder projektu.
Możesz użyć innego agenta, który czyta i pisze pliki (np. Codex). Wtedy przeczyta
AGENTS.md, a ten odeśle go doCLAUDE.md. Dlatego w Rozdziale 5 zrobiliśmy oba pliki.
Krok 2 — Przedstaw agentowi jego rolę 🤖
W pierwszej wiadomości jasno powiedz, czego oczekujesz. Przykład:
Jesteś agentem LLM Wiki tego vaulta. Przeczytaj CLAUDE.md i index.md.
Od teraz każda praca z bazą ma być zgodna z tym schematem.
Potwierdź krótko, jakie znasz operacje.
Dobra odpowiedź wymienia ingest, query i lint oraz najważniejsze granice (źródła niezmienne, 03-Private tylko na prośbę, żadnych sekretów).
Krok 3 — Pierwszy ingest 🤖
Na pierwsze źródło świetnie nadaje się sam opis wzorca LLM Wiki. Baza zacznie od wiedzy o tym, jak sama działa:
Dodaj to źródło: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
Zgodnie z sekcją 4 schematu agent powinien:
- przeczytać źródło,
- pokazać Ci 3–5 kluczowych wniosków i zapytać, na czym się skupić,
- po Twojej odpowiedzi utworzyć stronę źródła,
- utworzyć lub zaktualizować strony pojęć i encji,
- uzupełnić
przeglad.md,index.mdilog.md, - zrobić commit (jeśli vault jest już repozytorium Git; w przeciwnym razie ten krok pominie),
- podsumować, co się zmieniło.
Krok 2 jest najważniejszy. To moment, w którym Ty decydujesz, co jest dla Ciebie istotne. Nie pomijaj go odruchowym „ok, rób”. Napisz np. „skup się na tym, jak to zastosować z agentem na serwerze”.
Co powstaje z jednego źródła
U nas ten jeden gist dał 9 stron:
04-Wiki/
├── przeglad.md # synteza całej bazy
├── sources/karpathy-llm-wiki.md # podsumowanie źródła
├── concepts/llm-wiki.md
├── concepts/rag.md
├── concepts/memex.md
├── entities/andrej-karpathy.md
├── entities/obsidian.md
├── entities/obsidian-web-clipper.md
└── entities/hermes-agent.md
Otwórz w Obsidianie 04-Wiki/sources/karpathy-llm-wiki.md, a potem graf (⌘ + G). Strony są połączone linkami, a w index.md każda ma jednozdaniowy opis.
Źródło z internetu a prawa autorskie: agent nie kopiuje całego cudzego tekstu do vaulta. Strona źródła zawiera streszczenie własnymi słowami i link do oryginału. Twoje własne pliki (notatki, dokumentacja) są natomiast archiwizowane w całości w
06-Sources/.
Krok 4 — Pytania do bazy (query) 🤖
Pytaj normalnie:
Co wiem o RAG i czym różni się od LLM Wiki?
Agent najpierw czyta index.md, potem pasujące strony, i odpowiada z odnośnikami [[...]]. Gdy czegoś nie ma w bazie, powinien to powiedzieć wprost, zamiast zmyślać.
Jeśli odpowiedź jest wartościowa (porównanie, decyzja, synteza), agent zaproponuje zapisanie jej w 04-Wiki/analyses/. Dzięki temu Twoje pytania też budują bazę, a nie znikają w historii czatu.
Krok 5 — Przegląd wiki (lint) 🤖
Co jakiś czas, np. raz w tygodniu albo po kilku ingestach:
Zrób przegląd wiki.
Agent szuka sprzeczności, stron bez linków, linków do nieistniejących stron i luk. Oczywiste rzeczy naprawi, resztę zaproponuje. Wynik trafi do log.md.
Krok 6 — Dokumentacja projektów jako źródło 🤖
Kopie dokumentacji z Rozdziału 4 to też źródła. Gdy je odświeżysz skryptem, poproś:
Przetwórz dokumentację moj-projekt.
Agent zrobi ingest bez przenoszenia plików (kopie zostają w 01-Projects/), a w wiki powstaną strony o stacku, usługach i decyzjach projektu. Zacznij od README; obszerną dokumentację przetwarzaj partiami.
Dodawanie źródeł z przeglądarki 📱
Najwygodniej zapisywać artykuły rozszerzeniem Obsidian Web Clipper (Chrome, Safari, Firefox):
- Zainstaluj rozszerzenie ze strony obsidian.md.
- W ustawieniach rozszerzenia wybierz swój vault i folder
00-Inbox. - Na ciekawym artykule kliknij ikonę rozszerzenia → Add to Obsidian.
Potem wystarczy jedno polecenie:
Przetwórz inbox.
Ściąga: co mówić agentowi
| Chcesz… | Powiedz |
|---|---|
| dodać plik z inboxa | „przetwórz inbox” |
| dodać stronę z internetu | „dodaj to źródło: ” |
| dodać wiele źródeł bez pytań | „przetwórz inbox w trybie wsadowym” |
| zapytać bazę | „co wiem o …?”, „porównaj … z …” |
| zapisać odpowiedź | „zapisz to jako analizę” |
| posprzątać | „zrób przegląd wiki” |
| zmienić zasady | „zmieńmy schemat: …” (agent pokaże zmianę i zapisze ją w log.md) |
Weryfikacja rozdziału
- Agent uruchomiony w folderze vaulta potwierdził, że zna schemat.
- Pierwszy ingest utworzył stronę źródła i kilka stron pojęć/encji.
-
index.mdma wpisy, alog.mdwpisingest. - Pytanie do bazy dało odpowiedź z linkami
[[...]]. - W grafie (⌘ + G) widać połączone strony wiki.
Podsumowanie
- ✅ Uruchomiłeś agenta w folderze vaulta i przedstawiłeś mu jego rolę.
- ✅ Wykonałeś pierwszy ingest i wiesz, co z niego powstaje.
- ✅ Umiesz pytać bazę (query) i zlecić przegląd (lint).
- ✅ Wiesz, jak dodawać źródła z przeglądarki i z dokumentacji projektów.
Po tym rozdziale masz działający „drugi mózg” na swoim komputerze. Na razie istnieje tylko na jednym dysku. W następnym rozdziale zrobimy z niego repozytorium Git i wyślemy do prywatnej kopii na GitHubie.
Dalej: Rozdział 7 — Git i prywatne repozytorium na GitHubie.