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ą:

  1. Schematy typów są jawne. Każdy typ encji ma ustalony zbiór opcjonalnych pól. osoba ma rola, organizacja, relacja, ostatni-kontakt. firma ma branża, etap, status-relacji. Agent wypełnia je z języka naturalnego; użytkownik nigdy nie pisze do pola.
  2. Wikilinki są pierwszoklasowe. Każde wzmiankowanie encji w jakiejkolwiek notatce staje się [[wikilinkiem]]. Backlinki są obliczane i pokazywane na stronie encji.
  3. 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-field egzekwują 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