DBAdmin/brain/raw/inbox/Your Obsidian Vault Is a Knowledge Graph. Here’s How to Make It Think (quickly)..md at c36ead5db0f6966357ca0eedfe6432e3a755206d

dexter/DBAdmin

Fork 0

Files

T

Paweł Domański c36ead5db0 Jun 9, 2026, 3:59 PM

2026-06-09 13:59:59 +00:00

23 KiB

Raw Blame History

title, source, author, published, created, description, tags

title

source

author

published

created

description

Co większość przewodników Obsidian-AI robi źle

Większość poradników integracyjnych zaczyna się od tego narzędzia. Zainstaluj tę wtyczkę. Skonfiguruj ten serwer. Oto blob JSON. Brakuje im fundamentalnego wglądu, który sprawia, że wszystko działa.

Kod Claude'a nie został stworzony do robienia notatek. Został stworzony, aby poruszać się po bazach kodu — czytać pliki, rozumieć strukturę, podążać za odniesieniami, dokonywać ukierunkowanych edycji i realizować wieloetapowe plany. Obsydianowy skarbiec niemal idealnie się na to odwzorowuje. Kod zawiera pliki źródłowe, instrukcje importu, strukturę katalogów i konfigurację. Twój skarbiec zawiera notatki Markdown, knowledgelinki, hierarchie folderów i materiały YAML. Claude Code porusza się po nich z podobną bieglością.

Najprostsza integracja jest najbardziej niedoceniana:

cd ~/my-vault
claude

To wszystko. Claude Code może teraz czytać każdą notatkę, tworzyć nowe pliki, edytować treści, wyszukiwać za pomocą regexu i uruchamiać polecenia shell na twoim skarbcu. Brak wtyczek, brak serwerów, brak konfiguracji.

Ale "może uzyskać dostęp do plików" to stawka stołowa. Pięć lat, które spędziłem na strukturze mojego skarbca — konwencji, architektury folderów, wzorców łączenia — to właśnie sprawia, że integracja jest naprawdę użyteczna. A nauka tych konwencji to właśnie wtedy zaczyna się prawdziwa praca.

CLAUDE.md: Plik, który zmienia wszystko

Gdy uruchamiasz katalog, automatycznie odczytuje on plik wywołany w bazie głównej. Traktuj to jak dokumentację wdrożenia dla niezwykle kompetentnego nowego pracownika, który zapomni wszystko między sesjami.claude CLAUDE.md

Za pierwszym razem prowadzę i generuję punkt startowy przez skanowanie struktury skarbca. Potem mocno ją przepisuję. Wygenerowana wersja zawiera oczywiste elementy — nazwy folderów, typy plików. Ale nie zna moich konwencji, aktywnych projektów ani rzeczy, których Claude nigdy nie dotyka./init

Oto, czego nauczyło mnie pięć lat dyscypliny na skoku, jak włożyć CLAUDE.md:

