Obsidian Brain: személyes tudásbázis, amit az AI is olvas

Több mint egy éve elkezdtem egy kísérletet: minden releváns információt, projektet, kontaktot és döntést egyetlen Obsidian vault-ba szerveztem. Ma 59 markdown fájl, 218 wikilink és 10 könyvtár alkotja a rendszert. Ez nem egy jegyzetelő alkalmazás. Ez egy AI-kiegészített tudásbázis, ami minden Claude Code session elején automatikusan betöltődik.

A probléma

A fejlesztők hétköznapjaiban az információ szétszóródik. Projektek Notion-ben, TODO-k sticky note-okon, kontaktok a fejben, infrastruktúra részletek elfeledett terminál history-ban. Amikor egy AI asszisztens segít a munkában, minden session nulláról indul: nem tudja milyen projektjeid vannak, milyen technológiákat használsz, milyen döntéseket hoztál korábban.

Ez a kontextusvesztés az AI-val való munka legnagyobb szűk keresztmetszete. Nem a modell képessége a korlát, hanem az, hogy nem tudja mit tudsz te.

A struktúra

A vault 10 könyvtárra tagolódik, mindegyik egy jól definiált tartományért felel:

obsidian-brain/
├── 00-en/          # Profil, tech stack, fiókok
├── 01-projektek/   # 30+ aktív projekt
├── 02-tanulmanyok/ # Egyetem, kurzusok
├── 03-emberek/     # 40+ kontakt
├── 04-szervezetek/ # Cégek, intézmények
├── 05-infrastruktura/ # Szerverek, domainek, MCP
├── 06-uzlet/       # Monetizáció, stratégia
├── 07-tudastar/    # Szakmai cikkek, tudás
├── 08-naplo/       # Napi jegyzetek
├── 99-archiv/      # Lezárt projektek
├── _anatomy.md     # Master index
└── CLAUDE.md       # AI auto-context

Minden könyvtárban van egy _index.md tartalomjegyzék. A gyökérben levo _anatomy.md az egész vault fájlindexe: minden fájl neve, célja és mérete egy helyen. Ez az, amit az AI session elején elolvas, hogy eldöntse mit kell ténylegesen megnyitnia.

Frontmatter: keresheto metaadatok

Minden fájl YAML frontmatter-rel kezdodik, ami strukturált metaadatot ad a jegyzethez:

---
tags: [projekt, aktiv, nextjs, portfolio]
status: aktív
path: /home/gabor/code_projects/portfolio/
deadline: 2026-06-01
---

A tags kereshetove teszi a tartalmakat, a status mezo szűr az aktív és lezárt projektek között, a path pedig direkt linket ad a kódbázishoz. Az AI ezek alapján gyorsan megtalálja a releváns kontextust anélkül, hogy az egész vault-ot végigolvasná.

Wikilink-ek: a tudásgráf

A vault jegyzetei [[wikilink]] szintaxissal kapcsolódnak egymáshoz. Egy projekt fájlból hivatkozhatsz a kapcsolódó személyre, szervezetre vagy infrastruktúrára:

# Portfolio

Személyes portfólió weboldal.
Deploy: [[contabo-vps]] Caddy reverse proxy mögött.
Fejlesztés: [[claude-code-setup]] integrációval.
Kliens: [[freelancer-ugyfelek]] listából.

Ez nem lineáris jegyzetelés, hanem gráf. Az Obsidian graph view-ja vizuálisan mutatja a kapcsolatokat, de ami igazán értékes: az AI is követi ezeket a linkeket és megérti a kontextust.

CLAUDE.md: az AI belépési pontja

A vault gyökerében egy CLAUDE.md fájl tartalmazza az AI-nak szóló instrukciókat. Claude Code automatikusan beolvassa, ha a vault könyvtárában fut:

# Obsidian Brain - Claude Code Context

