arscontexta 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (418) hide show
  1. package/.claude-plugin/marketplace.json +11 -0
  2. package/.claude-plugin/plugin.json +22 -0
  3. package/README.md +683 -0
  4. package/agents/knowledge-guide.md +49 -0
  5. package/bin/cli.mjs +66 -0
  6. package/generators/agents-md.md +240 -0
  7. package/generators/claude-md.md +379 -0
  8. package/generators/features/atomic-notes.md +124 -0
  9. package/generators/features/ethical-guardrails.md +58 -0
  10. package/generators/features/graph-analysis.md +188 -0
  11. package/generators/features/helper-functions.md +92 -0
  12. package/generators/features/maintenance.md +164 -0
  13. package/generators/features/methodology-knowledge.md +70 -0
  14. package/generators/features/mocs.md +144 -0
  15. package/generators/features/multi-domain.md +61 -0
  16. package/generators/features/personality.md +71 -0
  17. package/generators/features/processing-pipeline.md +428 -0
  18. package/generators/features/schema.md +149 -0
  19. package/generators/features/self-evolution.md +229 -0
  20. package/generators/features/self-space.md +78 -0
  21. package/generators/features/semantic-search.md +99 -0
  22. package/generators/features/session-rhythm.md +85 -0
  23. package/generators/features/templates.md +85 -0
  24. package/generators/features/wiki-links.md +88 -0
  25. package/generators/soul-md.md +121 -0
  26. package/hooks/hooks.json +45 -0
  27. package/hooks/scripts/auto-commit.sh +44 -0
  28. package/hooks/scripts/session-capture.sh +35 -0
  29. package/hooks/scripts/session-orient.sh +86 -0
  30. package/hooks/scripts/write-validate.sh +42 -0
  31. package/methodology/AI shifts knowledge systems from externalizing memory to externalizing attention.md +59 -0
  32. package/methodology/BM25 retrieval fails on full-length descriptions because query term dilution reduces match scores.md +39 -0
  33. package/methodology/IBIS framework maps claim-based architecture to structured argumentation.md +58 -0
  34. package/methodology/LLM attention degrades as context fills.md +49 -0
  35. package/methodology/MOC construction forces synthesis that automated generation from metadata cannot replicate.md +49 -0
  36. package/methodology/MOC maintenance investment compounds because orientation savings multiply across every future session.md +41 -0
  37. package/methodology/MOCs are attention management devices not just organizational tools.md +51 -0
  38. package/methodology/PKM failure follows a predictable cycle.md +50 -0
  39. package/methodology/ThreadMode to DocumentMode transformation is the core value creation step.md +52 -0
  40. package/methodology/WIP limits force processing over accumulation.md +53 -0
  41. package/methodology/Zeigarnik effect validates capture-first philosophy because open loops drain attention.md +42 -0
  42. package/methodology/academic research uses structured extraction with cross-source synthesis.md +566 -0
  43. package/methodology/adapt the four-phase processing pipeline to domain-specific throughput needs.md +197 -0
  44. package/methodology/agent notes externalize navigation intuition that search cannot discover and traversal cannot reconstruct.md +48 -0
  45. package/methodology/agent self-memory should be architecturally separate from user knowledge systems.md +48 -0
  46. package/methodology/agent session boundaries create natural automation checkpoints that human-operated systems lack.md +56 -0
  47. package/methodology/agent-cognition.md +107 -0
  48. package/methodology/agents are simultaneously methodology executors and subjects creating a unique trust asymmetry.md +66 -0
  49. package/methodology/aspect-oriented programming solved the same cross-cutting concern problem that hooks solve.md +39 -0
  50. package/methodology/associative ontologies beat hierarchical taxonomies because heterarchy adapts while hierarchy brittles.md +53 -0
  51. package/methodology/attention residue may have a minimum granularity that cannot be subdivided.md +46 -0
  52. package/methodology/auto-commit hooks eliminate prospective memory failures by converting remember-to-act into guaranteed execution.md +47 -0
  53. package/methodology/automated detection is always safe because it only reads state while automated remediation risks content corruption.md +42 -0
  54. package/methodology/automation should be retired when its false positive rate exceeds its true positive rate or it catches zero issues.md +56 -0
  55. package/methodology/backlinks implicitly define notes by revealing usage context.md +35 -0
  56. package/methodology/backward maintenance asks what would be different if written today.md +62 -0
  57. package/methodology/balance onboarding enforcement and questions to prevent premature complexity.md +229 -0
  58. package/methodology/basic level categorization determines optimal MOC granularity.md +51 -0
  59. package/methodology/batching by context similarity reduces switching costs in agent processing.md +43 -0
  60. package/methodology/behavioral anti-patterns matter more than tool selection.md +42 -0
  61. package/methodology/betweenness centrality identifies bridge notes connecting disparate knowledge domains.md +57 -0
  62. package/methodology/blueprints that teach construction outperform downloads that provide pre-built code for platform-dependent modules.md +42 -0
  63. package/methodology/bootstrapping principle enables self-improving systems.md +62 -0
  64. package/methodology/build automatic memory through cognitive offloading and session handoffs.md +285 -0
  65. package/methodology/capture the reaction to content not just the content itself.md +41 -0
  66. package/methodology/claims must be specific enough to be wrong.md +36 -0
  67. package/methodology/closure rituals create clean breaks that prevent attention residue bleed.md +44 -0
  68. package/methodology/cognitive offloading is the architectural foundation for vault design.md +46 -0
  69. package/methodology/cognitive outsourcing risk in agent-operated systems.md +55 -0
  70. package/methodology/coherence maintains consistency despite inconsistent inputs.md +96 -0
  71. package/methodology/coherent architecture emerges from wiki links spreading activation and small-world topology.md +48 -0
  72. package/methodology/community detection algorithms can inform when MOCs should split or merge.md +52 -0
  73. package/methodology/complete navigation requires four complementary types that no single mechanism provides.md +43 -0
  74. package/methodology/complex systems evolve from simple working systems.md +59 -0
  75. package/methodology/composable knowledge architecture builds systems from independent toggleable modules not monolithic templates.md +61 -0
  76. package/methodology/compose multi-domain systems through separate templates and shared graph.md +372 -0
  77. package/methodology/concept-orientation beats source-orientation for cross-domain connections.md +51 -0
  78. package/methodology/confidence thresholds gate automated action between the mechanical and judgment zones.md +50 -0
  79. package/methodology/configuration dimensions interact so choices in one create pressure on others.md +58 -0
  80. package/methodology/configuration paralysis emerges when derivation surfaces too many decisions.md +44 -0
  81. package/methodology/context files function as agent operating systems through self-referential self-extension.md +46 -0
  82. package/methodology/context phrase clarity determines how deep a navigation hierarchy can scale.md +46 -0
  83. package/methodology/continuous small-batch processing eliminates review dread.md +48 -0
  84. package/methodology/controlled disorder engineers serendipity through semantic rather than topical linking.md +51 -0
  85. package/methodology/creative writing uses worldbuilding consistency with character tracking.md +672 -0
  86. package/methodology/cross-links between MOC territories indicate creative leaps and integration depth.md +43 -0
  87. package/methodology/dangling links reveal which notes want to exist.md +62 -0
  88. package/methodology/data exit velocity measures how quickly content escapes vendor lock-in.md +74 -0
  89. package/methodology/decontextualization risk means atomicity may strip meaning that cannot be recovered.md +48 -0
  90. package/methodology/dense interlinked research claims enable derivation while sparse references only enable templating.md +47 -0
  91. package/methodology/dependency resolution through topological sort makes module composition transparent and verifiable.md +56 -0
  92. package/methodology/derivation generates knowledge systems from composable research claims not template customization.md +63 -0
  93. package/methodology/derivation-engine.md +27 -0
  94. package/methodology/derived systems follow a seed-evolve-reseed lifecycle.md +56 -0
  95. package/methodology/description quality for humans diverges from description quality for keyword search.md +73 -0
  96. package/methodology/descriptions are retrieval filters not summaries.md +112 -0
  97. package/methodology/design MOCs as attention management devices with lifecycle governance.md +318 -0
  98. package/methodology/design-dimensions.md +66 -0
  99. package/methodology/digital mutability enables note evolution that physical permanence forbids.md +54 -0
  100. package/methodology/discovery-retrieval.md +48 -0
  101. package/methodology/distinctiveness scoring treats description quality as measurable.md +69 -0
  102. package/methodology/does agent processing recover what fast capture loses.md +43 -0
  103. package/methodology/domain-compositions.md +37 -0
  104. package/methodology/dual-coding with visual elements could enhance agent traversal.md +55 -0
  105. package/methodology/each module must be describable in one sentence under 200 characters or it does too many things.md +45 -0
  106. package/methodology/each new note compounds value by creating traversal paths.md +55 -0
  107. package/methodology/eight configuration dimensions parameterize the space of possible knowledge systems.md +56 -0
  108. package/methodology/elaborative encoding is the quality gate for new notes.md +55 -0
  109. package/methodology/enforce schema with graduated strictness across capture processing and query zones.md +221 -0
  110. package/methodology/enforcing atomicity can create paralysis when ideas resist decomposition.md +43 -0
  111. package/methodology/engineering uses technical decision tracking with architectural memory.md +766 -0
  112. package/methodology/every knowledge domain shares a four-phase processing skeleton that diverges only in the process step.md +53 -0
  113. package/methodology/evolution observations provide actionable signals for system adaptation.md +67 -0
  114. package/methodology/external memory shapes cognition more than base model.md +60 -0
  115. package/methodology/faceted classification treats notes as multi-dimensional objects rather than folder contents.md +65 -0
  116. package/methodology/failure-modes.md +27 -0
  117. package/methodology/false universalism applies same processing logic regardless of domain.md +49 -0
  118. package/methodology/federated wiki pattern enables multi-agent divergence as feature not bug.md +59 -0
  119. package/methodology/flat files break at retrieval scale.md +75 -0
  120. package/methodology/forced engagement produces weak connections.md +48 -0
  121. package/methodology/four abstraction layers separate platform-agnostic from platform-dependent knowledge system features.md +47 -0
  122. package/methodology/fresh context per task preserves quality better than chaining phases.md +44 -0
  123. package/methodology/friction reveals architecture.md +63 -0
  124. package/methodology/friction-driven module adoption prevents configuration debt by adding complexity only at pain points.md +48 -0
  125. package/methodology/gardening cycle implements tend prune fertilize operations.md +41 -0
  126. package/methodology/generation effect gate blocks processing without transformation.md +40 -0
  127. package/methodology/goal-driven memory orchestration enables autonomous domain learning through directed compute allocation.md +41 -0
  128. package/methodology/good descriptions layer heuristic then mechanism then implication.md +57 -0
  129. package/methodology/graph-structure.md +65 -0
  130. package/methodology/guided notes might outperform post-hoc structuring for high-volume capture.md +37 -0
  131. package/methodology/health wellness uses symptom-trigger correlation with multi-dimensional tracking.md +819 -0
  132. package/methodology/hook composition creates emergent methodology from independent single-concern components.md +47 -0
  133. package/methodology/hook enforcement guarantees quality while instruction enforcement merely suggests it.md +51 -0
  134. package/methodology/hook-driven learning loops create self-improving methodology through observation accumulation.md +62 -0
  135. package/methodology/hooks are the agent habit system that replaces the missing basal ganglia.md +40 -0
  136. package/methodology/hooks cannot replace genuine cognitive engagement yet more automation is always tempting.md +87 -0
  137. package/methodology/hooks enable context window efficiency by delegating deterministic checks to external processes.md +47 -0
  138. package/methodology/idempotent maintenance operations are safe to automate because running them twice produces the same result as running them once.md +44 -0
  139. package/methodology/implement condition-based maintenance triggers for derived systems.md +255 -0
  140. package/methodology/implicit dependencies create distributed monoliths that fail silently across configurations.md +58 -0
  141. package/methodology/implicit knowledge emerges from traversal.md +55 -0
  142. package/methodology/incremental formalization happens through repeated touching of old notes.md +60 -0
  143. package/methodology/incremental reading enables cross-source connection finding.md +39 -0
  144. package/methodology/index.md +32 -0
  145. package/methodology/inline links carry richer relationship data than metadata fields.md +91 -0
  146. package/methodology/insight accretion differs from productivity in knowledge systems.md +41 -0
  147. package/methodology/intermediate packets enable assembly over creation.md +52 -0
  148. package/methodology/intermediate representation pattern enables reliable vault operations beyond regex.md +62 -0
  149. package/methodology/justification chains enable forward backward and evolution reasoning about configuration decisions.md +46 -0
  150. package/methodology/knowledge system architecture is parameterized by platform capabilities not fixed by methodology.md +51 -0
  151. package/methodology/knowledge systems become communication partners through complexity and memory humans cannot sustain.md +47 -0
  152. package/methodology/knowledge systems share universal operations and structural components across all methodology traditions.md +46 -0
  153. package/methodology/legal case management uses precedent chains with regulatory change propagation.md +892 -0
  154. package/methodology/live index via periodic regeneration keeps discovery current.md +58 -0
  155. package/methodology/local-first file formats are inherently agent-native.md +69 -0
  156. package/methodology/logic column pattern separates reasoning from procedure.md +35 -0
  157. package/methodology/maintenance operations are more universal than creative pipelines because structural health is domain-invariant.md +47 -0
  158. package/methodology/maintenance scheduling frequency should match consequence speed not detection capability.md +50 -0
  159. package/methodology/maintenance targeting should prioritize mechanism and theory notes.md +26 -0
  160. package/methodology/maintenance-patterns.md +72 -0
  161. package/methodology/markdown plus YAML plus ripgrep implements a queryable graph database without infrastructure.md +55 -0
  162. package/methodology/maturity field enables agent context prioritization.md +33 -0
  163. package/methodology/memory-architecture.md +27 -0
  164. package/methodology/metacognitive confidence can diverge from retrieval capability.md +42 -0
  165. package/methodology/metadata reduces entropy enabling precision over recall.md +91 -0
  166. package/methodology/methodology development should follow the trajectory from documentation to skill to hook as understanding hardens.md +80 -0
  167. package/methodology/methodology traditions are named points in a shared configuration space not competing paradigms.md +64 -0
  168. package/methodology/mnemonic medium embeds verification into navigation.md +46 -0
  169. package/methodology/module communication through shared YAML fields creates loose coupling without direct dependencies.md +44 -0
  170. package/methodology/module deactivation must account for structural artifacts that survive the toggle.md +49 -0
  171. package/methodology/multi-domain systems compose through separate templates and shared graph.md +61 -0
  172. package/methodology/multi-domain-composition.md +27 -0
  173. package/methodology/narrow folksonomy optimizes for single-operator retrieval unlike broad consensus tagging.md +53 -0
  174. package/methodology/navigation infrastructure passes through distinct scaling regimes that require qualitative strategy shifts.md +48 -0
  175. package/methodology/navigational vertigo emerges in pure association systems without local hierarchy.md +54 -0
  176. package/methodology/note titles should function as APIs enabling sentence transclusion.md +51 -0
  177. package/methodology/note-design.md +57 -0
  178. package/methodology/notes are skills /342/200/224 curated knowledge injected when relevant.md" +62 -0
  179. package/methodology/notes function as cognitive anchors that stabilize attention during complex tasks.md +41 -0
  180. package/methodology/novel domains derive by mapping knowledge type to closest reference domain then adapting.md +50 -0
  181. package/methodology/nudge theory explains graduated hook enforcement as choice architecture for agents.md +59 -0
  182. package/methodology/observation and tension logs function as dead-letter queues for failed automation.md +51 -0
  183. package/methodology/operational memory and knowledge memory serve different functions in agent architecture.md +48 -0
  184. package/methodology/operational wisdom requires contextual observation.md +52 -0
  185. package/methodology/orchestrated vault creation transforms arscontexta from tool to autonomous knowledge factory.md +40 -0
  186. package/methodology/organic emergence versus active curation creates a fundamental vault governance tension.md +68 -0
  187. package/methodology/orphan notes are seeds not failures.md +38 -0
  188. package/methodology/over-automation corrupts quality when hooks encode judgment rather than verification.md +62 -0
  189. package/methodology/people relationships uses Dunbar-layered graphs with interaction tracking.md +659 -0
  190. package/methodology/personal assistant uses life area management with review automation.md +610 -0
  191. package/methodology/platform adapter translation is semantic not mechanical because hook event meanings differ.md +40 -0
  192. package/methodology/platform capability tiers determine which knowledge system features can be implemented.md +48 -0
  193. package/methodology/platform fragmentation means identical conceptual operations require different implementations across agent environments.md +44 -0
  194. package/methodology/premature complexity is the most common derivation failure mode.md +45 -0
  195. package/methodology/prevent domain-specific failure modes through the vulnerability matrix.md +336 -0
  196. package/methodology/processing effort should follow retrieval demand.md +57 -0
  197. package/methodology/processing-workflows.md +75 -0
  198. package/methodology/product management uses feedback pipelines with experiment tracking.md +789 -0
  199. package/methodology/productivity porn risk in meta-system building.md +30 -0
  200. package/methodology/programmable notes could enable property-triggered workflows.md +64 -0
  201. package/methodology/progressive disclosure means reading right not reading less.md +69 -0
  202. package/methodology/progressive schema validates only what active modules require not the full system schema.md +49 -0
  203. package/methodology/project management uses decision tracking with stakeholder context.md +776 -0
  204. package/methodology/propositional link semantics transform wiki links from associative to reasoned.md +87 -0
  205. package/methodology/prospective memory requires externalization.md +53 -0
  206. package/methodology/provenance tracks where beliefs come from.md +62 -0
  207. package/methodology/queries evolve during search so agents should checkpoint.md +35 -0
  208. package/methodology/question-answer metadata enables inverted search patterns.md +39 -0
  209. package/methodology/random note resurfacing prevents write-only memory.md +33 -0
  210. package/methodology/reconciliation loops that compare desired state to actual state enable drift correction without continuous monitoring.md +59 -0
  211. package/methodology/reflection synthesizes existing notes into new insight.md +100 -0
  212. package/methodology/retrieval utility should drive design over capture completeness.md +69 -0
  213. package/methodology/retrieval verification loop tests description quality at scale.md +81 -0
  214. package/methodology/role field makes graph structure explicit.md +94 -0
  215. package/methodology/scaffolding enables divergence that fine-tuning cannot.md +67 -0
  216. package/methodology/schema enforcement via validation agents enables soft consistency.md +60 -0
  217. package/methodology/schema evolution follows observe-then-formalize not design-then-enforce.md +65 -0
  218. package/methodology/schema field names are the only domain specific element in the universal note pattern.md +46 -0
  219. package/methodology/schema fields should use domain-native vocabulary not abstract terminology.md +47 -0
  220. package/methodology/schema templates reduce cognitive overhead at capture time.md +55 -0
  221. package/methodology/schema validation hooks externalize inhibitory control that degrades under cognitive load.md +48 -0
  222. package/methodology/schema-enforcement.md +27 -0
  223. package/methodology/self-extension requires context files to contain platform operations knowledge not just methodology.md +47 -0
  224. package/methodology/sense-making vs storage does compression lose essential nuance.md +73 -0
  225. package/methodology/session boundary hooks implement cognitive bookends for orientation and reflection.md +60 -0
  226. package/methodology/session handoff creates continuity without persistent memory.md +43 -0
  227. package/methodology/session outputs are packets for future selves.md +43 -0
  228. package/methodology/session transcript mining enables experiential validation that structural tests cannot provide.md +38 -0
  229. package/methodology/skill context budgets constrain knowledge system complexity on agent platforms.md +52 -0
  230. package/methodology/skills encode methodology so manual execution bypasses quality gates.md +50 -0
  231. package/methodology/small-world topology requires hubs and dense local links.md +99 -0
  232. package/methodology/source attribution enables tracing claims to foundations.md +38 -0
  233. package/methodology/spaced repetition scheduling could optimize vault maintenance.md +44 -0
  234. package/methodology/spreading activation models how agents should traverse.md +79 -0
  235. package/methodology/stale navigation actively misleads because agents trust curated maps completely.md +43 -0
  236. package/methodology/stigmergy coordinates agents through environmental traces without direct communication.md +62 -0
  237. package/methodology/storage versus thinking distinction determines which tool patterns apply.md +56 -0
  238. package/methodology/structure enables navigation without reading everything.md +52 -0
  239. package/methodology/structure without processing provides no value.md +56 -0
  240. package/methodology/student learning uses prerequisite graphs with spaced retrieval.md +770 -0
  241. package/methodology/summary coherence tests composability before filing.md +37 -0
  242. package/methodology/tag rot applies to wiki links because titles serve as both identifier and display text.md +50 -0
  243. package/methodology/temporal media must convert to spatial text for agent traversal.md +43 -0
  244. package/methodology/temporal processing priority creates age-based inbox urgency.md +45 -0
  245. package/methodology/temporal separation of capture and processing preserves context freshness.md +39 -0
  246. package/methodology/ten universal primitives form the kernel of every viable agent knowledge system.md +162 -0
  247. package/methodology/testing effect could enable agent knowledge verification.md +38 -0
  248. package/methodology/the AgentSkills standard embodies progressive disclosure at the skill level.md +40 -0
  249. package/methodology/the derivation engine improves recursively as deployed systems generate observations.md +49 -0
  250. package/methodology/the determinism boundary separates hook methodology from skill methodology.md +46 -0
  251. package/methodology/the fix-versus-report decision depends on determinism reversibility and accumulated trust.md +45 -0
  252. package/methodology/the generation effect requires active transformation not just storage.md +57 -0
  253. package/methodology/the no wrong patches guarantee ensures any valid module combination produces a valid system.md +58 -0
  254. package/methodology/the system is the argument.md +46 -0
  255. package/methodology/the vault constitutes identity for agents.md +86 -0
  256. package/methodology/the vault methodology transfers because it encodes cognitive science not domain specifics.md +47 -0
  257. package/methodology/therapy journal uses warm personality with pattern detection for emotional processing.md +584 -0
  258. package/methodology/three capture schools converge through agent-mediated synthesis.md +55 -0
  259. package/methodology/three concurrent maintenance loops operate at different timescales to catch different classes of problems.md +56 -0
  260. package/methodology/throughput matters more than accumulation.md +58 -0
  261. package/methodology/title as claim enables traversal as reasoning.md +50 -0
  262. package/methodology/topological organization beats temporal for knowledge work.md +52 -0
  263. package/methodology/trading uses conviction tracking with thesis-outcome correlation.md +699 -0
  264. package/methodology/trails transform ephemeral navigation into persistent artifacts.md +39 -0
  265. package/methodology/transform universal vocabulary to domain-native language through six levels.md +259 -0
  266. package/methodology/type field enables structured queries without folder hierarchies.md +53 -0
  267. package/methodology/use-case presets dissolve the tension between composability and simplicity.md +44 -0
  268. package/methodology/vault conventions may impose hidden rigidity on thinking.md +44 -0
  269. package/methodology/verbatim risk applies to agents too.md +31 -0
  270. package/methodology/vibe notetaking is the emerging industry consensus for AI-native self-organization.md +56 -0
  271. package/methodology/vivid memories need verification.md +45 -0
  272. package/methodology/vocabulary-transformation.md +27 -0
  273. package/methodology/voice capture is the highest-bandwidth channel for agent-delegated knowledge systems.md +45 -0
  274. package/methodology/wiki links are the digital evolution of analog indexing.md +73 -0
  275. package/methodology/wiki links as social contract transforms agents into stewards of incomplete references.md +52 -0
  276. package/methodology/wiki links create navigation paths that shape retrieval.md +63 -0
  277. package/methodology/wiki links implement GraphRAG without the infrastructure.md +101 -0
  278. package/methodology/writing for audience blocks authentic creation.md +22 -0
  279. package/methodology/you operate a system that takes notes.md +79 -0
  280. package/openclaw/SKILL.md +110 -0
  281. package/package.json +45 -0
  282. package/platforms/README.md +51 -0
  283. package/platforms/claude-code/generator.md +61 -0
  284. package/platforms/claude-code/hooks/README.md +186 -0
  285. package/platforms/claude-code/hooks/auto-commit.sh.template +38 -0
  286. package/platforms/claude-code/hooks/session-capture.sh.template +72 -0
  287. package/platforms/claude-code/hooks/session-orient.sh.template +189 -0
  288. package/platforms/claude-code/hooks/write-validate.sh.template +106 -0
  289. package/platforms/openclaw/generator.md +82 -0
  290. package/platforms/openclaw/hooks/README.md +89 -0
  291. package/platforms/openclaw/hooks/bootstrap.ts.template +224 -0
  292. package/platforms/openclaw/hooks/command-new.ts.template +165 -0
  293. package/platforms/openclaw/hooks/heartbeat.ts.template +214 -0
  294. package/platforms/shared/features/README.md +70 -0
  295. package/platforms/shared/skill-blocks/graph.md +145 -0
  296. package/platforms/shared/skill-blocks/learn.md +119 -0
  297. package/platforms/shared/skill-blocks/next.md +131 -0
  298. package/platforms/shared/skill-blocks/pipeline.md +326 -0
  299. package/platforms/shared/skill-blocks/ralph.md +616 -0
  300. package/platforms/shared/skill-blocks/reduce.md +1142 -0
  301. package/platforms/shared/skill-blocks/refactor.md +129 -0
  302. package/platforms/shared/skill-blocks/reflect.md +780 -0
  303. package/platforms/shared/skill-blocks/remember.md +524 -0
  304. package/platforms/shared/skill-blocks/rethink.md +574 -0
  305. package/platforms/shared/skill-blocks/reweave.md +680 -0
  306. package/platforms/shared/skill-blocks/seed.md +320 -0
  307. package/platforms/shared/skill-blocks/stats.md +145 -0
  308. package/platforms/shared/skill-blocks/tasks.md +171 -0
  309. package/platforms/shared/skill-blocks/validate.md +323 -0
  310. package/platforms/shared/skill-blocks/verify.md +562 -0
  311. package/platforms/shared/templates/README.md +35 -0
  312. package/presets/experimental/categories.yaml +1 -0
  313. package/presets/experimental/preset.yaml +38 -0
  314. package/presets/experimental/starter/README.md +7 -0
  315. package/presets/experimental/vocabulary.yaml +7 -0
  316. package/presets/personal/categories.yaml +7 -0
  317. package/presets/personal/preset.yaml +41 -0
  318. package/presets/personal/starter/goals.md +21 -0
  319. package/presets/personal/starter/index.md +17 -0
  320. package/presets/personal/starter/life-areas.md +21 -0
  321. package/presets/personal/starter/people.md +21 -0
  322. package/presets/personal/vocabulary.yaml +32 -0
  323. package/presets/research/categories.yaml +8 -0
  324. package/presets/research/preset.yaml +41 -0
  325. package/presets/research/starter/index.md +17 -0
  326. package/presets/research/starter/methods.md +21 -0
  327. package/presets/research/starter/open-questions.md +21 -0
  328. package/presets/research/vocabulary.yaml +33 -0
  329. package/reference/AUDIT-REPORT.md +238 -0
  330. package/reference/claim-map.md +172 -0
  331. package/reference/components.md +327 -0
  332. package/reference/conversation-patterns.md +542 -0
  333. package/reference/derivation-validation.md +649 -0
  334. package/reference/dimension-claim-map.md +134 -0
  335. package/reference/evolution-lifecycle.md +297 -0
  336. package/reference/failure-modes.md +235 -0
  337. package/reference/interaction-constraints.md +204 -0
  338. package/reference/kernel.yaml +242 -0
  339. package/reference/methodology.md +283 -0
  340. package/reference/open-questions.md +279 -0
  341. package/reference/personality-layer.md +302 -0
  342. package/reference/self-space.md +299 -0
  343. package/reference/semantic-vs-keyword.md +288 -0
  344. package/reference/session-lifecycle.md +298 -0
  345. package/reference/templates/base-note.md +16 -0
  346. package/reference/templates/companion-note.md +70 -0
  347. package/reference/templates/creative-note.md +16 -0
  348. package/reference/templates/learning-note.md +16 -0
  349. package/reference/templates/life-note.md +16 -0
  350. package/reference/templates/moc.md +26 -0
  351. package/reference/templates/relationship-note.md +17 -0
  352. package/reference/templates/research-note.md +19 -0
  353. package/reference/templates/session-log.md +24 -0
  354. package/reference/templates/therapy-note.md +16 -0
  355. package/reference/test-fixtures/edge-case-constraints.md +148 -0
  356. package/reference/test-fixtures/multi-domain.md +164 -0
  357. package/reference/test-fixtures/novel-domain-gaming.md +138 -0
  358. package/reference/test-fixtures/research-minimal.md +102 -0
  359. package/reference/test-fixtures/therapy-full.md +155 -0
  360. package/reference/testing-milestones.md +1087 -0
  361. package/reference/three-spaces.md +363 -0
  362. package/reference/tradition-presets.md +203 -0
  363. package/reference/use-case-presets.md +341 -0
  364. package/reference/validate-kernel.sh +432 -0
  365. package/reference/vocabulary-transforms.md +85 -0
  366. package/scripts/sync-thinking.sh +147 -0
  367. package/skill-sources/graph/SKILL.md +567 -0
  368. package/skill-sources/graph/skill.json +17 -0
  369. package/skill-sources/learn/SKILL.md +254 -0
  370. package/skill-sources/learn/skill.json +17 -0
  371. package/skill-sources/next/SKILL.md +407 -0
  372. package/skill-sources/next/skill.json +17 -0
  373. package/skill-sources/pipeline/SKILL.md +314 -0
  374. package/skill-sources/pipeline/skill.json +17 -0
  375. package/skill-sources/ralph/SKILL.md +604 -0
  376. package/skill-sources/ralph/skill.json +17 -0
  377. package/skill-sources/reduce/SKILL.md +1113 -0
  378. package/skill-sources/reduce/skill.json +17 -0
  379. package/skill-sources/refactor/SKILL.md +448 -0
  380. package/skill-sources/refactor/skill.json +17 -0
  381. package/skill-sources/reflect/SKILL.md +747 -0
  382. package/skill-sources/reflect/skill.json +17 -0
  383. package/skill-sources/remember/SKILL.md +534 -0
  384. package/skill-sources/remember/skill.json +17 -0
  385. package/skill-sources/rethink/SKILL.md +658 -0
  386. package/skill-sources/rethink/skill.json +17 -0
  387. package/skill-sources/reweave/SKILL.md +657 -0
  388. package/skill-sources/reweave/skill.json +17 -0
  389. package/skill-sources/seed/SKILL.md +303 -0
  390. package/skill-sources/seed/skill.json +17 -0
  391. package/skill-sources/stats/SKILL.md +371 -0
  392. package/skill-sources/stats/skill.json +17 -0
  393. package/skill-sources/tasks/SKILL.md +402 -0
  394. package/skill-sources/tasks/skill.json +17 -0
  395. package/skill-sources/validate/SKILL.md +310 -0
  396. package/skill-sources/validate/skill.json +17 -0
  397. package/skill-sources/verify/SKILL.md +532 -0
  398. package/skill-sources/verify/skill.json +17 -0
  399. package/skills/add-domain/SKILL.md +441 -0
  400. package/skills/add-domain/skill.json +17 -0
  401. package/skills/architect/SKILL.md +568 -0
  402. package/skills/architect/skill.json +17 -0
  403. package/skills/ask/SKILL.md +388 -0
  404. package/skills/ask/skill.json +17 -0
  405. package/skills/health/SKILL.md +760 -0
  406. package/skills/health/skill.json +17 -0
  407. package/skills/help/SKILL.md +348 -0
  408. package/skills/help/skill.json +17 -0
  409. package/skills/recommend/SKILL.md +553 -0
  410. package/skills/recommend/skill.json +17 -0
  411. package/skills/reseed/SKILL.md +385 -0
  412. package/skills/reseed/skill.json +17 -0
  413. package/skills/setup/SKILL.md +1688 -0
  414. package/skills/setup/skill.json +17 -0
  415. package/skills/tutorial/SKILL.md +496 -0
  416. package/skills/tutorial/skill.json +17 -0
  417. package/skills/upgrade/SKILL.md +395 -0
  418. package/skills/upgrade/skill.json +17 -0