# Vault Context
This is my personal + professional knowledge vault. Five years 
of notes across consulting, investing, and distributed systems 
research, and personal development. Notes use Obsidian-flavored 
Markdown with [[knowledgelinks]], callouts, and YAML frontmatter.
## Structure
- Projects/ - active client and personal work
- Areas/ - ongoing domains (health, finance, ML research)
- Resources/ - reference material, book notes, papers
- Archive/ - completed work (still searchable, not active)
- _attachments/ - images and PDFs (NEVER modify)
- _templates/ - Obsidian templates (NEVER modify)
- _ai-drafts/ - staging area for AI-generated content
## Conventions
- Internal links: always [[knowledgelinks]], never bare URLs
- Tags: hierarchical #domain/topic format
- MOCs: prefixed "MOC - " (Maps of Content)
- Daily notes: Journal/YYYY/YYYY-MM/YYYY-MM-DD.md
- Source notes: must include \`source:\` in frontmatter
## Rules
- NEVER modify _attachments/, _templates/, or .obsidian/
- NEVER delete notes without my explicit confirmation
- Always include YAML frontmatter: date, tags, aliases
- When synthesizing, use ONLY content from my notes
- Output drafts to _ai-drafts/ - never directly into the vault
## Active Context (I update this before each session)
- Working on: Q2 client architecture review
- Open questions: containerization strategy for legacy systems
- Recent focus: Areas/distributed-systems/, Projects/client-acme/

Trzy nieoczywiste praktyki, których się nauczyłem, są ważniejsze niż sam szablon:

Utrzymuj aktywny kontekst świeży. Aktualizuję tę sekcję przed każdą sesją. Nieświeży kontekst jest gorszy niż brak — sprawia, że Claude powala wczorajsze priorytety. Jeszcze lepiej: na koniec każdej sesji proszę Claude'a o dołączenie krótkiego dziennika sesji. To tworzy ciągłość, której nie spodziewałem się tak bardzo cenić.

Odniesienie, nie wrzucaj w linię. Moje zainteresowania, aktywne projekty i kontekst zawodowy są w osobnych notatkach. CLAUDE.md się do nich odwołuje. Dzięki temu plik główny jest skoncentrowany i unika palenia tokenów na kontekście, który nie jest istotny dla każdej sesji.

Dołącz negatywne instrukcje. "Nigdy nie modyfikuj _templates/" jest skuteczniejsze niż liczenie, że Claude się zorientuje. Przekonałem się tego na własnej skórze, gdy na jednej z pierwszych sesji pomocnie "ulepszyłem" jeden z moich skryptów Templatera.

Wykres wiedzy, który już masz

Oto, co zaskoczyło mnie po latach łączenia notatek: mój skarbiec to nie tylko folder plików Markdown. To baza danych grafów.

Każdy skarbiec Obsydian zawiera graf niejawny. Notatki to węzły. Knowledge Baselinki tworzą krawędzie — gdy piszesz w notatkach Raft, tworzysz przejście między pojęciami i pojęciami. Poszczególne knowledgelinki są kierowane (uwaga A linkuje do notatki B), ale funkcja backlinków Obsidian tworzy dwukierunkową warstwę nawigacyjną, dzięki czemu można przechodzić przez połączenia w dowolnym kierunku. Tagi działają jak etykiety, grupując węzły w podgrafy. Właściwości frontmatter stają się atrybutami węzłów, które narzędzia śledzące grafy mogą zapytywać i filtrować.[[Distributed Consensus]]

Widok grafu Obsidian pokazuje tę strukturę. Jest piękny. Ale jest bierny — nie potrafi rozumować nad wykresem, nie potrafi powiedzieć, które notatki są hubami, nie potrafi zidentyfikować klastrów, które powinny być połączone, a nie są.

Po 5 000 notatek i pięciu latach linkowania mój wykres ma realną strukturę wartą analizy. I właśnie tutaj Claude Code — zwłaszcza dzięki serwerom MCP z możliwością grafów — wypełnia lukę, której sam Obsidian nie robi.

Metryki grafowe, które faktycznie mają znaczenie

Gdy podłączysz kod Claude'a do swojego sejfu przez serwer MCP wspierający operacje grafowe, odblokowujesz analizę, którą kiedyś robiłem na oko (słabo) lub wcale:

Ranking centralności identyfikuje twoje prawdziwe notatki w centrum — pojęcia łączące się z większością innych koncepcji. Odkryłem, że moje prawdziwe huby nie zawsze pokrywają się z moimi "oficjalnymi" MOC-ami (Mapami Zawartości). Moja notatka o "Pętlach Sprzężenia Zwrotnego" zawierała 38 łączy przychodzących na czterech domenach. Mój MOC z myślenia systemowego miał 7. Ta rozbieżność była sygnałem, że muszę się zrestrukturyzować.

Tak wygląda zapytanie o centralność w praktyce przy użyciu TurboVault:

> get_centrality_ranking(limit=5)

1. Feedback Loops - 38 connections (Areas/systems-thinking, 
   Projects/client-acme, Resources/books)
2. MOC - Distributed Systems - 34 connections
3. Bayesian Reasoning - 29 connections (bridges 3 clusters)
4. Second-Order Effects - 26 connections
5. Margin of Safety - 24 connections (Areas/investing, 
   Projects/portfolio)

Detekcja sierot znajduje notatki bez żadnych łączy przychodzących ani wychodzących. W moim skarbcu miałem 340 sierot — idee, które uchwyciłem, ale nigdy nie połączyłem. Niektóre były warte integracji. Większość z nich to kandydaci do archiwum. Tak czy inaczej, nie wiedziałem, że istnieją, dopóki nie zapytałem.

Analiza klastrów ujawnia naturalne grupowania oraz, co ważniejsze, które klastry są rozłączone. Moje notatki inwestycyjne i myślenie systemowe były dwoma odrębnymi wyspami, mimo oczywistego nakładania się koncepcji. To była okazja integracji, której przez lata mi brakowało.

Identyfikacja nut mostkowych znajduje rzadkie nuty łączące inaczej izolowane klastry. To często są twoje najbardziej oryginalne spostrzeżenia — miejsca, gdzie połączyłeś dziedziny, które inni trzymają osobno.

Narzędzia: Co naprawdę działa

Przetestowałem każdą główną ścieżkę integracji. Oto co bym polecił, uporządkowane według rosnącej złożoności.

Poziom 1: Bezpośredni system plików (Zacznij tutaj)

Po prostu uciekaj z rootu vaultu. Dodaj CLAUDE.md. Zainstaluj oficjalne kepano/obsidian-skills — pięć plików umiejętności od CEO Obsidian, Steph Ango, które uczą Claude Code pełnego formatu Obsidian: knowledgelinki, callouty, Bases, Canvas i CLI. Bez nich Claude traktuje go jak zepsuty Markdown i jak cytat.claude [[knowledgelinks]] > [!warning]

npx skills add git@github.com:kepano/obsidian-skills.git

To połączenie — CLI + CLAUDE.md + umiejętności — obsługuje 80% tego, czego potrzebuję. Używałem właśnie tego przez pierwsze dwa miesiące.

Tier 2: Serwer MCP (gdy potrzebujesz strukturalnego wyszukiwania)

Gdy mój skarbiec przekroczył 2000 notat, dostęp do surowych plików zaczął być wolny przy pracy opartej na wyszukiwaniach. Serwery MCP udostępniają Twój sejf jako narzędzia strukturalne, które kod Claude może wywoływać programowo: wyszukiwanie, operacje frontmatter, zarządzanie tagami, przeszukiwanie grafów.

Moja rekomendacja dla większości osób — MCPVault: zero zależności wtyczek Obsidian, 14 metod, wyszukiwanie w rankingu BM25 i o 40–60% mniejsze zużycie tokenów przez kompresję odpowiedzi. Ustaw to w konfiguracji Claude:

~/.claude.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["@bitbonsai/mcpvault@latest", "/path/to/your/vault"]
    }
  }
}

Aby zintegrować Obsidian, obsidian-claude-code-mcp uruchamia serwer MCP wewnątrz samego Obsidian z automatycznym wykrywaniem WebSocket — uruchom, wpisz, i wybierz swój skarbiec z listy. Do wyszukiwania semantycznego (opartego na znaczeniu) obsidian-mcp-tools integruje się z wtyczką Smart Connections, aby znaleźć powiązane notatki koncepcyjne, nawet jeśli nie mają one wspólnych terminów.claude /ide

Poziom 3: Analiza grafów (dla dużych, mocno powiązanych skarbców)

TurboVault to potężne narzędzie — silnik Rust z 47 specjalistycznymi narzędziami, wyszukiwaniem BM25 poniżej 500 ms na 100 000 notatek, zapytaniami SQL na frontmaterii oraz możliwościami analizy grafów (centralność, klastry, mosty), które opisałem powyżej. Jeśli Twój skarbiec ma 10 000+ notatek lub zależy Ci na wglądach na poziomie grafów, warto się z tym zająć.

Obsidian-MCP-Plugin stosuje inne podejście — udostępnia Twój vault jako połączony graf wiedzy z wieloprzeskokowym przejściem, analizą backlinków i odkrywaniem koncepcji. AI samodzielnie porusza się po strukturze grafu, zamiast traktować notatki jako izolowane pliki.

Poziom 4: Wbudowane wtyczki (dla fanów paska bocznego)

Wtyczki takie jak Claudian i Cortex osadzają Claude'a bezpośrednio w pasku bocznym Obsidian z trwałymi sesjami i aktywną świadomością nut. Interfejs jest płynny, ale jesteś zależny od konserwacji wtyczek. Wolę CLI ze względu na elastyczność — ale jeśli mieszkasz cały dzień w Obsidian, doświadczenie z paskiem bocznym jest bardzo interesujące.

Procesy pracy, które zasługują na utrzymanie

Nie każdy workflow AI się utrzymuje. To właśnie te używam nadal co tydzień po miesiącach iteracji.

Automatyczne backlinkowanie (Lek Gateway)

Read my journal entry for today and add [[knowledgelinks]] to all 
people, places, and books mentioned. Search the vault for 
existing notes on each entity. If no note exists, create a 
stub in Resources/People/ or Resources/Places/ with basic 
frontmatter.

To był mój pierwszy workflow Claude Code i nadal jest to ten z najwyższym zwrotem z inwestycji. To, co kiedyś zajmowało mi 10–15 minut ręcznego linkowania, teraz dzieje się podczas oczekiwania. Po trzech miesiącach regularnego korzystania moje codzienne wpisy w dzienniku zmieniły się z ślepych notatek w bogato połączone węzły na wykresie. Efekt kumulacji jest realny — każdy powiązany wpis daje Claude'owi lepszy kontekst do kolejnego.

Synteza międzydomenowa

To jest workflow, który sprawił, że na nowo przemyślałem, do czego służy vault:

Read my notes in Areas/distributed-systems/ and 
Areas/organizational-design/. Identify concepts that appear 
in both domains or that share structural similarities. 
Write a synthesis note at _ai-drafts/cross-domain-synthesis.md 
mapping the parallels. Use ONLY content from my notes — 
do not add external claims. Include [[knowledgelinks]] to all 
source notes.

Claude dostrzegł powiązania, których wcześniej nie poruszyłem: moje notatki dotyczące protokołów konsensusu i podejmowania decyzji w organizacjach płaskich opisywały ten sam problem koordynacji z różnych perspektyw. Ta notatka synteza stała się ziarnem wykładu konferencyjnego. Nie napisałbym jej ręcznie — nie dlatego, że nie mogłem, ale dlatego, że energia aktywacyjna czytania 40 notatek w dwóch folderach i trzymania ich wszystkich w pamięci roboczej była zbyt wysoka.

Audyt stanu skarbca (miesięczna konserwacja)

Find all orphan notes (no incoming or outgoing links), 
notes missing YAML frontmatter, and broken knowledgelinks. 
Output a report at _ai-drafts/vault-health-report.md.

Biegam w tym co miesiąc. To odpowiednik PKM uruchamiania twojego zestawu testowego. Zanim zacząłem, mój vault miał 9% współczynnik sierot i bardzo niespójną tematykę na początku. Sześć miesięcy comiesięcznych audytów obniżyło liczbę sierot poniżej 2%, a zgodność z przednimi zadaniami powyżej 95%.

Analiza luk

Examine Areas/investing/ and list topics that are serious 
practitioner would expect to find, but aren't covered by 
any existing note.

Claude zauważył, że moje notatki inwestycyjne szeroko obejmowały wycenę i rowy, ale prawie nic nie zawierały na temat wielkości pozycji, zarządzania ryzykiem czy konstrukcji portfela. Ta luka była dla mnie niewidoczna przez trzy lata, bo notatki*, które* miałem, wydawały się obszerne.

Szybkie przewody CLI

claude -p "Summarize Resources/RFID/ in 200 words" \
  > Resources/RFID-summary.md

Flaga (lub ) uruchamia Claude nieinteraktywnie i wysyła na stdout. Używam tego do operacji wsadowych — generowania streszczeń dla całych folderów, wyodrębniania kluczowych zapytań z notatek badawczych lub tworzenia notatek roboczych z listy tematów.-p --print

Dlaczego Obsidian + Claude, a nie Notion AI czy logseq + GPT

Próbowałem alternatyw. Oto dlaczego ciągle wracam:

Pliki lokalne, nie lock-in w chmurze. Mój sejf to folder plików Markdown w moim systemie plików. Jestem ich właścicielem. Jutro mogę je zrobić kopię zapasową albo zmienić narzędzie. Notion AI jest potężne, ale Twoje dane znajdują się na serwerach Notion w zastrzeżonym formacie. Kiedy daję Claude Code dostęp do mojego sejfu, odczytuje on te same pliki, które edytuję w Obsidian — bez warstwy synchronizacji, bez tłumaczenia API, bez danych opuszczających mój komputer.grep git

Agentic, nie autocomplete. Większość integracji AI w narzędziach PKM to automatyczne uzupełnianie na sterydach — sugerują to, że piszesz na klawiaturze. Claude Code jest agentem. Może przeczytać 40 notatek, określić, które są istotne, tworzyć nowe pliki, dodawać knowledgelinki i raportować o swoich działaniach. Różnica między "pisaniem wspomaganym AI" a "zarządzaniem wiedzą wspomaganym przez AI" jest różnicą między lepszą klawiaturą a asystentem badawczym.

Kompozycyjne, nie monolityczne. Mogę zmienić serwery MCP i zmienić CLAUDE.md, dodać umiejętności, przesyłać sygnały przez skrypty shell lub użyć zupełnie innego modelu AI jutro. Architektura składa się z warstw tekstu zwykłego i otwartych protokołów. Nic nie jest zablokowane.

Kod Claude wymaga subskrypcji Max lub korzystania z API, co wiąże się z kosztami, i warto to podkreślić. Dla moich wzorców użytkowania — kilka sesji tygodniowo, każda z 20–50 notatek — koszt to błąd zaokrąglenia w porównaniu do zaoszczędnych godzin konsultacji. Twoje obliczenia będą się różnić, ale warto to śledzić przez pierwszy miesiąc.

Praktyki bezpieczeństwa, które na pewno chciałbyś najpierw określić

Nauczyłem się tego przez błędy. Ustaw je przed pierwszą sesją.

Użyj git do swojego vaulta. To jest najważniejsza siatka bezpieczeństwa. Każda zmiana wprowadzana przez Claude'a staje się różnicą do przeglądu. Każdy błąd staje się odwracalny.

cd ~/vault
git init
echo ".obsidian/workspace.json" >> .gitignore
echo "_attachments/" >> .gitignore

Przejrzyj pliki etapowe przed pierwszym commitem — upewnij się, że nie śledzisz przypadkowo wrażliwych danych.

Przekieruj wszystkie wyjścia AI przez . Praca Claude'a to szkic, dopóki jej nie przejrzysz. Nigdy nie pozwól, by zapisał się bezpośrednio w twojej głównej strukturze sejfu. Awansuj notatki ręcznie po przeglądzie. To zachowuje Twój skarbiec jako repozytorium twojego myślenia.**_ai-drafts/**

Zawsze ograniczaj prompty syntezy. "Używaj TYLKO treści z moich notatek" nie jest opcjonalne. Bez niego Claude miesza twoją wiedzę z danymi treningowymi, a efekt wygląda autorytatywnie, ale zawiera twierdzenia, których nigdy nie wypowiedziałeś. Dodaję to ograniczenie do każdego żądania syntezy i podsumowania — to odpowiednik oczyszczania wejść w PKM.

Żądania zakresu do konkretnych folderów. "Summarizuj zasoby/obliczenia kwantowe/" jest bezpieczne i szybkie. "Podsumuj cały mój skarbiec" to symboliczna bomba, która daje płytkie rezultaty.

Efekt złożony

Prawdziwa nagroda nie polega na jednym procesie. To się dzieje przez miesiące ciągłej konserwacji wspomaganej przez AI.

Po trzech miesiącach automatycznego backlinkowania moje codzienne notatki przekształciły się z beznadziejnych wpisów w powiązane węzły. Po sześciu miesiącach audytów zdrowia skarbca mój wskaźnik sierot spadł z 9% do poniżej 2%. Po przeprowadzeniu analizy luk w każdej dziedzinie wiedzy zacząłem pisać notatki wypełniające dziury strukturalne, zamiast nakładać się na już gęste skupiska.

Wykres staje się gęstszy, bardziej spójny i bardziej nawigacyjny — zarówno dla mnie, jak i dla AI. Lepiej powiązane notatki dają Claude'owi lepszy kontekst, co prowadzi do lepszych sugestii, a to tworzy lepsze powiązania. Każda poprawa się nasila.

To jest trajektoria, którą obiecywała metoda Zettelkasten, ale niewielu osób osiąga to ręcznie. Praca organizacyjna — linkowanie, tagowanie, formatowanie, spójność — to dokładnie to, w czym AI się wyróżnia. To ty wnosisz myślenie. Claude przynosi księgowość.

Zaczynamy w tym tygodniu

Jeśli dotarłeś aż tutaj i jeszcze nie zacząłeś, oto 30-minutowe wprowadzenie:

Zainstaluj kod Claude — npm install -g @anthropic-ai/claude-code
Inicjalizuj — wtedy cd ~/vault && claude /init
Przepisz CLAUDE.md — użyj powyższego szablonu, dostosowanego do struktury i konwencji Twojego skarbca
Instaluj obsydian-skills — npx skills add git@github.com:kepano/obsidian-skills.git
Przeprowadź swój pierwszy audyt — "Znajdź wszystkie notatki osierocone i brakujące materiały YAML. Wyślij raport na adres _ai-drafts/vault-audit.md."

A oto wyzwanie na pierwszy tydzień, które pozwoli przejść przez etap samouczka: zautomatyzować backlinkowanie na 7 codziennych notatek. Zrób swój pierwszy audyt zdrowia skarbca. Poproś Claude'a, by znalazł powiązania między waszymi dwoma najbardziej odrębnymi dziedzinami wiedzy. Do piątku będziesz miał wyczucie, czy to zmienia Twój workflow, czy to tylko kolejne błyszczące narzędzie.

Stawiam na to pierwsze. Pięć lat budowania mojego skarbca uczyniło go wartościowym. Połączenie tego z agentem, który faktycznie potrafi z nim myśleć, uczyniło tę wartość dostępną w sposób, którego się nie spodziewałem.

Wykres zawsze tam był. Teraz coś może ją przemierzyć.

Narzędzia open-source z referencją: kepano/obsidian-skills (oficjalne umiejętności agenta), MCPVault (serwer MCP bez zależności), TurboVault (analiza grafów Rust), obsidian-claude-code-mcp (integracja z WebSocket), obsidian-mcp-tools (wyszukiwanie semantyczne), Claudian (wtyczka boczna). Liczba gwiazd i cechy są aktualne na kwiecień 2026 roku.

23 KiB Raw Blame History Unescape Escape