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:

  1. 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.
  2. 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-check i promoter-route utrzymują dwa przejścia czysto rozdzielone i testowalne.
  • Subagenci mogą uruchamiać bouncer-check ró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