@@ -0,0 +1,39 @@
1
+ ---
2
+ description: Named traversal sequences through the knowledge graph could let agents reuse discovered navigation paths across sessions
3
+ kind: research
4
+ topics: ["[[agent-cognition]]"]
5
+ source: TFT research corpus (00_inbox/heinrich/)
6
+ ---
7
+
8
+ # trails transform ephemeral navigation into persistent artifacts
9
+
10
+ Bush's Memex introduced the concept of trails: named, shareable paths through an information space. When a researcher navigated from topic A through B to insight C, they could save that traversal sequence and share it with others. The trail captured not just the destination but the journey that made the destination meaningful.
11
+
12
+ For agent-operated vaults, this concept addresses a core tension. When an agent navigates through notes during a session, that path typically vanishes when the session ends. The next session must rediscover the route. Trails would make these paths persistent — a folder containing markdown files that list wiki links in traversal order with annotations about why each step was taken.
13
+
14
+ Trails assume the paths exist to begin with. But since [[navigational vertigo emerges in pure association systems without local hierarchy]], some semantic neighbors have no link path at all — they're close in meaning but disconnected in graph space. Trails capture successful traversals, but they can't capture the traversals that couldn't happen because the links weren't there. This is why trails complement MOCs rather than replace them: MOCs create the local hierarchy that makes paths exist, trails persist the paths worth reusing.
15
+
16
+ This directly addresses the session isolation problem described in [[fresh context per task preserves quality better than chaining phases]]. Session isolation preserves quality by giving each task fresh context, but the cost is that navigation discoveries don't persist. Since [[session handoff creates continuity without persistent memory]] through externalized briefings, trails would extend this pattern: a trail is a navigation briefing, capturing not just what was discovered but the path that led there. The agent doesn't remember the route — it reads the trail.
17
+
18
+ Since [[intermediate packets enable assembly over creation]], trails would function as a new type of packet: navigation packets that structure traversal knowledge for reuse. Packets make session isolation practical by enabling handoffs through files. Trails extend this pattern: instead of just handing off work products, we hand off the navigation paths that produced them.
19
+
20
+ The key insight from Bush is that trails are not merely bookmarks or link collections. They encode the reasoning that connected the nodes — the "why this, then that" logic that made the traversal productive. Without this reasoning, you have a list of notes. With it, you have reusable navigation knowledge.
21
+
22
+ Since [[dual-coding with visual elements could enhance agent traversal]], trails represent one of several redundancy strategies for traversal robustness. Trails provide temporal redundancy by persisting successful navigation sequences across sessions. Visual dual-coding provides modal redundancy by encoding relationships in both text and visual form. Both address the question: how do we make traversal more robust when the primary path fails?
23
+ ---
24
+
25
+ Relevant Notes:
26
+ - [[topological organization beats temporal for knowledge work]] — trails only make sense in a topological system; in a stream you navigate by recency, in a garden you navigate by meaning and paths become worth preserving
27
+ - [[fresh context per task preserves quality better than chaining phases]] — describes the session isolation that creates the redundant navigation problem trails would solve
28
+ - [[session handoff creates continuity without persistent memory]] — trails extend the handoff pattern to navigation: work handoffs brief the next session on what was done, navigation handoffs brief the next session on how to get there
29
+ - [[intermediate packets enable assembly over creation]] — trails extend the packet pattern to navigation; packets hand off work products, trails hand off the paths that produced them
30
+ - [[session outputs are packets for future selves]] — the work-product instance that trails extend to navigation: session outputs are the composable packets trails would make navigable, adding the path dimension to what handoffs already preserve as content
31
+ - [[each new note compounds value by creating traversal paths]] — trails are explicit named paths; this note describes implicit paths through wiki links
32
+ - [[spreading activation models how agents should traverse]] — trails would be pre-computed activation paths that skip the spreading computation
33
+ - [[queries evolve during search so agents should checkpoint]] — trails could capture how queries evolved, preserving the checkpoint decisions that led to insight
34
+ - [[dual-coding with visual elements could enhance agent traversal]] — sibling redundancy strategy: trails provide temporal redundancy (path reuse), dual-coding provides modal redundancy (visual + text encoding)
35
+ - [[logic column pattern separates reasoning from procedure]] — sibling reasoning-persistence pattern: trails persist navigation reasoning (why this, then that), logic columns persist procedural reasoning (why this step); both transform ephemeral understanding into reusable artifacts
36
+ - [[navigational vertigo emerges in pure association systems without local hierarchy]] — trails assume paths exist; this note identifies when paths DON'T exist (semantic neighbors with no link path), which is why trails complement rather than replace MOCs
37
+
38
+ Topics:
39
+ - [[agent-cognition]]
@@ -0,0 +1,259 @@
1
+ ---
2
+ description: How to adapt universal knowledge system concepts to domain-native language during vault generation — the translation layer that makes derived systems feel natural to practitioners
3
+ kind: guidance
4
+ status: active
5
+ topics: ["[[vocabulary-transformation]]"]
6
+ ---
7
+
8
+ # transform universal vocabulary to domain-native language through six levels
9
+
10
+ The same structural operation goes by different names in different domains. A research vault calls it "claim extraction." A therapy journal calls it "pattern recognition." A project management system calls it "decision documentation." The underlying operation (transforming raw content into structured domain knowledge) is identical — but using the wrong vocabulary makes the system feel foreign to its user.
11
+
12
+ Since [[schema fields should use domain-native vocabulary not abstract terminology]], vocabulary transformation is the translation layer that makes derived systems feel native to practitioners.
13
+
14
+ This doc tells the plugin HOW to translate universal concepts into domain language during /setup and vault generation.
15
+
16
+ ## Why Vocabulary Transformation Matters
17
+
18
+ ### Trust
19
+
20
+ A therapist confronted with `antecedent_conditions:` must first recall what that means in their vocabulary, then translate their thinking, then fill the field. Each translation step erodes trust. The practitioner feels the system doesn't understand their work — and that feeling is correct. The abstract vocabulary literally fails to encode the domain's conceptual distinctions.
21
+
22
+ When the field says "triggers," the therapist can fill it from their natural professional thinking without detour. The system speaks their language.
23
+
24
+ ### Cognitive Load
25
+
26
+ Since [[schema fields should use domain-native vocabulary not abstract terminology]], every interaction with abstract terminology forces a translation step that consumes working memory that should be directed at content. Domain-native vocabulary eliminates this translation entirely. The cognitive savings compound across every note created, every query run, every maintenance check reported.
27
+
28
+ ### Adoption
29
+
30
+ The vocabulary gap is not cosmetic — it is the primary adoption barrier for derived systems. Abstract terminology causes users to misunderstand fields, fill them inconsistently, or abandon the system entirely. Inconsistent filling is particularly insidious because it destroys the entropy reduction that makes metadata queryable in the first place.
31
+
32
+ ## The Ontology-Vocabulary Coupling
33
+
34
+ Vocabulary carries ontology. When a system uses "antecedent_conditions," it implicitly asserts that therapy operates through abstract causal chains. When it uses "triggers," it acknowledges the embodied, experiential reality of therapeutic work. The vocabulary choice is not neutral — it shapes how the practitioner conceptualizes their domain within the system.
35
+
36
+ Since [[false universalism applies same processing logic regardless of domain]], vocabulary mismatch is often the visible symptom of a deeper operational mismatch. A therapy system that renames "claim extraction" to "insight extraction" but keeps the same decomposition logic has fixed the vocabulary problem while preserving the operational problem. The insight extraction in therapy is qualitatively different from claim extraction in research — it involves pattern recognition across temporal entries, emotional resonance detection, identification of recurring triggers and coping strategies. These are different operations that happen to occupy the same structural position in the skeleton.
37
+
38
+ The practical implication: vocabulary transformation without operational adaptation is cosmetic derivation. The plugin must translate both the names AND the operations.
39
+
40
+ ## The Universal-to-Domain Translation
41
+
42
+ The plugin maintains a translation table from universal kernel concepts to domain-specific vocabulary. Since [[every knowledge domain shares a four-phase processing skeleton that diverges only in the process step]], the skeleton is invariant — capture, process, connect, verify. The names are adaptive.
43
+
44
+ ### Core Operation Translations
45
+
46
+ | Universal Operation | Research | Therapy | PM | Creative | Learning | Trading |
47
+ |-------------------|----------|---------|------|----------|----------|---------|
48
+ | Capture | Record source | Journal entry | Meeting notes | Inspiration spark | Lecture notes | Trade journal |
49
+ | Process (extract) | Claim extraction | Pattern detection | Decision documentation | Consistency check | Concept mapping | Thesis tracking |
50
+ | Connect (reflect) | Citation linking | Trigger-pattern correlation | Stakeholder impact mapping | Character relationship mapping | Prerequisite linking | Correlation analysis |
51
+ | Verify | Schema validation | Growth tracking | Risk assessment review | Continuity verification | Mastery assessment | Strategy compliance check |
52
+ | Maintain (reweave) | Literature review update | Coping strategy reassessment | Risk register refresh | Worldbuilding bible update | Prerequisite graph revision | Thesis invalidation check |
53
+
54
+ ### Note Type Translations
55
+
56
+ | Universal Type | Research | Therapy | PM | Creative | Learning | Trading |
57
+ |---------------|----------|---------|------|----------|----------|---------|
58
+ | Claim note | Finding / Hypothesis | Pattern record | Decision log entry | Canon fact | Concept note | Trade thesis |
59
+ | Source note | Literature reference | Session notes | Meeting minutes | Reference material | Lecture notes | Market analysis |
60
+ | Tension note | Research contradiction | Ambivalence record | Risk assessment | Continuity error | Prerequisite conflict | Thesis contradiction |
61
+ | MOC | Literature review | Pattern overview | Project dashboard | Story bible | Course map | Strategy overview |
62
+ | Synthesis note | Meta-analysis | Growth insight | Lessons learned | Thematic analysis | Transfer insight | Strategy review |
63
+
64
+ ### Schema Field Translations
65
+
66
+ Since [[schema field names are the only domain specific element in the universal note pattern]], field names carry the entire burden of domain adaptation. The five-component note architecture (prose title, YAML frontmatter, body, wiki links, topics footer) is domain-invariant — only the YAML field names change.
67
+
68
+ | Universal Field | Research | Therapy | PM | Health | Legal |
69
+ |----------------|----------|---------|------|--------|-------|
70
+ | description | description | description | description | description | description |
71
+ | classification | methodology | mood | status | symptom_type | matter_type |
72
+ | source | source | session_date | project | date | jurisdiction |
73
+ | confidence | evidence_quality | intensity | priority | severity | precedent_strength |
74
+ | status | preliminary/open | active/resolved | pending/done | acute/chronic | open/closed |
75
+ | related | relevant_notes | related_patterns | stakeholders | correlated_symptoms | related_matters |
76
+
77
+ ## YAML Field Naming Conventions
78
+
79
+ ### When to Keep Universal Terms
80
+
81
+ Some fields work universally and should NOT be translated:
82
+
83
+ - `description` — every domain uses this word naturally
84
+ - `topics` — structural field, not domain-facing
85
+ - `type` — structural classification
86
+ - `created` / `updated` — temporal metadata
87
+ - `relevant_notes` — structural linking (though the context phrases within should use domain language)
88
+
89
+ **The principle:** Structural fields that describe the note's role in the system keep universal names. Domain fields that describe the note's content use domain-native names.
90
+
91
+ ### When to Transform
92
+
93
+ Transform fields that describe domain content:
94
+
95
+ | Signal | Action |
96
+ |--------|--------|
97
+ | Practitioners have a natural term for this concept | Use their term |
98
+ | The universal term requires mental translation | Transform |
99
+ | The field appears in user-facing output (queries, reports) | Transform |
100
+ | The field is never shown to users (internal routing) | Keep universal |
101
+
102
+ ### Naming Rules
103
+
104
+ 1. **Use snake_case** for multi-word field names: `coping_strategy`, not `copingStrategy` or `Coping Strategy`
105
+ 2. **Use singular nouns** for single-value fields: `mood`, not `moods`
106
+ 3. **Use plural for arrays**: `triggers: ["rejection", "conflict"]`
107
+ 4. **Prefer short names**: `mood` over `emotional_state_rating`
108
+ 5. **Match the domain's vocabulary exactly**: if therapists say "triggers," use `triggers`, not `activating_events`
109
+ 6. **Avoid abbreviations** unless the domain uses them: `adr` is fine for engineering (Architecture Decision Record), `sess_dt` is not fine for therapy
110
+
111
+ ### Enum Values Follow the Same Principle
112
+
113
+ Field names and their valid values should both speak domain language:
114
+
115
+ ```yaml
116
+ # Research
117
+ methodology: ["Zettelkasten", "Cognitive Science", "PKM Research"]
118
+ classification: open | closed
119
+
120
+ # Therapy
121
+ mood: [1-10]
122
+ pattern_type: ["trigger-response", "cognitive distortion", "attachment pattern"]
123
+
124
+ # Trading
125
+ market_regime: ["trending", "ranging", "volatile", "transitioning"]
126
+ conviction_level: ["high", "moderate", "speculative"]
127
+ ```
128
+
129
+ ## Vocabulary Discovery Protocol
130
+
131
+ During /setup, the plugin discovers domain vocabulary through conversation:
132
+
133
+ ### Step 1: Domain Identification
134
+ Ask what the user does. Listen for domain-specific terms they naturally use. A therapist says "session notes" not "source capture." A trader says "thesis" not "hypothesis."
135
+
136
+ ### Step 2: Vocabulary Mapping
137
+ Map the user's natural terms to universal operations:
138
+ - "I want to track my trades and see what I'm doing wrong" -> capture = trade journal, process = trade review, verify = strategy compliance
139
+ - "I need to keep my worldbuilding consistent" -> capture = canon entry, process = consistency check, verify = continuity validation
140
+
141
+ ### Step 3: Template Generation
142
+ Generate note templates using the user's vocabulary:
143
+ ```yaml
144
+ # For a therapy user:
145
+ ---
146
+ description: [what this reflection is about]
147
+ mood: [1-10 scale]
148
+ triggers: ["trigger1", "trigger2"]
149
+ coping_used: ["strategy1"]
150
+ ---
151
+
152
+ # NOT this (abstract vocabulary):
153
+ ---
154
+ description: [what this claim is about]
155
+ classification: [category]
156
+ variables: ["var1", "var2"]
157
+ methods_applied: ["method1"]
158
+ ---
159
+ ```
160
+
161
+ ### Step 4: Skill Language Adaptation
162
+ Pipeline skills should speak the domain's language in their output:
163
+ - Research /reduce: "Extracted 5 claims and 2 enrichments from this paper"
164
+ - Therapy /reduce: "Identified 3 patterns and 1 coping strategy update from this journal entry"
165
+ - PM /reduce: "Documented 2 decisions and 4 action items from this meeting"
166
+ - Creative /reduce: "Found 2 canon facts and 1 continuity issue from this chapter draft"
167
+ - Trading /reduce: "Captured 1 new thesis and 2 observation updates from today's review"
168
+
169
+ This applies to error messages, maintenance reports, and suggestions too. A therapy vault's staleness warning should say "Pattern overview not reviewed against recent journal entries" not "MOC has stale notes."
170
+
171
+ ## The Translation Boundary
172
+
173
+ Some concepts translate; some don't. The plugin must recognize both:
174
+
175
+ ### Concepts That Translate Directly
176
+ - Capture (exists in every domain)
177
+ - Connection finding (universal)
178
+ - Schema validation (universal)
179
+ - MOC navigation (universal, though MOC section names vary)
180
+ - Maintenance checks (universal)
181
+
182
+ ### Concepts That Need Adaptation
183
+ - Processing intensity (varies by domain)
184
+ - Review cadence (varies by consequence speed)
185
+ - Link semantics (research uses "extends/contradicts", therapy uses "triggers/alleviates")
186
+ - MOC section headings (research: "Tensions" vs therapy: "Active Patterns" vs PM: "Open Risks")
187
+
188
+ ### Concepts That Don't Transfer
189
+ - Specific processing logic (research claim extraction is not the same as therapy pattern detection)
190
+ - Domain-specific validation rules (legal citation format is not the same as academic citation format)
191
+ - Agent tone (therapy requires warmth; engineering requires precision)
192
+ - Domain-specific maintenance checks (plot thread tracking vs citation integrity vs trade thesis validity)
193
+
194
+ ## Relationship Type Vocabulary
195
+
196
+ Wiki links carry relationship semantics. Different domains express relationships differently:
197
+
198
+ | Universal | Research | Therapy | PM | Creative | Legal |
199
+ |-----------|----------|---------|------|----------|-------|
200
+ | extends | extends | deepens insight | builds on | develops further | follows from |
201
+ | contradicts | contradicts | conflicts with | overrides | breaks continuity | distinguishes |
202
+ | enables | foundation for | prerequisite for | unblocks | enables scene | establishes precedent |
203
+ | causes | evidence for | triggers | leads to | causes plot event | gives rise to |
204
+ | part of | component of | aspect of | deliverable in | element of | falls under |
205
+
206
+ **Implementation:** The plugin generates relationship type enums during /setup based on the domain's natural language for these connections. The context phrases in MOC links and relevant_notes fields use these domain-specific relationship terms.
207
+
208
+ ## Cross-Domain Translation
209
+
210
+ When users have multiple domains, vocabulary creates a cross-domain challenge. Each domain uses different terms for structurally equivalent operations. The resolution is layered vocabulary:
211
+
212
+ - **Surface layer (user-facing):** Domain-native vocabulary in templates, skill output, maintenance reports
213
+ - **Meta layer (system-facing):** Universal vocabulary for cross-domain analysis, reconciliation, and multi-domain queries
214
+
215
+ This means the plugin maintains the translation table in both directions. It can convert "pattern detection" back to "process" when needed for cross-domain comparison, while always presenting "pattern detection" to the therapy user.
216
+
217
+ Since [[multi-domain systems compose through separate templates and shared graph]], the graph layer operates on universal components (wiki links, MOC hierarchy, topics) while templates isolate the domain-specific vocabulary. Cross-domain links work because the graph never sees field names — it traverses through titles, links, and topics, all of which are domain-invariant.
218
+
219
+ ## Anti-Patterns
220
+
221
+ | Anti-Pattern | Why It Fails | Better Approach |
222
+ |-------------|-------------|-----------------|
223
+ | Using universal vocabulary for everything | System feels foreign, user disengages | Translate to domain language |
224
+ | Inventing new vocabulary | User doesn't recognize their own workflow | Use the user's existing terms |
225
+ | Inconsistent translation | Same concept called different things in different places | Establish translation table at /setup, use consistently |
226
+ | Translating structure along with vocabulary | Universal structure (capture/process/connect/verify) is invariant | Translate names only, keep structural patterns |
227
+ | Over-translating | Some terms (description, topics) work universally | Only translate where domain language genuinely differs |
228
+ | Vocabulary without operational adaptation | Cosmetic derivation — wrong operations with right names | Translate operations alongside vocabulary |
229
+
230
+ ## Domain Examples
231
+
232
+ These domain compositions demonstrate vocabulary transformation in practice:
233
+
234
+ - [[therapy journal uses warm personality with pattern detection for emotional processing]] — Capture becomes "journal entry," process becomes "pattern detection," and the schema uses `mood`, `triggers`, `coping_used` instead of abstract `classification`, `variables`, `methods_applied`
235
+ - [[trading uses conviction tracking with thesis-outcome correlation]] — Claims become "trade theses," connections become "correlation analysis," and `conviction_level`, `thesis_status`, `market_regime` replace generic metadata fields
236
+ - [[legal case management uses precedent chains with regulatory change propagation]] — MOCs become "matter dashboards," maintenance becomes "precedent chain monitoring," and `jurisdiction`, `precedent_strength`, `opposing_arguments` reflect legal practitioner vocabulary
237
+ - [[creative writing uses worldbuilding consistency with character tracking]] — Notes become "canon facts," verification becomes "continuity checking," and `canon_status`, `characters_involved`, `timeline_position` speak the fiction writer's language
238
+ - [[student learning uses prerequisite graphs with spaced retrieval]] — Processing becomes "concept mapping," MOCs become "course maps," and `mastery_level`, `prerequisites`, `retrieval_strength` reflect learning science vocabulary
239
+ - [[health wellness uses symptom-trigger correlation with multi-dimensional tracking]] — Captures become "tracking entries," processing becomes "pattern analysis," and `symptom_type`, `severity`, `correlated_symptoms` match how health-conscious practitioners think about their data
240
+
241
+ ## Grounding
242
+
243
+ This guidance is grounded in:
244
+ - [[schema fields should use domain-native vocabulary not abstract terminology]] — the foundational vocabulary principle
245
+ - [[schema field names are the only domain specific element in the universal note pattern]] — where domain specificity lives
246
+ - [[every knowledge domain shares a four-phase processing skeleton that diverges only in the process step]] — universal structure with domain-variable naming
247
+ - [[methodology traditions are named points in a shared configuration space not competing paradigms]] — traditions as vocabulary for shared operations
248
+ - [[false universalism applies same processing logic regardless of domain]] — the trap of not translating deeply enough
249
+ - [[multi-domain systems compose through separate templates and shared graph]] — cross-domain vocabulary challenges
250
+
251
+ ---
252
+
253
+ Topics:
254
+ - [[index]]
255
+ - [[index]]
256
+ ---
257
+
258
+ Topics:
259
+ - [[vocabulary-transformation]]
@@ -0,0 +1,53 @@
1
+ ---
2
+ description: Content-kind metadata (claim, synthesis, tension) provides a query axis orthogonal to wiki link topology, enabling "find all synthesis notes about X" without folder trees
3
+ kind: research
4
+ topics: ["[[discovery-retrieval]]"]
5
+ source: TFT research corpus (00_inbox/heinrich/)
6
+ ---
7
+
8
+ # type field enables structured queries without folder hierarchies
9
+
10
+ Traditional knowledge systems use folders to categorize content by kind: a folder for sources, a folder for synthesis, a folder for drafts. This works but creates a problem: each note can only live in one folder, so you choose between organizing by topic or organizing by type. The folder hierarchy forces a single taxonomic axis. Since [[topological organization beats temporal for knowledge work]], flat structure with wiki links is already preferable — but flat structure alone doesn't provide category-based retrieval. Type metadata fills that gap.
11
+
12
+ Type metadata dissolves this trade-off. Since [[faceted classification treats notes as multi-dimensional objects rather than folder contents]], each YAML field is an independent classification dimension -- a facet in Ranganathan's terminology. Type is one such facet: when each note carries a `type:` field (claim, synthesis, tension, methodology, problem, learning), you can query by content kind without folder structure. Want all tension notes? `rg "^type: tension"`. Want synthesis notes about retrieval? Search the thinking folder for synthesis type and retrieval keywords. The flat folder stays flat while structured queries become possible.
13
+
14
+ This matters for agent navigation because since [[role field makes graph structure explicit]], agents already have a dimension describing WHERE a note sits in the graph. Type provides an orthogonal dimension describing WHAT KIND of content it is. A note can be:
15
+
16
+ - A claim (type) that functions as a hub (role)
17
+ - A synthesis (type) that functions as a leaf (role)
18
+ - A methodology note (type) that functions as a moc (role)
19
+
20
+ Neither dimension collapses into the other. Role tells you how to traverse. Type tells you what you're reading.
21
+
22
+ The query patterns this enables:
23
+
24
+ | Query | Command | What It Finds |
25
+ |-------|---------|---------------|
26
+ | All methodology notes | `rg "^type: methodology"` | Implementation patterns, features to build |
27
+ | All problems | `rg "^type: problem"` | Anti-patterns, failure modes |
28
+ | Unresolved tensions | `rg "^type: tension" -l \| xargs rg "^status: open"` | Conflicts needing resolution |
29
+ | Synthesis about X | `qmd query "X" + type: synthesis` | High-level arguments on topic |
30
+
31
+ Without type metadata, you'd need either folder hierarchies (limiting notes to one category) or manual list maintenance (tracking "all synthesis notes" in a separate file). Type metadata makes the category intrinsic to the note, queryable anywhere, without forcing hierarchical organization.
32
+
33
+ Since [[live index via periodic regeneration keeps discovery current]], type-based queries become even more powerful when pre-computed. A maintenance agent can regenerate type indices at change boundaries, giving agents instant access to "all methodology notes" or "all unresolved tensions" without the query cost at decision time. The query patterns above work with JIT ripgrep, but pre-computed type indices would make them free to load.
34
+
35
+ Type metadata is a concrete instance of what since [[markdown plus YAML plus ripgrep implements a queryable graph database without infrastructure]] identifies as the broader pattern: each YAML field is a queryable property in a graph database where ripgrep replaces SQL. The `rg "^type: tension"` query pattern this note demonstrates is functionally equivalent to a graph database property query, and when combined with other YAML field filters (methodology, topics, status), the piped commands achieve the multi-attribute precision that graph database query languages provide through WHERE clause conjunction.
36
+
37
+ The design decision in this vault treats type as optional for standard claims because claims are the default. You only add `type:` when the note is something other than a straightforward assertion. This keeps YAML minimal while enabling structured queries when needed. Since [[descriptions are retrieval filters not summaries]], the type field adds an orthogonal retrieval dimension: descriptions filter by relevance to a query, while type filters by content kind. An agent asking "find methodology notes about X" can filter first by type, then by semantic relevance — two independent axes that multiply filtering power.
38
+ ---
39
+
40
+ Relevant Notes:
41
+ - [[markdown plus YAML plus ripgrep implements a queryable graph database without infrastructure]] — synthesis: type is one queryable property in the four-layer graph database; the ripgrep query patterns this note demonstrates are property queries on graph nodes
42
+ - [[role field makes graph structure explicit]] — the orthogonal dimension: role describes graph position while type describes content kind
43
+ - [[metadata reduces entropy enabling precision over recall]] — type metadata increases precision when searching for specific content kinds
44
+ - [[topological organization beats temporal for knowledge work]] — the foundational choice that makes type metadata necessary: flat folders need queryable dimensions
45
+ - [[associative ontologies beat hierarchical taxonomies because heterarchy adapts while hierarchy brittles]] — explains WHY flat structure plus type metadata works: associative relationships adapt while folder hierarchies brittle
46
+ - [[descriptions are retrieval filters not summaries]] — descriptions and type are complementary filter dimensions: relevance vs content kind
47
+ - [[maturity field enables agent context prioritization]] — sibling metadata proposal: maturity tracks development stage while type tracks content kind
48
+ - [[question-answer metadata enables inverted search patterns]] — sibling metadata proposal: questions enable inverted search while type enables category filtering
49
+ - [[live index via periodic regeneration keeps discovery current]] — pre-computed type indices make category queries free at decision time
50
+ - [[faceted classification treats notes as multi-dimensional objects rather than folder contents]] — theoretical framework: type is one facet in Ranganathan's multi-dimensional classification; the PMEST framework explains why each metadata field is an independent query dimension and provides the independence test for new fields
51
+
52
+ Topics:
53
+ - [[discovery-retrieval]]
@@ -0,0 +1,44 @@
1
+ ---
2
+ description: Curated module selections for common use cases (Research Vault, PKM, Project Management) give template-level simplicity as entry point while preserving underlying composability — but users who
3
+ kind: research
4
+ topics: ["[[design-dimensions]]"]
5
+ confidence: speculative
6
+ methodology: ["Original", "Systems Theory"]
7
+ source: [[composable-knowledge-architecture-blueprint]]
8
+ ---
9
+
10
+ # use-case presets dissolve the tension between composability and simplicity
11
+
12
+ Composable knowledge architectures face a persistent adoption problem. Since [[composable knowledge architecture builds systems from independent toggleable modules not monolithic templates]], the architecture treats each capability as an independent toggle with explicit dependencies — which is precisely what makes it powerful and precisely what makes it intimidating. A new user confronting a module catalog with dozens of independently activatable capabilities faces a decision surface that rivals the raw dimension questions that [[configuration paralysis emerges when derivation surfaces too many decisions]] describes. The composable architecture solved the engineering problem of monolithic templates but may have recreated the UX problem in different clothing: instead of "pick a template and strip what you don't need," it becomes "pick modules and hope you chose enough."
13
+
14
+ Presets propose a dissolution. A preset is a curated module selection for a common use case — "Research Vault" activates thirteen modules covering the full pipeline from capture through semantic search, "Personal Knowledge Management" activates nine modules emphasizing capture and organization, "Project Management" activates seven structure-focused modules, and "Minimal" activates only the three foundation modules. The user selects a use-case label, not a module list. The preset resolves all the dimension questions that the use case implies, and because [[configuration dimensions interact so choices in one create pressure on others]], those questions are not independent — choosing atomic granularity forces explicit linking, which demands deep navigation, which requires heavy processing. The preset author resolved these coupling constraints once: Research Vault chooses atomic granularity, explicit linking, deep navigation, heavy processing, and the corresponding modules that implement those choices. The user gets template-level simplicity — one choice produces a working system — while the underlying composability remains intact because the preset is just a named configuration of independently toggleable modules, not a monolithic artifact.
15
+
16
+ What makes this more than a template rebrand is the relationship between presets and post-activation customization. Templates are subtractive — start with everything, remove what you do not need, which requires understanding what everything does before you can judge what to remove. Presets are additive — start with what the use case requires, add modules when friction signals that something is missing. Since [[the no wrong patches guarantee ensures any valid module combination produces a valid system]], each post-preset toggle is safe by construction. Adding a module cannot corrupt existing data. Removing a module returns the system to a known valid state. This means the user can treat the preset as a starting point and modify without fear, because the architecture guarantees that any valid combination works. The progressive nature extends to validation too: since [[progressive schema validates only what active modules require not the full system schema]], a preset that activates fewer modules means fewer validation demands, so the user's daily experience matches the system's actual complexity rather than its theoretical maximum.
17
+
18
+ The connection to the seed-evolve-reseed lifecycle is direct. Since [[derived systems follow a seed-evolve-reseed lifecycle]], presets ARE the seeding mechanism — they produce the minimum viable configuration for a use case, with evolution guidelines encoding when to add complexity. A Research Vault preset user who starts writing notes and discovers they need project tracking can enable the project-management module at the moment of friction, not during initial setup when the need was hypothetical — and since [[dependency resolution through topological sort makes module composition transparent and verifiable]], the resolver explains what else needs enabling and why, turning each friction-triggered addition into architectural education. Since [[premature complexity is the most common derivation failure mode]], presets enforce the complexity budget by activating only what the use case justifies, leaving the research graph's additional insights available as evolution guidelines rather than upfront deployment. This is progressive disclosure applied to system architecture: since [[progressive disclosure means reading right not reading less]], the user absorbs complexity through use rather than comprehending it during configuration.
19
+
20
+ Presets also relate to methodology traditions as parallel naming strategies. Since [[methodology traditions are named points in a shared configuration space not competing paradigms]], traditions are community-validated dimension choices (Zettelkasten means atomic + explicit linking + deep navigation). Presets are architecturally-validated module selections (Research Vault means yaml-schema + wiki-links + atomic-notes + mocs + processing-pipeline + semantic-search + ...). Both reduce the configuration surface by naming coherent bundles. The difference is granularity: traditions name dimension choices in the abstract configuration space, presets name module selections in the concrete implementation space. A Research Vault preset could implement a Zettelkasten-derived configuration, making presets the operational implementation of tradition-informed derivation.
21
+
22
+ The claim is classified as open because the dissolution may be incomplete. Users who start with a preset and evolve through friction eventually face a system they did not design from first principles. The preset handled initial decisions, but evolution changes the module selection incrementally, and the user may reach a configuration that no longer matches any preset — a custom system without the understanding that custom composition would have built. This is a deferred onboarding cliff: the preset eliminated upfront complexity, but the user must still develop module-level understanding to evolve effectively. Whether presets truly dissolve the composability-simplicity tension or merely postpone the moment when composability's cognitive demands arrive depends on whether the evolution phase builds the understanding that upfront composition would have required. Two mechanisms work in favor of dissolution: since [[justification chains enable forward backward and evolution reasoning about configuration decisions]], a user can trace any preset-provided module back through the claims that justified it, building understanding through backward reasoning rather than forward construction, and since [[evolution observations provide actionable signals for system adaptation]], the six diagnostic patterns convert vague friction into specific structural responses, so the user learns which modules to add or reconfigure through structured signals rather than guesswork. Since [[derived systems follow a seed-evolve-reseed lifecycle]], the evolution guidelines embedded in the seed context are designed to build this understanding incrementally — each friction-triggered module addition teaches the user about that specific capability in context. But this is a hypothesis about learning through friction, not a demonstrated result. The difference between dissolving a tension and deferring it may only become visible at the reseeding phase, when the user must reason about their system's configuration as a whole rather than one module at a time.
23
+
24
+ ---
25
+ ---
26
+
27
+ Relevant Notes:
28
+ - [[configuration paralysis emerges when derivation surfaces too many decisions]] — the problem presets solve: paralysis arises from surfacing every dimension as a question, and presets eliminate most questions by bundling dimension choices into a use-case label
29
+ - [[composable knowledge architecture builds systems from independent toggleable modules not monolithic templates]] — the architecture presets operate within: presets are named module selections, not monolithic templates, so the individual modules remain independently toggleable after the preset provides the initial configuration
30
+ - [[premature complexity is the most common derivation failure mode]] — presets calibrate the complexity budget: a well-designed preset activates only the modules justified for its use case, avoiding the structural incentive to front-load every research-justified choice
31
+ - [[the no wrong patches guarantee ensures any valid module combination produces a valid system]] — the safety property that makes preset customization non-destructive: toggling individual modules after a preset activates or deactivates them cannot corrupt data because the guarantee covers all valid combinations
32
+ - [[derived systems follow a seed-evolve-reseed lifecycle]] — presets are the seeding mechanism: they provide minimum viable configuration for a use case, with the expectation that friction-driven evolution will customize the module selection over time
33
+ - [[methodology traditions are named points in a shared configuration space not competing paradigms]] — presets and traditions serve parallel functions as named configurations: traditions bundle dimension choices validated by community practice, presets bundle module selections validated by architectural analysis
34
+ - [[progressive schema validates only what active modules require not the full system schema]] — enables presets to start clean: a minimal preset activates few modules, so the user encounters only the validation requirements those modules declare
35
+ - [[progressive disclosure means reading right not reading less]] — the cognitive principle presets implement at the system level: users absorb system complexity progressively through use rather than comprehending it upfront during configuration
36
+ - [[implicit dependencies create distributed monoliths that fail silently across configurations]] — the testing-context risk presets amplify: because presets bundle modules into convenient configurations, developers naturally test against preset combinations rather than in isolation, causing modules to silently depend on fields and conventions that other preset-bundled modules provide
37
+ - [[configuration dimensions interact so choices in one create pressure on others]] — why presets can be curated at all: dimension coupling means a use-case label implies a coherent region of the configuration space, so the preset author resolves the coupling constraints once rather than requiring each user to navigate the interaction pressures independently
38
+ - [[justification chains enable forward backward and evolution reasoning about configuration decisions]] — mitigates the deferred onboarding cliff: backward reasoning lets a user who started with a preset trace each module choice to the claims and constraints that justified it, building the understanding that upfront composition would have provided but through inspection rather than construction
39
+ - [[evolution observations provide actionable signals for system adaptation]] — the diagnostic mechanism for preset evolution: when a preset user encounters friction, the six diagnostic patterns identify whether the symptom signals a missing module, an over-modeled type, or a processing mismatch, converting vague friction into specific module-level action
40
+ - [[dependency resolution through topological sort makes module composition transparent and verifiable]] — the computational engine that makes preset activation practical: selecting a use-case label triggers topological sort on the module DAG, resolving transitive dependencies automatically and producing explanations that teach the user why modules relate
41
+ - [[friction-driven module adoption prevents configuration debt by adding complexity only at pain points]] — the post-preset evolution mechanism: presets provide curated starting points, and subsequent module additions follow friction signals rather than preset recommendations, making friction-driven adoption the evolution phase that personalizes the preset's initial configuration
42
+
43
+ Topics:
44
+ - [[design-dimensions]]
@@ -0,0 +1,44 @@
1
+ ---
2
+ description: Accumulated vault conventions may channel thinking into patterns that favor certain styles over others, despite the flat structure's stated flexibility
3
+ kind: research
4
+ topics: ["[[note-design]]"]
5
+ source: TFT research corpus (00_inbox/heinrich/)
6
+ ---
7
+
8
+ # vault conventions may impose hidden rigidity on thinking
9
+
10
+ The system claims flexibility through flat structure and wiki links. But conventions accumulate into constraints. The claim-as-title pattern requires thinking to resolve into sentence form. The YAML schema requires metadata decisions. The MOC structure imposes hierarchical organization. Each convention individually seems lightweight, but collectively they may channel thinking into patterns that favor certain styles over others.
11
+
12
+ There is a counterargument worth considering: since [[complex systems evolve from simple working systems]], the system conventions emerged from actual friction rather than upfront design. Conventions that calcified from working patterns might be genuine solutions, not arbitrary constraints. The test becomes: are current conventions still solving real problems, or have they become obstacles to new kinds of thinking? For schema conventions specifically, since [[schema evolution follows observe-then-formalize not design-then-enforce]], the observe-then-formalize protocol provides a concrete mechanism for keeping schema conventions adaptive — fields are added only when usage evidence justifies them and demoted when placeholder stuffing reveals false compliance, so at least the schema layer resists the calcification this note warns about.
13
+
14
+ Since [[schema enforcement via validation agents enables soft consistency]], there may be a middle path between rigid conventions and no conventions: soft enforcement that encourages patterns without blocking deviations. Validation agents that warn about non-standard titles or missing metadata create pressure toward convention compliance without making compliance mandatory. This shifts conventions from hard constraints that might impose hidden rigidity to soft expectations that shape behavior through visibility rather than blocking.
15
+
16
+ The research on Cornell note-taking finds that rigid formats "struggle to accommodate visual learners" and "non-linear topics." The fixed layout constrains what can be expressed. Does the system inherit this problem through different means?
17
+
18
+ Beyond temporal escape valves (mutability, backward maintenance), there is a structural one. Since [[federated wiki pattern enables multi-agent divergence as feature not bug]], when conventions channel an insight into a form that loses nuance, a parallel note can preserve the alternative formulation. The two notes linked together capture more than either alone, and neither has to violate the conventions — each can follow the claim-as-title pattern while expressing a different facet of the same complex idea. This doesn't dissolve the rigidity concern, but it provides a concrete mechanism for working within conventions while acknowledging their limits.
19
+
20
+ The high-leverage question: when an insight resists the claim-as-title pattern, is it because the insight is genuinely non-linear, or because the articulation isn't complete yet?
21
+
22
+ The high-leverage question: if forced reformulation always indicates incomplete thinking, then conventions are helpful constraints that push toward understanding before building. If forced reformulation sometimes destroys valid non-linear insight, then conventions impose genuine rigidity.
23
+
24
+ The Cornell critique applied to visual learners and non-linear topics. The system is text-based by design. The real question may be: is text itself the constraint, or is it specifically how we structure text?
25
+
26
+ Since [[dual-coding with visual elements could enhance agent traversal]], the text-based constraint might be partially addressable. Mermaid diagrams and relationship graphs could provide visual encoding for concepts that resist text-only expression. Whether this would reduce rigidity depends on whether the visual/verbal separation that aids human cognition translates to multimodal LLM processing — if visual input just gets converted to the same latent space as text, dual-coding may not provide the flexibility benefit it offers humans.
27
+ ---
28
+
29
+ Relevant Notes:
30
+ - [[claims must be specific enough to be wrong]] — the claim-as-title pattern demands specificity, which may be the source of both value and constraint
31
+ - [[complex systems evolve from simple working systems]] — counterargument: conventions emerged from working patterns, so they may be solutions rather than arbitrary constraints
32
+ - [[backward maintenance asks what would be different if written today]] — potential dissolution: rigid creation conventions might be offset by flexible maintenance allowing evolution
33
+ - [[schema templates reduce cognitive overhead at capture time]] — the tradeoff made concrete: schema templates reduce cognitive overhead when they fit the content, but impose hidden rigidity when they don't
34
+ - [[dual-coding with visual elements could enhance agent traversal]] — proposes visual encoding as partial remedy for text-based constraints, though benefit depends on whether multimodal processing is genuinely distinct
35
+ - [[schema enforcement via validation agents enables soft consistency]] — offers middle path: soft enforcement via warnings preserves flexibility while encouraging convention compliance through visibility rather than blocking
36
+ - [[sense-making vs storage does compression lose essential nuance]] — sibling concern at the description layer: this note asks whether titles resist compression, that note asks whether descriptions resist compression; both test whether complex ideas survive the filtering architecture
37
+ - [[digital mutability enables note evolution that physical permanence forbids]] — theoretical escape valve: even if creation conventions impose rigidity, the medium permits notes to evolve past their initial form through backward maintenance
38
+ - [[federated wiki pattern enables multi-agent divergence as feature not bug]] — structural escape valve: when conventions compress an insight into one canonical form that loses nuance, a parallel federated note can preserve the alternative formulation; provides an explicit mechanism for escaping convention rigidity without abandoning conventions entirely
39
+ - [[schema evolution follows observe-then-formalize not design-then-enforce]] — partial dissolution for schema conventions: rather than imposing rigid schema requirements upfront, the observe-then-formalize protocol lets conventions emerge from use, reducing the hidden rigidity risk by ensuring schema fields are justified by observed demand rather than speculative design
40
+ - [[description quality for humans diverges from description quality for keyword search]] — concrete evidence: the prose description convention implicitly optimizes for human scanning while imposing a hidden constraint on keyword retrieval that only surfaces during infrastructure failures
41
+ - [[organic emergence versus active curation creates a fundamental vault governance tension]] — sibling governance tension: this note asks whether conventions constrain thinking, that note asks whether the governance model that creates and enforces conventions strikes the right balance; the curation pole actively creates conventions, so the rigidity concern is a specific failure mode of over-curation
42
+
43
+ Topics:
44
+ - [[note-design]]
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: Agents can compress content into structured output that looks like synthesis but contains no genuine insight—the agent equivalent of passive verbatim note-taking
3
+ kind: research
4
+ topics: ["[[agent-cognition]]"]
5
+ source: TFT research corpus (00_inbox/heinrich/)
6
+ ---
7
+
8
+ # verbatim risk applies to agents too
9
+
10
+ Cornell Note-Taking warns that without active processing, note-taking degenerates into passive transcription. The student copies words without engaging with meaning. The notes look complete but the learning didn't happen.
11
+
12
+ The agent equivalent: an agent compresses a transcript into bullet points, reorganizes content under headings, or extracts "key points" — all without generating anything the source didn't already contain. The structure looks right. The output appears processed. But no synthesis occurred: no connections found, no claims sharpened, no implications drawn. Since [[ThreadMode to DocumentMode transformation is the core value creation step]], this is ThreadMode content dressed in DocumentMode clothing — the output has the formatting of timeless synthesis but the cognitive substance of chronological reorganization, because no genuine transformation occurred.
13
+
14
+ This matters because since [[the generation effect requires active transformation not just storage]], processing without generation creates the illusion of value while producing none. The system accumulates well-formatted summaries that don't compound because they contain no original insight to connect. Since [[insight accretion differs from productivity in knowledge systems]], verbatim risk is exactly the productivity-without-accretion failure mode: the agent achieves high productivity (many outputs, fast processing, organized structure) while zero accretion occurs (no deepening of understanding, no genuine insight, no cognitive hooks created). Since [[structure without processing provides no value]], the Lazy Cornell anti-pattern proves this: students who drew the structural lines but skipped the processing steps gained nothing over linear notes. Agents doing structural reorganization without synthesis commit the same error at higher throughput.
15
+
16
+ The risk compounds at scale because since [[intermediate packets enable assembly over creation]], the packet workflow is where verbatim risk manifests most dangerously. Agents can produce packets that look composable — structured, well-formatted, properly linked — but contain only reorganized content rather than genuine building blocks. Assembly from such packets produces a structure of summaries, not a structure of insights.
17
+
18
+ This claim forms a sibling trio with [[cognitive outsourcing risk in agent-operated systems]] and [[productivity porn risk in meta-system building]]. All three identify different failure modes in agent-operated systems: verbatim risk concerns agent output quality, cognitive outsourcing concerns human capability atrophy, productivity porn concerns whether building becomes procrastination. Each can undermine the system in distinct ways — they are orthogonal failure dimensions.
19
+ ---
20
+
21
+ Relevant Notes:
22
+ - [[insight accretion differs from productivity in knowledge systems]] — names the dichotomy: verbatim risk is exactly the productivity-without-accretion failure mode at agent scale; high productivity metrics while zero accretion occurs
23
+ - [[the generation effect requires active transformation not just storage]] — establishes that generation creates value; this identifies the failure mode when generation doesn't occur
24
+ - [[structure without processing provides no value]] — the Lazy Cornell anti-pattern is exactly what verbatim risk describes: structural motions that look processed but contain no generative work
25
+ - [[intermediate packets enable assembly over creation]] — the packet workflow is where verbatim risk manifests at scale: agents can produce packets that look composable but contain only reorganized content, not genuine building blocks
26
+ - [[cognitive outsourcing risk in agent-operated systems]] — sibling claim testing human capability atrophy; forms a failure mode trio with productivity porn
27
+ - [[productivity porn risk in meta-system building]] — sibling claim testing whether building becomes procrastination; orthogonal to verbatim risk but emerges from same source
28
+ - [[ThreadMode to DocumentMode transformation is the core value creation step]] — names the specific failure: ThreadMode with DocumentMode formatting is exactly what verbatim risk produces — well-structured reorganization that has the appearance of synthesis but generates no new understanding
29
+
30
+ Topics:
31
+ - [[agent-cognition]]
@@ -0,0 +1,56 @@
1
+ ---
2
+ description: The "dump and AI organizes" pattern converges across tools, but most implementations use opaque embeddings while agent-curated wiki links produce explicit traversable structure that avoids connection
3
+ kind: research
4
+ topics: ["[[processing-workflows]]", "[[agent-cognition]]"]
5
+ methodology: ["PKM Research", "Original"]
6
+ source: [[tft-research-part3]]
7
+ ---
8
+
9
+ # vibe notetaking is the emerging industry consensus for AI-native self-organization
10
+
11
+ The AI-native knowledge management landscape is converging on a single paradigm: the user dumps unstructured content, and the AI handles indexing, tagging, and linking. Research across tools and platforms identifies "self-organization" as the defining characteristic of the next generation of knowledge systems. This is vibe notetaking — capture without ceremony, structure without effort, organization as an emergent property of AI processing rather than a human discipline. Because [[AI shifts knowledge systems from externalizing memory to externalizing attention]], what vibe notetaking actually attempts is not just storing content but externalizing the decision of what to attend to — surfacing, filtering, and directing focus rather than merely filing and retrieving.
12
+
13
+ The convergence is real. Tools from Notion AI to Mem to Supermemory to Reflect all implement variants of the same pattern: accept whatever the user throws in, apply some AI processing, surface structure that the user never had to create manually. Since [[cognitive offloading is the architectural foundation for vault design]], this consensus is theoretically sound — Clark and Chalmers' Extended Mind thesis plus Risko and Gilbert's offloading economics predict exactly this outcome. When AI drives capture friction close to zero, the rational choice is always to externalize. Vibe notetaking is what cognitive offloading looks like when the technology catches up to the theory. The purest expression of this consensus is voice-first capture: since [[voice capture is the highest-bandwidth channel for agent-delegated knowledge systems]], speaking at 150 wpm triples typing throughput while preserving emotional markers that inform agent extraction. Voice is vibe notetaking's ideal input channel — zero ceremony, maximum bandwidth, and the paraverbal signals provide priority metadata that typed dumps lack.
14
+
15
+ But the convergence masks a critical differentiation in how the AI actually organizes. Most implementations use automated tagging and embedding-based linking. Content gets vectorized, similar chunks get clustered, tags get inferred from topic models. The result is a system that connects things by surface similarity — vocabulary overlap, semantic proximity in embedding space — producing opaque relationships that the user cannot inspect, verify, or traverse with intention. Since [[wiki links implement GraphRAG without the infrastructure]], this approach recreates graph retrieval through statistical inference rather than explicit curation. The connections exist, but they are black-box correlations rather than reasoned judgments about why ideas relate.
16
+
17
+ This matters because opaque connections produce connection fatigue. When a system surfaces twenty "related" items for every note and the user cannot tell why any of them are related, the connections become noise rather than signal. The user stops trusting the system's judgment and falls back to manual search or abandons the tool entirely. The research documents this as a recurring failure mode across AI-native tools: automated connections that are technically correct (high cosine similarity) but cognitively useless (no articulated reason for the relationship). This is the connection-layer instance of the pattern where [[over-automation corrupts quality when hooks encode judgment rather than verification]] — embedding-based linking automates the judgment of "what relates" and produces metrics that look healthy (high link counts, high similarity scores) while the connections carry no reasoning that an agent or human can evaluate. The result compounds into [[navigational vertigo emerges in pure association systems without local hierarchy]] when opaque connections become the only traversal mechanism, because the user cannot inspect relationships to decide which path leads somewhere productive.
18
+
19
+ The alternative — what this vault implements — is agent-curated wiki links. The agent reads source material, extracts claims, writes descriptions, and creates explicit wiki links with prose context explaining the relationship. Since [[three capture schools converge through agent-mediated synthesis]], the human captures with Accumulationist speed while the agent processes with Interpretationist quality. But the key differentiator is not that processing happens — it is that the processing produces transparent, inspectable, traversable structure. Because [[elaborative encoding is the quality gate for new notes]], the agent's wiki links with context phrases ("extends X by adding Y," "contradicts X because Z") are elaborative encoding implemented at system scale — connecting new information to existing knowledge with explicit relationship articulation. Embedding-based linking skips the elaboration entirely: placing two chunks near each other in vector space creates no cognitive hooks, no articulated reasoning, no encoding depth. When the agent writes "since [[spreading activation models how agents should traverse]], the traversal pattern becomes clear," the connection is visible, reasoned, and falsifiable. A human can disagree with it. Another agent can evaluate it. This is fundamentally different from an embedding that places two chunks near each other in a vector space for reasons neither human nor agent can articulate.
20
+
21
+ Since [[propositional link semantics transform wiki links from associative to reasoned]], the differentiation runs deeper than just transparency. Typed wiki links create machine-parseable relationship semantics — not just "these relate" but "this causes that" or "this extends that" or "this contradicts that." Embedding-based connections cannot distinguish between a note that supports a claim and one that contradicts it; both would score high similarity. Agent-curated wiki links encode the nature of the relationship, not just its existence. This makes the graph an inference substrate rather than merely a navigation aid.
22
+
23
+ However, the vibe notetaking consensus also carries a risk that applies regardless of linking approach. Since [[structure without processing provides no value]], automated organization that sorts and tags without genuine synthesis produces what Cunningham's wiki community called "thread mess" — well-organized ThreadMode content that has never been transformed into DocumentMode. Since [[ThreadMode to DocumentMode transformation is the core value creation step]], the test for any vibe notetaking implementation is whether the AI transforms chronological dumps into timeless claims or merely files them with better labels. Most current tools optimize for the filing — making content findable through search and tagging — without performing the synthesis that creates knowledge from information. Because [[the generation effect requires active transformation not just storage]], filing is not processing: tagging, clustering, and embedding content leaves the material cognitively unchanged. The generation effect demands that processing produce something that didn't exist in the source — a claim, a connection with articulated reasoning, a synthesis across inputs. Vibe notetaking implementations that stop at automated filing fail this test regardless of how sophisticated their filing mechanisms are.
24
+
25
+ The encoding tradeoff also persists. Since [[does agent processing recover what fast capture loses]], vibe notetaking maximizes system-level organization at the cost of human encoding depth. The user who dumps everything into an AI system builds excellent external memory but weak internal understanding. The system knows, but the person does not. This is not necessarily a problem — it depends on whether the goal is personal understanding or system capability — but it is a consequence that the industry consensus rarely acknowledges. The vibe notetaking pitch promises effortless knowledge management. The unspoken cost is that effortlessness means the human did no generative cognitive work, and the generation effect benefits whoever generates. Since [[cognitive outsourcing risk in agent-operated systems]], this is not just an encoding gap but a skill atrophy trajectory — when agents handle all extraction, connection-finding, and synthesis over time, the human may lose not just memory of specific content but the meta-cognitive capacity to structure ideas, recognize good connections, and judge what matters. The industry consensus promotes effortlessness without acknowledging that effort is where understanding forms.
26
+
27
+ The deeper claim is that vibe notetaking as industry consensus is correct about the capture side and mostly wrong about the organization side. Dump-and-organize is the right paradigm for capture. But "organize" implemented as automated embedding-based linking produces a different kind of system than "organize" implemented as agent-curated wiki links with explicit reasoning. The former creates a searchable archive. The latter creates a traversable knowledge graph. Both accept the same vibe-captured input. They diverge at the processing layer, and since [[scaffolding enables divergence that fine-tuning cannot]], that divergence determines not just whether the system becomes a thinking tool or a filing cabinet, but what kind of agent emerges — agents whose scaffolding consists of opaque embeddings develop different retrieval patterns, different connection intuitions, and ultimately different cognitive capabilities than agents whose scaffolding consists of curated wiki links with articulated reasoning. The vibe notetaking consensus also implicitly takes a position on governance. Since [[organic emergence versus active curation creates a fundamental vault governance tension]], most vibe notetaking tools commit fully to the emergence pole — structure emerges from AI processing without human curation interventions. The governance tension reveals why this fails at scale: without periodic curation (pruning connections, splitting overgrown clusters, enforcing quality standards), the emergent structure accumulates the same structural debt that any organic growth produces. Agent-curated wiki links represent a governance rhythm that interleaves organic capture with deliberate curation, which the vibe notetaking consensus skips entirely.
28
+
29
+ ---
30
+ ---
31
+
32
+ Relevant Notes:
33
+ - [[three capture schools converge through agent-mediated synthesis]] — foundation: the three capture schools dissolve into vibe notetaking's dump-and-organize pattern, but convergence quality depends on whether the agent generates or merely files
34
+ - [[wiki links implement GraphRAG without the infrastructure]] — the differentiating mechanism: agent-curated wiki links produce the same graph benefits as automated GraphRAG without opaque infrastructure, and this transparency is what separates meaningful self-organization from noise generation
35
+ - [[cognitive offloading is the architectural foundation for vault design]] — theoretical grounding: vibe notetaking is cognitive offloading optimized to its logical conclusion, minimizing capture friction so the rational choice is always to externalize
36
+ - [[structure without processing provides no value]] — the risk that vibe notetaking shares with Lazy Cornell: automated organization that files without generating understanding produces well-sorted noise, not knowledge
37
+ - [[does agent processing recover what fast capture loses]] — the encoding tradeoff: vibe notetaking maximizes system-level organization while the human retains nothing from the capture act itself
38
+ - [[propositional link semantics transform wiki links from associative to reasoned]] — extends the differentiation: typed wiki links make agent-curated connections not just explicit but machine-reasonable, widening the gap from embedding-based association
39
+ - [[ThreadMode to DocumentMode transformation is the core value creation step]] — the quality test: genuine vibe notetaking must transform ThreadMode dumps into DocumentMode synthesis, not just sort threads into prettier containers
40
+ - [[AI shifts knowledge systems from externalizing memory to externalizing attention]] — paradigm frame: vibe notetaking's self-organization is attention externalization in disguise, deciding what to surface and connect rather than just storing and retrieving
41
+ - [[the generation effect requires active transformation not just storage]] — cognitive mechanism: explains why filing-as-organization fails; generation demands producing something new (a claim, an articulated connection) while tagging and embedding leave material cognitively unchanged
42
+ - [[elaborative encoding is the quality gate for new notes]] — what makes curated links cognitively different from embeddings: wiki links with context phrases are elaborative encoding at system scale, while cosine similarity skips the elaboration entirely
43
+ - [[over-automation corrupts quality when hooks encode judgment rather than verification]] — Goodhart corruption: embedding-based linking automates connection judgment and produces correct-looking relationships that carry no reasoning, the connection-layer instance of the over-automation pattern
44
+ - [[navigational vertigo emerges in pure association systems without local hierarchy]] — navigation consequence: opaque embedding-based connections exacerbate vertigo because users cannot inspect relationships to decide which traversal path is productive
45
+ - [[cognitive outsourcing risk in agent-operated systems]] — long-term consequence: vibe notetaking's promise of effortlessness creates a skill atrophy trajectory where the human loses meta-cognitive capacity to structure, connect, and judge
46
+ - [[PKM failure follows a predictable cycle]] — cascade risk: vibe notetaking could accelerate the early stages (Collector's Fallacy, Under-processing) by making collection effortless while genuine synthesis depends entirely on the AI's processing depth
47
+ - [[behavioral anti-patterns matter more than tool selection]] — the industry convergence is tool-level; whether any vibe notetaking implementation produces knowledge depends on behavioral patterns that persist regardless of which app hosts the capture-and-organize pipeline
48
+ - [[guided notes might outperform post-hoc structuring for high-volume capture]] — nuances the capture side: research suggests some upfront structure preserves encoding benefits that pure dumps lose, challenging vibe notetaking's zero-friction capture assumption
49
+ - [[voice capture is the highest-bandwidth channel for agent-delegated knowledge systems]] — the ideal input channel: voice at 150 wpm with emotional markers is vibe notetaking's purest capture modality, providing maximum bandwidth with zero ceremony
50
+ - [[wiki links as social contract transforms agents into stewards of incomplete references]] — the stewardship differentiator: embedding-based vibe notetaking has no obligation mechanism for completing references, while wiki link social contracts make dangling links into commitments the pipeline systematically fulfills
51
+ - [[organic emergence versus active curation creates a fundamental vault governance tension]] — governance frame: vibe notetaking commits fully to the emergence pole, producing structure through AI processing without curation interventions; the governance tension explains why this fails at scale — structural debt from uncurated growth compounds past easy resolution
52
+ - [[scaffolding enables divergence that fine-tuning cannot]] — divergence consequence of the embedding vs wiki-link differentiation: the choice between opaque embeddings and curated wiki links is a scaffolding choice that produces genuinely different agents, making the vibe notetaking implementation decision an agent individuation decision
53
+
54
+ Topics:
55
+ - [[processing-workflows]]
56
+ - [[agent-cognition]]