diff --git a/docs/prose-knowledge-target.md b/docs/prose-knowledge-target.md new file mode 100644 index 0000000..17d2f58 --- /dev/null +++ b/docs/prose-knowledge-target.md @@ -0,0 +1,470 @@ +# Prose knowledge: target + +Serves `eureka-body:follow_up:prose-knowledge-inventory` under operator ruling +`eureka-body:ruling:prose-knowledge-into-mind` (2026-10-10). The operator's +words are in the ruling; read them there. Written 2026-10-10 by Imagination +(`imagination-prose-knowledge`, session `self-2026-10-10-eureka`). + +Inputs, read this pass: + +- Census: `gamecult-ops/docs/research/prose-knowledge-census-2026-10-10.md` + (82 of 2,872 in-scope files opened; cited below as "census §n"). +- Prior art: `gamecult-ops/docs/research/agent-knowledge-store-prior-art.md` + (cited as "PA §n" or "PA failure n"; its [V] and [M] tags are carried, and + every [M] claim this target relies on is flagged where it is used). +- The mind's kinds: `~/.claude/skills/eureka/references/campaign-state.md`. + +This is a target and a backlog. It is not a migration plan and changes no code. + +## 1. Pre-implementation statement + +- **Objective.** Rulings, questions, owed work and ideas that live in prose + become findable by any agent of the collective mind, and nothing that decides + a campaign lives in two places. +- **Current mechanism.** The mind holds 13 kinds of typed pipeline documents + (3,344 documents at `whoami` this pass). Everything else is `.md` files in + three places with different reach: committed repo docs, which voidbot indexes + (§4); loose files at `F:\Projects\` root and in worktrees, which nothing + indexes (census §3.1); and Claude Code memory directories, which load only + into sessions whose working directory matches (census §1). +- **Invariants.** + - `one-home`: a ruling, question, owed item or fact lives in exactly one + place. Every other place carries a pointer (a mind id or a path and line), + never a restatement. + - `operator-words-typed`: an operator ruling that steers work is a `ruling` + document carrying the operator's words. Self admits it; no other faculty + admits rulings. + - `prose-is-retrievable`: prose that stays prose is reachable by one search + path that returns the repo, path and line range. + - `no-bulk-extraction`: no unattended extraction pass writes into the mind. + Each item is read, checked against the mind and admitted by a faculty. +- **Intended change.** Ownership becomes simpler: typed kinds own decisions and + owed work; prose owns explanation. Root files and memory files stop being + owners. +- **Cut line.** Root `F:\Projects\*.md` files as a place where knowledge lives; + handoff next-action lists as a store of owed work; memory files as a store of + operator rulings. +- **Subtraction budget.** No new index, store, service or daemon. One new kind + only, the one already owed (`observation`, §2.6). Retrieval reuses voidbot's + existing index; coverage is bought by moving files into indexed repos, not by + indexing more places. + +## 2. The model page + +One row per class the census found. "Kind" names an existing pipeline kind, a +kind earned under the doctrine's bar (owner, live consumer, invariant, liability +replaced), or "prose, retrievable". + +| Class | Identity | Lifecycle | Authority | Home | +|---|---|---|---|---| +| Operator rulings and decisions | `:ruling: