notion-schema.md

distiller/notion-schema.md

1. # The `better-memory` Notion database
3. One database, written only by the nightly distiller, read by any Claude that has the
4. Notion connector. Each page is one entity; the typed Relations in page bodies make the
5. database a small knowledge graph.
7. ## Properties
9. | Property | Type | Notes |
10. |---|---|---|
11. | `Title` | title | The entity's name, in Title Case. **The match key for idempotent upserts:** one page per title, updated in place. |
12. | `Type` | select | `person`, `anchor`, `thread`, `context` or `note` (below). |
13. | `Distilled` | date | The run date that last wrote the page. |
14. | `Derived from` | text | Short tags naming what the page was built from. |
15. | `Tags` | multi-select | Lowercase topic tags. Seed the vocabulary before the first run, or writes that use a new tag can fail. |
17. ### Type
19. | Type | Meaning |
20. |---|---|
21. | `person` | A real human in the owner's life. |
22. | `anchor` | A foundational, identity-shaping entity others refer back to. |
23. | `thread` | An active, time-bound initiative with a goal. |
24. | `context` | A setting or environment that frames other work. |
25. | `note` | The catch-all: a creative work, a tool, a concept. |
27. ## Page body
29. 1. **A recall paragraph**, two to four sentences, answering "what would you need to
30. know to discuss this usefully." Self-contained; it often answers the question alone.
31. 2. **`## Observations`**, one fact per bullet as `- [category] fact`. Categories:
32. `context`, `goal`, `constraint`, `decision`, `pattern`, `preference`, `question`,
33. `blocker`, `status`, `lesson`.
34. 3. **`## Relations`**, one edge per bullet as `- relation_type -> Entity Title`, where
35. the target is another page's exact Title. Types: `part_of`, `works_on`, `maintains`,
36. `collaborates_with`, `depends_on`, `relates_to`.
38. See [`examples/distilled-entity.md`](../examples/distilled-entity.md).