# PKM Vocabulary — README I turned the concepts, terms, definitions, and relationships in my Obsidian *Ideaverse* vault into a PKM Vocabulary that my tools (apps, services, scripts, agents, and AI) can read. I would love eyes on it during this early stage, and any feedback or suggestions would be appreciated. Term proposals or changes, bug reports, and feature ideas are all welcome. - [New concept](https://github.com/dpw67/pkm/issues/new?template=term_proposal.yml) → Propose a term - [Change existing concept](https://github.com/dpw67/pkm/issues/new?template=term_change.yml) → Propose a change - [Bug](https://github.com/dpw67/pkm/issues/new?template=bug_report.yml) → Report a bug - [Feature](https://github.com/dpw67/pkm/issues/new?template=feature_request.yml) → Request a feature You can view issues or discussions: - [Issues](https://github.com/dpw67/pkm/issues) → Browse issues first - [Discussions](https://github.com/dpw67/pkm/discussions) → View discussions (announcements and Q&A) Some of what's in there will look familiar: Ideaverse, Spark, Effort Cluster, ACE Organization, ARC Ideation, and Idea Emergence. Some of it is mine and probably idiosyncratic — diabetes health notes, recipes and meal planning, and Swift app intents for Shortcut actions, Siri AI and voice interface, Spotlight Search. The three open questions at the bottom are where I'm genuinely uncertain. Everything else feels solid, but I'm probably missing a whole layer. Nothing is deleted when I change my mind — a retired term stays resolvable and points at whatever replaced it — so it's safe to link to even now. What I'd genuinely like feedback on: 1. **Should the time periods nest, or sit side by side?** - Right now Day, Week, Month, Quarter, Year and Decade are all siblings under Calendar — the only nesting is that a Day is also part of a Week. I keep going back and forth. - A Day genuinely is part of a Week which is part of a Month, but when I nest them the tree gets deep and the notes at each level don't actually inherit anything from the level above. Curious how others see it. 1. **Are the names right?** - I went back and forth on "Cluster" for a dozen notes that belong to one day. Is there better language for that? 1. **What's obviously missing?** - There's a whole layer of LYT practice — MOCs, home notes, maps, bases, workflows — that I haven't modeled at all yet, mostly because I wasn't sure whether they're *terms* or *techniques*. Browse it here: https://w3id.org/pkm/vocab — the hierarchy view is probably the fastest way in, and every term links to its own page. I'm also writing up the thinking behind it, and keeping working notes as I go: - Blog: [Three Places for One PKM Vocabulary](https://blog.warrenweb.net/three-places-for-one-pkm-vocabulary) - Notes: [PKM Vocabulary](https://notes.warrenweb.net/pkm/vocab) Pick at it. Tell me what's wrong with it. That's what a draft version is for. --- #vocab/meta · created 2026-08-23 · modified 2026-09-09