Principle
Wzorzec kontekstu encji
Ustrukturyzowane fakty o realnych rzeczach, nie płaskie notatki klucz-wartość.
Najmniejszą jednostką użytecznej wiedzy rzadko jest zdanie. To fakt o encji — osoba, firma, projekt, koncepcja, źródło. KMS, który przechowuje wyłącznie zdania (notatki, posty, wycinki), pomija strukturalny kręgosłup, który sprawia, że wiedza daje się odpytywać.
Zasada
Każda trwała rzecz w świecie, o której system rozumuje, jest encją z:
- stabilnym slugiem
- otypowaną stroną (osoba, firma, projekt, koncepcja, źródło, decyzja)
- małym zbiorem pól strukturalnych (rola, status, relacje)
- sekcją wolnych notatek
- jawnymi linkami do innych encji
Notatki są doczepiane do encji, a nie odwrotnie. „Spotkanie z Samem" to notatka na encji sam, a nie samodzielny log.
Dlaczego to ma znaczenie
Płaskich notatek nie da się odpytywać. „Co wiem o Samie?" zwraca wynik wyszukiwania; „co wiemy o odnowieniu tego klienta?" zwraca wynik wyszukiwania. Wynik wyszukiwania to nie wiedza — to lista miejsc, w których występuje dany ciąg znaków.
Wiedza otypowana na encjach daje się komponować. „Co wiem o Samie?" zwraca jedną stronę, która zbiera fakty, świeże notatki ze spotkań, powiązane encje i nierozwiązane pytania — złożone z wielu źródeł, ale prezentowane jako jedno. To jest różnica między znajdowaniem informacji a czytaniem tego, co system wie.
Jak to działa
Trzy rzeczy muszą być prawdą:
- Schematy typów są jawne. Każdy typ encji ma ustalony zbiór opcjonalnych pól.
osobamarola,organizacja,relacja,ostatni-kontakt.firmamabranża,etap,status-relacji. Agent wypełnia je z języka naturalnego; użytkownik nigdy nie pisze do pola. - Wikilinki są pierwszoklasowe. Każde wzmiankowanie encji w jakiejkolwiek notatce staje się
[[wikilinkiem]]. Backlinki są obliczane i pokazywane na stronie encji. - Strona encji jest widokiem, nie plikiem. Strona renderuje pola strukturalne, najnowsze notatki, backlinki i wszelkie wyprowadzone fakty (np. „ostatni kontakt 14 dni temu"). Edycje idą do leżącej pod spodem notatki, która wspomniała o encji, a nie do samej strony.
W prymitywach Claude
- Umiejętności jak
find-or-create-entity,add-note-to-entity,update-entity-fieldegzekwują ten wzorzec. - CLAUDE.md niesie schemat typów encji — „osoba ma te pola; nigdy nie wymyślaj nowych typów bez ADR".
- Sonnet/Opus z długim kontekstem może wczytać całą stronę encji (notatki + backlinki) do okna roboczego, gdy encja zostanie wspomniana.
Gdzie to widziałem
Aplikacyjny KMS do BD, z którym pracuję, używa tego wzorca wprost dla encji deali. Mój osobisty KMS używa go do osób, projektów, koncepcji. Zespołowy KMS, który zbudowaliśmy, używa go z uprawnieniami opartymi na rolach nałożonymi na wierzchu. Kontrast jest pouczający: każdy system, który odpłynął od kontekstu encji, odpływał w stronę płaskich zbiorów notatek, a każdy płaski zbiór notatek stawał się nieużyteczny powyżej ~500 notatek.
Czytanie pod prąd
Czuje się to jak myślenie bazodanowe zastosowane do notatnika. Jest nim. O to chodzi — większość pracy z wiedzą jest pracą bazodanową w przebraniu, a udawanie inaczej pogarsza system.
Related principles
Rev. 2026-04-18