Pytania i zarządzanie

Cel tej lekcji: pytać bazę (nie czat) i utrzymywać jakość. Po lekcji umiesz /qa, /lint, /reindex i rozróżniasz qa vs research.

Onboarding (L2) i ingest (L3) masz za sobą - baza żyje. Teraz ją używasz: pytasz i pilnujesz jakości. Wszystkie komendy siedzą w .claude/commands/.

/qa - pytaj bazę, nie czat

/qa "twoje pytanie" to sedno. Agent nie zgaduje - czyta bazę przez progressive disclosure: vault-map → catalog → graph → otwiera tylko trafne noty → syntetyzuje odpowiedź z [[cytowaniami]] i oznacza luki, gdzie baza milczy.

Różnicę wobec czatu najlepiej widać, gdy pytasz o coś, czego w bazie nie ma. Zapytaj /qa OKF na bazie o samych notatkach o notowaniu:

Baza sprawdza wszystkie noty, widzi zero pokrycia i mówi wprost: „nie zmyślam odpowiedzi". Zamiast halucynacji dostajesz uczciwe „nie mam" + co dalej (/ingest, web research, /gaps). Czat zgaduje; baza cytuje albo przyznaje, że nie wie.

Teraz to samo dla tematu, który jest w bazie - /qa o Zettelkasten:

Dostajesz syntezę z cytowaniami ([[Zettelkasten]], [[Wikilinks Explained]], [[Example Note]]), listę luk (czego bazie brakuje) i trzy follow-upy: zapis do _outputs/answers/, /compile, /enhance. Odpowiedź jest osadzona w Twojej wiedzy, nie w treningu modelu.

/compile i /enhance - z odpowiedzi w trwałą notę

/qa daje odpowiedź; te dwie komendy zamieniają ją w trwały kawałek bazy:

• /compile <temat> - składa nową notę zbiorczą / artykuł z wielu istniejących not (synteza wyższego rzędu). Dobre, gdy materiał jest rozsypany po notach i chcesz go spiąć w jedno.
• /enhance <nota> - poprawia/rozbudowuje jedną notę: dokłada sekcje, wikilinki, łata luki wskazane przez /qa lub /lint.

W skrócie: /compile tworzy syntezę z wielu źródeł, /enhance ulepsza pojedynczą notę.

/lint - przegląd stanu

Baza po cichu gnije: martwe linki, sieroty, niespójne tagi, przeterminowane noty. /lint to audyt - sprawdza 10 klas problemów i zapisuje raport do _outputs/reports/.

Zaczyna, jak każda operacja, od indeksów (progressive disclosure - nie skanuje całości na ślepo):

Potem raportuje znaleziska po klasach - tu baza zdrowa, 3 drobne znaleziska:

Raport ląduje jako nota w _outputs/reports/, z tabelą wszystkich 10 klas i licznikiem:

Co sprawdza (10 klas): brakujący/niepełny frontmatter · zepsute wikilinki · sieroty · stuby · niespójne tagi · #todo · brak summary · brakujące połączenia semantyczne · treść stale (>1 rok bez review) · zgodność type z CLAUDE.md. Na koniec proponuje naprawę (tu: martwe linki → /reindex, brakujący link → /enhance). Odpalaj co jakiś czas - inaczej problemy się kumulują.

/reindex - przebuduj indeksy

Gdy indeksy się rozjadą (ręczna edycja, przerwany ingest), /reindex buduje je od zera z not: vault-map.md, catalog.md, graph.md.

To deterministyczna przebudowa: odtwarza indeksy z aktualnego stanu not i sprawdza liczby (total_notes, węzły, krawędzie). Ważne: jeśli problem siedzi w skrypcie (np. parser policzył [[...]] ze środka bloku kodu jako realny link), reindex go nie naprawi - wiernie odtworzy ten sam wynik. Wtedy poprawka idzie do skryptu, nie do danych. Reindex leczy rozjazd indeks↔noty, nie błędy parsera.

qa vs research - czemu osobno

/qa odpowiada z tego, co już masz. Skille research dokładają nową wiedzę z zewnątrz i odkładają ją do bazy: /research (ukierunkowany), /research-deep (wieloźródłowy + weryfikacja), /research-report (research + raport), /research-add-fields|items (rozszerzanie list). Sedno: qa = czytasz bazę; research = baza rośnie.

Pełna ściąga komend

Zasady jakości

• index-first / progressive disclosure (start od vault-map, nie skanuj całości),
• frontmatter z type (OKF, przenośność),
• aktualizuj indeksy po każdym zapisie,
• zgodność z OKF (git clone → masz),
• oczyść przed dzieleniem (usuń wrażliwe dane + atrybucje).

Anty-wzorce

Ręczne pisanie wiki · wrzucanie wszystkiego bez ingestu · olewanie /lint · skanowanie całego content/ zamiast indeksów (pali tokeny).

FAQ

Czym /qa różni się od zwykłego zapytania czatu?

Czat odpowiada z treningu modelu i zgaduje. /qa czyta Twoją bazę (index-first: vault-map → catalog → graph → trafne noty), syntetyzuje odpowiedź z [[cytowaniami]] i oznacza luki, gdzie baza milczy. Dostajesz odpowiedź osadzoną w Twojej wiedzy, z możliwością sprawdzenia źródeł.

Co, gdy zapytam /qa o coś, czego nie ma w bazie?

Zamiast halucynować, baza raportuje zero pokrycia i mówi wprost: „nie zmyślam odpowiedzi". Dostajesz uczciwe „nie mam tego" plus co dalej: /ingest nowego źródła, research z sieci albo /gaps. To kluczowa różnica: czat zgaduje, baza cytuje albo przyznaje, że nie wie.

/compile vs /enhance - kiedy którego użyć?

/compile <temat> składa nową notę zbiorczą / artykuł z wielu istniejących not - synteza wyższego rzędu, gdy materiał jest rozsypany. /enhance <nota> poprawia jedną notę: dokłada sekcje, wikilinki, łata luki wskazane przez /qa lub /lint. Skrótowo: compile tworzy z wielu źródeł, enhance ulepsza pojedynczą notę.

Jak często odpalać /lint?

Co jakiś czas - baza po cichu gnije (martwe linki, sieroty, niespójne tagi, przeterminowane noty), a problemy się kumulują. /lint sprawdza 10 klas problemów i zapisuje raport do _outputs/reports/ wraz z propozycją naprawy. Traktuj to jak okresowy przegląd stanu.

/reindex naprawi każdy problem z indeksami?

Nie. To deterministyczna przebudowa - odtwarza vault-map.md, catalog.md, graph.md z aktualnego stanu not. Leczy rozjazd indeks↔noty (ręczna edycja, przerwany ingest), ale jeśli błąd siedzi w skrypcie (np. parser liczy [[...]] ze środka bloku kodu), reindex go nie naprawi - wiernie odtworzy ten sam wynik. Wtedy poprawka idzie do skryptu, nie do danych.

Czym /qa różni się od skilli research?

/qa odpowiada z tego, co już masz w bazie. Skille research dokładają nową wiedzę z zewnątrz i odkładają ją do bazy. Sedno: qa = czytasz bazę, research = baza rośnie. Więcej o research w kolejnej lekcji.