Principle
Bramka jakości Bramkarz–Promotor
Dwuprzejściowy filtr — najpierw zdecyduj, czy to w ogóle tu należy, potem zdecyduj, dokąd trafi.
Najszybszym sposobem na zepsucie KMS-u jest wpuszczanie wszystkiego. Drugim najszybszym jest kazanie użytkownikowi decydować, co tu należy. Wzorzec bramkarz–promotor jest rozwiązaniem: dwa odrębne filtry, stosowane po kolei, żaden z nich nie jest na barkach użytkownika.
Zasada
Dwa przejścia na każdym przychodzącym kawałku materiału:
- Bramkarz — czy to w ogóle tu należy? Odrzuć duplikaty, szum o niskim sygnale, stan przejściowy, rzeczy już pokryte. Większość tego, co trafia do skrzynki, nie przeżywa tej bramki.
- Promotor — dokąd trafia ocalały materiał? Kieruje zatwierdzone przez bramkarza wejście do właściwego typu, pliku i linków.
Dwa przejścia, nie jedno. Mieszanie ich produkuje system, który albo wpuszcza za dużo (gdy bramka jest pobłażliwa co do jakości, bo jest zajęta myśleniem o miejscu docelowym), albo odrzuca za dużo (gdy bramka jest surowa co do miejsca docelowego, bo jest zajęta myśleniem o jakości).
Dlaczego to ma znaczenie
Bez bramkarza KMS staje się szufladą z gratami. Nawet dobrze skategoryzowana szuflada z gratami to dalej szuflada z gratami — każde wyszukiwanie zwraca pięć wyników, z których cztery to szum z okresu, kiedy zapomniałeś posprzątać.
Koszt wpuszczenia szumu nosi się zawsze (każde przyszłe wyszukiwanie brodzi w nim). Koszt odrzucenia ponosi się raz (użytkownik widzi ślad „pominąłem to, bo…" i może to nadpisać). Ta asymetria sprawia, że surowy bramkarz jest wart tarcia, jakie wnosi.
Jak to działa
Bramkarz stosuje mały zbiór jawnych reguł, wpisanych w CLAUDE.md lub w umiejętność:
- Już pokryte? Poszukaj istniejących wpisów na ten temat. Jeśli istnieje silniejsza wersja, odrzuć i zalinkuj.
- Treściwe? Czy to zapewnia fakt, decyzję, obserwację lub wzorzec — czy jest to szum fatyczny?
- Stabilne? Czy to wiedza (trwała), czy stan (przejściowy)? Stan idzie do innej warstwy.
- Ze źródłem? Dla zewnętrznych twierdzeń: czy jest źródło? Bezźródłowe asercje są flagowane.
To, co przeżyje bramkarza, dostaje pełne traktowanie promotora: zostaje otypowane, polinkowane, streszczone, wyniesione tam, gdzie jest istotne.
W prymitywach Claude
- Umiejętności jak
bouncer-checkipromoter-routeutrzymują dwa przejścia czysto rozdzielone i testowalne. - Subagenci mogą uruchamiać
bouncer-checkrównolegle na partii elementów ze skrzynki, zwracając werdykt + powód. - Hooki (PreToolUse na umiejętnościach zapisu plików) mogą egzekwować, że nic nie zostanie zapisane bez zgody bramkarza.
- CLAUDE.md trzyma reguły bramkarza — krótkie, jawne, łatwe do rewizji.
Gdzie to widziałem
Wzorzec nazwany jest po aplikacyjnym KMS-ie „drugi mózg", gdzie bramkarz/promotor są pierwszoklasowymi pojęciami w potoku przyjmowania. Ten sam wzorzec (pod innymi nazwami) biegnie w moim osobistym KMS-ie w przepływie importu sesji oraz w zespołowym KMS-ie w triażu sygnałów od klientów.
Czytanie pod prąd
Surowi bramkarze odrzucają rzeczy, których później żałujesz. Transakcja jest realna. Wartość domyślna powinna jednak pozostać surowa — odzyskanie odrzuconego elementu z archiwum skrzynki kosztuje mniej niż życie z zanieczyszczonym magazynem wiedzy.
Related principles
Rev. 2026-04-18