# Brain — LLM Wiki Deployment Plan

> Vytvoreno: 2026-05-28
> Cil: Nasadit a pouzivat plugin `praneybehl/llm-wiki-plugin` (Karpathy LLM Wiki pattern) jako osobni knowledge base "brain" napric pocitaci, s uchovavanim vseho contentu v gitu a integraci do nanobota.

---

## 1. Architektura

### 1.1 Repo
- **Nazev:** `brain`
- **Host:** Gitea self-hosted (`https://git.fnet.cz`)
- **URL:** `git@git.fnet.cz:lachtan/brain.git`
- **Viditelnost:** private
- **Branch:** `main` (primarni, ingest jde rovnou sem)

### 1.2 Lokalni cesta na tomto stroji
- `/home/nanobot/brain/`
- Uvnitr standardni `wiki/` struktura z pluginu (plugin hardcoduje `wiki/`, pozdeji lze patchnout)

### 1.3 Stroje
| Stroj | Role | Claude Code | Nanobot |
|-------|------|-------------|---------|
| home pc | primary dev | ano (GUI) | ne |
| office pc | secondary dev | ano (GUI) | ne |
| wood.hell | server/CLI | ano (CLI only) | ne |
| tento LXC | nanobot host | ne | ano |

### 1.4 Sync mechanismus
- Git push/pull mezi vsemi instancemi
- Okamzity `git commit && git push` po kazdem zapisu nanobotem
- Ostatni stroje si pulluji pri startu nebo periodicke

---

## 2. Git & SSH

### 2.1 SSH klic pro nanobot
- Vygenerovan: `/home/nanobot/.ssh/id_ed25519` (ed25519, bez passphrase)
- Public key: pridat do Gitea repo `brain` jako deploy key nebo k uzivatelskemu uctu
- Fingerprint: `SHA256:iMrDLkVKxNAGPo+xOup0Abi7c/49/D/rZx/MPUIPt4U`

### 2.2 Git config
- `user.name`: `nanobot`
- `user.email`: `nanobot@git.fnet.cz`
- Remote: `origin` → `git@git.fnet.cz:lachtan/brain.git`

---

## 3. Struktura wiki

Plugin vytvari adresar `wiki/` s nasledujici strukturou:

```
wiki/
  index.md              # hlavni index, sharded pri >300 radku
  indexes/              # per-type indexy pri >150 strankach
  pages/                # strukturovane stranky (vysledky ingestu)
  sources/              # raw sources (vstupy pro ingest)
  references/           # scaling playbook, schema docs
```

Kazda stranka ma YAML frontmatter:
```yaml
---
title: "Nazev"
type: concept | source | summary | index
tags: [tag1, tag2]
created: YYYY-MM-DD
updated: YYYY-MM-DD
sources: [slug-zdroje]
---
```

---

## 4. Nanobot integrace

### 4.1 Rozliseni zapisu
- "zapis do brain" / "do wiki" / "brain-write" → zapis do `brain/wiki/`
- Bez klicoveho slova → zapis do `MEMORY.md` (soucasne chovani)

### 4.2 Slash commands / skill tools
| Operace | Popis | Auto commit |
|---------|-------|-------------|
| `/brain-write` | Zapis raw source nebo stranky s YAML frontmatter | ano, okamzite |
| `/brain-search` | Fulltext search pres markdown soubory (grep/BM25) | neni potreba |
| `/brain-ingest` | Full LLM ingest — zkompiluje raw source do stranek | ano, okamzite |

### 4.3 Frontmatter
- `/brain-write` automaticky pridava YAML frontmatter:
  - `created`, `updated` (datum)
  - `source` (napr. `telegram`, `web`, `user-input`)
  - `tags` (volitelne, zadane uzivatelem)
  - `type` (`source` pro raw, `concept` pro zpracovane)

### 4.4 Ingest workflow
- Nanobot cte raw source z `wiki/sources/`
- Vola LLM (qwen-3.6-plus) pro strukturalni analyzu
- Vytvari/aktualizuje stranky v `wiki/pages/`
- Aktualizuje `wiki/index.md` a cross-references
- Commit + push do `main`

---

## 5. Modely

