# LLM Knowledge Base: System Zarządzania Wiedzą (Karpathy Pattern)

Ten projekt to osobista baza wiedzy (Knowledge Base), która jest **aktywnie utrzymywana przez LLM**. Zamiast tylko przechowywać dokumenty, system ten incrementally buduje i syntetyzuje wiedzę w strukturę połączonych plików Markdown.

## 🧠 Filozofia
System opiera się na połączeniu dwóch idei:
- **Karpathy Pattern**: Knowledge Base jako "codebase" wiedzy utrzymywany przez LLM.
- **12 Problemów Feynmana**: Metoda polegająca na trzymaniu w pamięci (i tutaj - w pliku `knowledge/feynman_problems.md`) 12 kluczowych pytań. Każde nowe źródło jest testowane pod kątem tego, czy pomaga rozwiązać lub zrozumieć któryś z tych problemów.

## 📂 Struktura Katalogów
- `raw/`: **Źródła Prawdy**. Tu trafiają Twoje materiały (PDF, Markdown, notatki). Są one niemodyfikowalne.
    - `articles/`: Artykuły z sieci, blogi.
    - `notes/`: Twoje własne przemyślenia i surowe notatki.
- `knowledge/`: **Warstwa Syntezy**. Pliki generowane i utrzymywane przez LLM.
    - `sources/`: Analizy konkretnych dokumentów z `raw/`.
    - `entities/`: Strony konkretnych narzędzi, osób i technologii (np. `n8n`).
    - `concepts/`: Głębokie analizy idei i teorii (np. `human-in-the-loop`).
    - `index.md`: Katalog całej treści (Mapa Knowledge Base).
    - `log.md`: Dziennik zdarzeń (Co i kiedy zostało dodane).
- `GEMINI.md`: Zasady i instrukcje dla Gemini CLI.

## 🚀 Jak korzystać z systemu?

### 1. Ingest (Dodawanie wiedzy)
Wrzuć nowy plik do folderu `raw/` i wydaj polecenie:
> *"Przetwórz nowe dokumenty z katalogu raw"*

**Co zrobi LLM:** Przeczyta plik, stworzy podsumowanie w `knowledge/sources/`, zaktualizuje powiązane encje i koncepcje, oraz dopisze informację do indeksu i logu.

### 2. Query (Zadawanie pytań)
Zadaj dowolne pytanie techniczne lub teoretyczne:
> *"Jakie narzędzia do automatyzacji researchu mamy w bazie?"*

**Co zrobi LLM:** Najpierw sprawdzi `knowledge/index.md`, przeczyta odpowiednie strony z `knowledge/` i przygotuje odpowiedź z cytowaniami.

### 3. Lint (Sprzątanie)
Raz na jakiś czas poproś o przegląd bazy:
> *"Wykonaj lint knowledge i znajdź brakujące połączenia"*

**Co zrobi LLM:** Znajdzie "sieroty" (pliki bez linków), sprzeczności między starymi a nowymi źródłami lub zasugeruje stworzenie nowej strony koncepcyjnej dla często pojawiającego się tematu.

## 🛠️ Narzędzia polecane
- **Obsidian**: Najlepsze narzędzie do przeglądania tej bazy. Użyj "Graph View", aby zobaczyć jak Twoja wiedza się łączy.
- **Gemini CLI**: Twój asystent, który wykonuje całą "brudną robotę" edytorską.

---
*System zainicjalizowany: 2026-05-14*