## Vault navigáció
Mielőtt bármit olvasnál, nézd meg az _anatomy.md fájlt!
Ez tartalmazza az összes fájl célját és méretét.

## Szabályok
1. Mindig _anatomy.md-t olvasd először
2. Mappánként _index.md van - az a mappa tartalomjegyzéke
3. [[wikilink]] jelöli a kapcsolatokat más note-okkal
4. Frontmatter tags és status mezőket használj kereséshez

Ez a fájl biztosítja, hogy az AI ne vaktában keresjen a vault-ban, hanem a struktúra szerint navigáljon. Eloszor a fájlindexet olvassa, onnan dönt mit kell részletesebben megnézni.

Miért működik ez az AI-val?

A hagyományos jegyzetelés az emberi memóriát segíti. Az Obsidian Brain ezen túlmutat: az AI memóriáját is kiterjeszti. Amikor elindítok egy Claude Code session-t, az AI már a kontextus beolvasása után tudja:

• Milyen aktív projektjeim vannak és milyen fázisban állnak
• Milyen tech stack-et használok, milyen döntéseket hoztam korábban
• Milyen infrastruktúrán fut a rendszer
• Milyen kapcsolódó jegyzeteket érdemes megnéznie egy adott feladathoz

Enélkül minden session elején el kellene magyaráznom a hátteret. A vault-tal ez automatikus.

Gyakorlati példa

Ha azt mondom a Claude-nak: "nézd meg a portfolio projektet és frissítsd a deploy konfigurációt", a következo történik:

1. A CLAUDE.md alapján elolvassa az _anatomy.md-t
2. Megtalálja a 01-projektek/portfolio.md fájlt
3. Abból kiderül a path (a kódbázis helye) és a deploy információ
4. A [[contabo-vps]] linkbol megtalálja a szerver konfigurációt
5. A tényleges munkát a teljes kontextus ismeretében végzi el

Ez nem mágia, hanem jó struktúra. Az AI pontosan annyira hasznos, amennyire a kontextus, amit adsz neki.

Nem csak én gondolom így

Andrej Karpathy (korábbi Tesla AI vezető, OpenAI társalapító) 2025 áprilisában írt arról, hogy az LLM-ek egyre inkább tudásbázisok építésére és karbantartására szolgálnak, nem csak kód manipulálására. A nyers forrásanyagot egy raw/ könyvtárba indexeli, majd az LLM "kompilál" belőle egy wiki-t: markdown fájlok, visszahivatkozások, fogalomcikkek, automatikus kategorizálás. Az Obsidian a megjelenítő frontend, de a tartalom karbantartása az AI feladata.

Az Obsidian Brain pontosan ezt a mintát követi: strukturált markdown, amiben az AI navigál és dolgozik, nem az ember szerkeszti kézzel.

Tanulságok

Az Obsidian Brain építése közben több dolog is kiderült.

A struktúra fontosabb, mint a tartalom mennyisége. 59 fájl elég, ha jól szervezett. Ezer rendezetlen jegyzet kevesebbet ér.

A _anatomy.md a legfontosabb fájl. Ez a "tartalomjegyzék a tartalomjegyzékekhez", ami lehetove teszi, hogy az AI (vagy egy ember) pár másodperc alatt tájékozódjon.

A vault nem statikus dokumentáció, hanem munkaeszköz. Naponta frissül, projektek jönnek és mennek, kontaktok bovülnek. A lényeg, hogy a struktúra stabil maradjon, miközben a tartalom változik.

A legfontosabb felismerés: egy AI asszisztens nem attól lesz igazán hasznos, hogy okosabb modellt futtatsz, hanem attól, hogy jobb kontextust adsz neki. Az Obsidian Brain ezt a kontextust biztosítja.

---

A vault nyílt forráskódú mintáját a portfólióm projektjei között találod. Ha hasonló rendszert építenél, kezdd a mappastruktúrával és a CLAUDE.md fájllal. A többit a napi használat formálja ki.