Jak działają wiki-init, wiki-ingest i wiki-lint: LLM Wiki Karpathy'ego w praktyce

Czym jest metoda LLM Wiki i co zmienia względem RAG?

Metoda LLM Wiki pochodzi z notatki, którą Andrej Karpathy opublikował w kwietniu 2026 roku¹. Punkt wyjścia jest prosty: w typowym RAG model przy każdym pytaniu od nowa wyszukuje fragmenty surowych dokumentów i składa odpowiedź. Nic się nie odkłada. Pytanie zadane po raz dziesiąty kosztuje tyle samo pracy co pierwsze.

Karpathy proponuje odwrócenie: agent przyrostowo buduje i utrzymuje trwałą wiki, czyli zbiór połączonych stron markdown, który stoi między człowiekiem a surowymi źródłami. Nowe źródło nie trafia do indeksu "na później". Agent je czyta, wyciąga kluczowe informacje i wciela w strony, które już istnieją. Powiązania są gotowe, sprzeczności oznaczone, a synteza odzwierciedla wszystko, co do tej pory przeczytano.

Jak trzy skille dzielą między siebie pracę?

Karpathy opisuje trzy operacje: ingest (wcielenie źródła), query (pytanie) i lint (przegląd zdrowia). W pluginie Monolynx każda ma swój skill, a czwarty, wiki-init, zakłada strukturę. Zapisy do wiki skille wykonują z brancha integracyjnego, czyli głównego albo brancha sprintu. Na innym branchu pytają o zgodę.

# raz na projekt: włącz metodę i załóż strony systemowe
/monolynx:wiki-init

# przy każdym nowym źródle: plik, adres albo temat
/monolynx:wiki-ingest docs/adr/0007-kolejka-zadan.md

# okresowo: audyt zdrowia wiki
/monolynx:wiki-lint

flowchart TD
  A[wiki-init] --> B[wiki-schema, wiki-index, wiki-log]
  B --> C[Nowe źródło]
  C --> D[wiki-ingest]
  D --> E[Strony encji, konceptów i źródeł]
  E --> F[search: pytanie i synteza]
  F -->|dobra odpowiedź| E
  E --> G[wiki-lint]
  G -->|naprawy po zgodzie| E
  D --> H[wiki-log]
  F --> H
  G --> H

Co robi wiki-init?

Skill wiki-init to jednorazowy bootstrap. Najpierw czyta konfigurację wiki projektu. Gdy metoda jest już włączona, pyta, czy odświeżyć strukturę, czy przerwać. Potem woła jedno narzędzie, bootstrap_wiki_llm, które zakłada trzy strony systemowe, ustawia flagę projektu i kataloguje strony, które w wiki już były.

wiki-schema

regulamin metody: typy stron, format, zasady linkowania i obsługi sprzeczności. Zwykła, edytowalna strona.

wiki-index

katalog wszystkich stron z jednozdaniowym streszczeniem, generowany automatycznie.

wiki-log

chronologiczny dziennik operacji INGEST, QUERY i LINT, do którego wpisy są tylko dopisywane.

U Karpathy'ego te trzy role pełnią pliki: schemat w CLAUDE.md albo AGENTS.md, index.md i log.md. W Monolynx są to strony wiki, więc regulamin edytuje się tak samo jak każdą inną stronę, a agent czyta go przed każdym wcieleniem źródła.

Jak wiki-ingest wciela źródło w wiki?

Źródłem dla wiki-ingest może być plik, adres albo temat opisany słowami. Źródłem bywają też logi pracy agentów: komenda /monolynx:sprint-end na koniec sprintu przekazuje do wiki-ingest logi pipeline'ów tego sprintu. Skill nie kopiuje treści do nowej strony. Rozkłada ją na informacje i dopisuje je tam, gdzie pasują.

1. Sprawdź, czy metoda jest włączona

   Bez flagi projektu skill kończy pracę i odsyła do wiki-init.

2. Ustal źródło

   Przeczytaj plik, pobierz adres albo zbierz materiał na zadany temat.

3. Przeczytaj regulamin

   Strona wiki-schema jest wiążąca: typy stron, frontmatter, linki, marker sprzeczności.

