PKC: Capture, Curate, Disclose

PKC: Capture, Curate, Disclose An architecture diagram generated by Archify. Capture inputs · transcript, PR, thread, ADR · Architecture component Capture inputs transcript, PR, thread, ADR pkc_capture.py · meeting, experiment, discovery · Isolated write session: brain/<actor>/<session-id> pkc_capture.py meeting, experiment, discovery pkc_materialize.py · worklog fold to TicketLink · Isolated write session: brain/<actor>/<session-id> pkc_materialize.py worklog fold to TicketLink knowledge/ catalogs · 26 owned nouns, one file each · Architecture component · Git is truth knowledge/ catalogs 26 owned nouns, one file each Git is truth hooks.json · auto-context + curate · Architecture component hooks.json auto-context + curate pkc_index.py · SQLite FTS5, incremental · Architecture component · gitignored pkc_index.py SQLite FTS5, incremental gitignored pkc_pack.py · 2 hops, neighbor bodies off · Architecture component · fail-closed budget pkc_pack.py 2 hops, neighbor bodies off fail-closed budget Federated roots · sibling knowledge trees · Architecture component · read-only Federated roots sibling knowledge trees read-only paste or export typed concepts TicketLink mtime + size sweep candidate paths tiny 1-hop pack read-only search Isolated write session: brain/<actor>/<session-id> Legend Backend Database Security External

PKC owns the why

  • • Meeting, Experiment, Discovery, Assumption, and Question capture reasoning
  • • Feature, Requirement, Design, and Release carry the product story

Hooks stay quiet

  • • UserPromptSubmit is the only hook that runs before the turn
  • • It fires only on a features/ path that exists or a ULID that resolves to a Feature

The budget fails closed

  • • Default budget is one quarter of SECOND_BRAIN_WINDOW_TOKENS
  • • An over-budget pack refuses to write rather than truncating silently