6

Rozdział 6 z 11

Pierwszy ingest i codzienna praca z agentem

Opublikowany

Uruchamiamy Claude Code w folderze vaulta i wykonujemy pierwszy ingest — z jednego źródła powstaje kilka połączonych stron wiki. Potem pytania do bazy (query) i przegląd (lint).

Czego się nauczysz

  • Uruchomienie agenta w folderze vaulta
  • Pierwszy ingest krok po kroku
  • Query — pytania do bazy
  • Lint — przegląd wiki
  • Web Clipper i ściąga poleceń

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.md i log.md oraz 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 do CLAUDE.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:

  1. przeczytać źródło,
  2. pokazać Ci 3–5 kluczowych wniosków i zapytać, na czym się skupić,
  3. po Twojej odpowiedzi utworzyć stronę źródła,
  4. utworzyć lub zaktualizować strony pojęć i encji,
  5. uzupełnić przeglad.md, index.md i log.md,
  6. zrobić commit (jeśli vault jest już repozytorium Git; w przeciwnym razie ten krok pominie),
  7. 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):

  1. Zainstaluj rozszerzenie ze strony obsidian.md.
  2. W ustawieniach rozszerzenia wybierz swój vault i folder 00-Inbox.
  3. 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.md ma wpisy, a log.md wpis ingest.
  • 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.

Narzędzia / paczki

Claude Code Obsidian Web Clipper

Spis treści