1.4 KiB
1.4 KiB
Knowledge artifacts are category files + provenance + sha256 ledger + digest regeneration
0. The one-glance directory layout
~/.manual_slop/knowledge/
├── facts.md # - {statement} {provenance}
├── decisions.md # - {statement, reason} {provenance}
├── questions.md # - {question} {provenance}
├── playbooks.md # - **{name}**: {steps} {provenance}
├── tasks.md # ## Open / ## Done
├── files/
│ └── {file_id}.md # per-file notes (keyed by inode)
├── digest.md # bounded 4KB; the projection; "delete to turn off"
├── ledger.json # sha256-of-content audit log
└── prompts/
└── harvest-conversation.md # user-editable harvest prompt
1. The category files (the source of truth)
1.1 facts.md (durable statements)
# Facts
- The MCP dispatch uses a flat if/elif chain. 4 places, 45 tools. [from: 2026-05-12-investigate-dispatch, 2026-05-12]
- ai_client.py has 5 separate per-provider history lists, each with their own lock. Switching providers mid-session loses history. [from: 2026-05-13-state-mutation-matrix, 2026-05-13]
- RAG is opt-in. Default-off in new projects. [from: 2026-06-12-rag-discipline, 2026-06-12]
The shape: - {statement} {provenance}. Plain markdown. Append-only. User-editable.