4. Przeczytaj źródło i omów je z człowiekiem

   Kluczowe wnioski padają w rozmowie, zanim cokolwiek zostanie zapisane.

5. Znajdź istniejące strony

   Wyszukiwanie semantyczne, lista stron i linki przychodzące wskazują, co już jest w wiki.

6. Zapisz stronę źródła i zaktualizuj strony tematów

   Nowa wiedza trafia do istniejących stron encji i konceptów, a nowe strony powstają tylko dla tematów, których brak.

7. Wygeneruj indeks na nowo

   Katalog odzwierciedla stan po zmianach.

8. Dopisz wpis do dziennika

   Jedna linia z prefiksem INGEST mówi, co i dlaczego się zmieniło.

Jak wygląda strona pisana według regulaminu?

Każda strona zaczyna się od frontmatteru, a pierwsza linia treści jest streszczeniem, które trafia do indeksu. Powiązania zapisuje się wikilinkami, czyli slugiem strony w podwójnych nawiasach kwadratowych.

---
type: koncept
status: aktywna
ostatni_przeglad: 2026-10-08
tagi: [architektura, worker]
---

Kolejka zadań przenosi długie operacje z żądania HTTP do procesu w tle.

Zadania wykonuje osobny [[worker-monitoringu]], a decyzję o wyborze
rozwiązania opisuje [[zrodlo-adr-0007-kolejka-zadan]].

Pole type przyjmuje jedną z czterech wartości: encja, koncept, źródło, synteza. Pole status to aktywna, szkic albo przestarzała.

Co się dzieje, gdy źródło przeczy temu, co już jest w wiki?

Agent nie rozstrzyga sporu sam i niczego po cichu nie nadpisuje. Zostawia starą treść, dopisuje nową i oznacza miejsce markerem z datą:

> **Sprzeczność [2026-10-08]:** ADR-0007 podaje limit 3 ponowień zadania,
> a strona [[worker-monitoringu]] mówi o 5. Do rozstrzygnięcia.

Co sprawdza wiki-lint?

Skill wiki-lint to przegląd zdrowia wiki. Woła narzędzie lint_wiki i układa wynik w raport z czterema sekcjami.

Strony generowane maszynowo, na przykład logi pipeline'ów, są pomijane przy szukaniu sierot i raportowane osobno jako skipped_generated. Nikt nie oczekuje, że do logu jednego zadania będzie prowadzić link z innej strony.

Po raporcie skill proponuje naprawy i pyta, które wykonać. Sprzeczności zawsze wracają do człowieka. Na koniec dopisuje do dziennika wpis z prefiksem LINT.

Gdzie w tym wszystkim jest operacja QUERY?

Trzecia operacja metody, pytanie, nie ma osobnego skilla o nazwie wiki-query. Obsługuje ją /monolynx:search. Gdy metoda jest włączona, a odpowiedź okazała się dobrą syntezą, skill proponuje zapisanie jej w wiki jako strony typu synteza i po zgodzie dopisuje do dziennika wpis z prefiksem QUERY.

Tak domyka się pętla, o którą chodzi Karpathy'emu: eksploracja nie ginie w historii czatu, tylko zostaje w bazie wiedzy i jest gotowa na następne pytanie.

Drugi punkt styku to koniec sprintu. Skill sprint-end, który zamyka sprint i aktualizuje wiki, wciela w wiki to, co zespół zbudował, i na tym samym przebiegu sprawdza jej stan. Wiedza z kodu dopływa więc do wiki bez ręcznego pilnowania, a tickety realizowane przez skill work, który prowadzi ticket od planu do merge requesta, mają z czego czytać kontekst.

Najczęstsze pytania

Słownik i następny krok

INGEST

wcielenie źródła: strona źródła, aktualizacja stron tematów, indeks i wpis w dzienniku

QUERY

pytanie do wiki, po którym dobra synteza wraca do wiki jako nowa strona

LINT

okresowy audyt: sieroty, martwe linki, sprzeczności i luki

Encja

strona o konkretnej rzeczy: module, usłudze, osobie, narzędziu

Koncept

strona o pojęciu albo wzorcu, który przewija się przez wiele źródeł

Wikilink

odnośnik do innej strony zapisany jej slugiem w podwójnych nawiasach kwadratowych

Sierota

strona, do której nie prowadzi żaden link