### 5.1 Dostupne modely (cloud pres OpenRouter/Ollama gateway)
- `deepseek-v3.2`
- `glm-5.1`
- `kimi-k2.6`
- `minimax-m2.7`
- `qwen-3.6-plus`
- `qwen3.5`

### 5.2 Model pro ingest
- **Primarni:** `qwen-3.6-plus-openrouter` — dobry reasoning/coding, cena
- **Fallback:** `kimi-k2.6-openrouter` — pro velke sources (>32K tokenu)

### 5.3 Ollama role
- Ollama na `nvidia.hell` slouzi jako gateway/proxy pro cloud modely
- Zadny lokalni inference pro ingest (vsechny modely jsou cloud)

---

## 6. Skripty a tooling

### 6.1 Pluginove skripty (z `praneybehl/llm-wiki-plugin`)
- `init_wiki.py` — inicializace wiki struktury
- `wiki_search.py` — BM25 search s frontmatter filtry
- `wiki_lint.py` — strukturalni lint (velikost stranek, odkazy)
- `wiki_stats.py` — statistiky a scaling thresholds
- `wiki_graph_*.py` — optional graph layer (vyzaduje PyYAML)

### 6.2 Nasazeni skriptu
- Skripty budou pripraveny v Claude Code a zkopirovany do `brain/skills/llm-wiki/scripts/`
- Nanobot skill wrapper je bude volat pres `exec` nebo jako tool

### 6.3 Skill wrapper pro nanobot
- Pripraven v Claude Code jako nanobot-compatible skill
- Minimalni sada na startu: `write`, `search`, `ingest`
- Rozsireni pozdeji podle potreby (lint, stats, graph)

---

## 7. Scaling & udrzba

### 7.1 Automaticke sharding
- `wiki/index.md` se sharduje pri >300 radcich
- Per-type indexy v `wiki/indexes/` pri >150 strankach
- BM25 search fallback pri >300 strankach

### 7.2 Velikostni limity
- Stranka: soft cap 400 radku, hard cap 800 radku
- Ingest velkych sources: chunked (po castech)

### 7.3 Safety
- Ingest jde rovnou do `main`
- Git history jako pojistka pro revert
- Chybne ingesty se opravuji v Claude Code

---

## 8. Implementacni kroky

### Faze 1: Zaklad
1. [ ] Pridat SSH public key do Gitea repo `brain`
2. [ ] Naklonovat `brain` do `/home/nanobot/brain/`
3. [ ] Nastavit git config (user.name, user.email)
4. [ ] Inicializovat wiki strukturu (`init_wiki.py` nebo rucne)
5. [ ] Otestovat git push/pull

### Faze 2: Nanobot skill
1. [ ] Pripravit skill wrapper v Claude Code
2. [ ] Implementovat `/brain-write` s frontmatter
3. [ ] Implementovat `/brain-search`
4. [ ] Testovat zapis a search

### Faze 3: Ingest
1. [ ] Otestovat modely na ingest (qwen-3.6-plus)
2. [ ] Implementovat `/brain-ingest`
3. [ ] Otestovat full workflow: raw source → ingest → stranka

### Faze 4: Rozsireni
1. [ ] Pridat pluginove skripty (lint, stats, graph)
2. [ ] Nastavit cron pro periodicke lint/stats
3. [ ] Integrovat s ostatnimi stroji (home pc, office pc, wood.hell)

---

## 9. Rozhodnuti z grill-me session

| Tema | Rozhodnuti |
|------|-----------|
| Nazev projektu | `brain` (repo), uvnitr `wiki/` (plugin default) |
| Lokalni cesta | `/home/nanobot/brain/` |
| Git workflow | Okamzity commit+push do `main` |
| SSH auth | Novy klic pro `nanobot` uzivatele |
| Zapis bez keywordu | MEMORY.md |
| Zapis s "brain/wiki" | `brain/wiki/` |
| Frontmatter | Automaticky pridavat |
| Ingest scope | Full LLM ingest (ne jen light) |
| Ingest model | qwen-3.6-plus (fallback kimi-k2.6) |
| Safety | Rovnou do `main`, git history jako pojistka |
| Skripty | Pripravit v Claude Code, integrovat pozdeji |

---

## 10. Odkazy

- Plugin: https://github.com/praneybehl/llm-wiki-plugin
- Karpathy gist: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
- Gitea: https://git.fnet.cz/lachtan/brain