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. Bramkarzczy 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. Promotordoką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