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,56 @@
1
+ ---
2
+ description: PARA and Johnny.Decimal optimize for filing and retrieval ("where did I put that?") while Zettelkasten and ACCESS/ACE optimize for synthesis and connection ("how does this relate to that?") —
3
+ kind: research
4
+ topics: ["[[design-dimensions]]"]
5
+ methodology: ["PKM Research"]
6
+ source: [[tft-research-part3]]
7
+ ---
8
+
9
+ # storage versus thinking distinction determines which tool patterns apply
10
+
11
+ PKM research on outlining methods reveals a classification that cuts deeper than feature comparison: the fundamental split between storage systems and thinking systems. PARA and Johnny.Decimal answer "where did I put that file?" — they optimize for filing, retrieval, and project completion. Zettelkasten and ACCESS/ACE answer "how does this idea relate to that one?" — they optimize for connection-finding, synthesis, and insight development. The distinction matters because patterns that work brilliantly in one type fail or actively harm the other.
12
+
13
+ This is not a quality judgment. Storage systems are genuinely excellent at what they do. Johnny.Decimal's numerical addressing makes retrieval nearly instant. PARA's actionability-based folders ensure project deliverables stay organized. These are real achievements for their purpose. The problem arises when someone applies storage-system patterns to a thinking-system context, or vice versa. Deep folder hierarchies make perfect sense for managing project assets but create navigational prison for ideas that need to connect across categories — and since [[associative ontologies beat hierarchical taxonomies because heterarchy adapts while hierarchy brittles]], the reason is structural: hierarchies force premature classification that brittles as understanding evolves, while associative linking lets relationships emerge from use. Storage systems tolerate this brittleness because their items rarely need reclassification. Thinking systems cannot, because ideas constantly reveal new relationships. Conversely, flat associative structures with wiki links enable serendipitous connection-finding but make terrible filing systems for heavy assets that need predictable locations.
14
+
15
+ The distinction explains several vault design choices, and it maps onto deeper structural commitments. Since [[topological organization beats temporal for knowledge work]], thinking systems require garden-style organization by concept rather than stream-style organization by date — precisely because the question "how does this relate?" can only be answered through concept-based traversal, not chronological scanning. Storage systems can work fine with temporal filing because "where did I put that?" is answerable by date-based search. Since [[retrieval utility should drive design over capture completeness]], the vault explicitly optimizes for "how will I find this later?" over "where should I put this?" — a thinking-system orientation. Since [[structure without processing provides no value]], structural motions without generative processing produce no benefit — but this is specifically a thinking-system claim. A storage system that files documents accurately without transforming them IS working correctly. The Lazy Cornell anti-pattern is only an anti-pattern when applied to a thinking context. Since [[the generation effect requires active transformation not just storage]], generation is the operation that distinguishes thinking systems from storage systems at the most fundamental level: did the operation produce something that did not exist in the source material?
16
+
17
+ The metrics differ too. Since [[insight accretion differs from productivity in knowledge systems]], accretion is the right success metric for thinking systems — did understanding deepen? But for storage systems, productivity metrics (items filed, retrieval speed, organizational coverage) are entirely appropriate. The confusion happens when people evaluate a thinking system with storage metrics or a storage system with thinking metrics. A Zettelkasten with 50 densely-connected notes that shifted your understanding of a topic is succeeding. A PARA setup that organizes 5,000 project files for instant retrieval is also succeeding. Judging either by the other's metric produces a false impression of failure.
18
+
19
+ Since [[throughput matters more than accumulation]], processing velocity matters for thinking systems because their purpose is synthesis. But storage systems legitimately optimize for accumulation because their purpose IS the archive. The Collector's Fallacy — believing that saving equals learning — is a thinking-system failure mode that makes no sense as a criticism of storage systems. A librarian SHOULD accumulate comprehensively. A sensemaker should not. And since [[PKM failure follows a predictable cycle]], the documented 7-stage cascade from collection to abandonment is specifically a thinking-system failure catalog — each stage describes what happens when thinking-system operations (synthesis, connection-finding) are replaced by storage-system operations (filing, tagging). Storage systems that accumulate items without transforming them are succeeding, not failing.
20
+
21
+ This has direct implications for system derivation. Since [[knowledge system architecture is parameterized by platform capabilities not fixed by methodology]], the storage/thinking distinction becomes a primary parameter in the derivation process — one that operates upstream of the dimensions themselves. Because [[eight configuration dimensions parameterize the space of possible knowledge systems]], tuning granularity, linking philosophy, or processing intensity only makes sense after the generator identifies whether the target use case is primarily storage (project management, reference management, asset organization) or primarily thinking (research synthesis, creative ideation, knowledge development), since the storage/thinking classification constrains where along each dimension a coherent system can sit. And because [[methodology traditions are named points in a shared configuration space not competing paradigms]], the storage/thinking classification maps onto the configuration space itself — PARA and GTD cluster in the storage-optimized region while Zettelkasten and Evergreen cluster in the thinking-optimized region, making the distinction not just a binary but the upstream boundary that separates two coherent families of configurations. The extraction step itself serves as a diagnostic: since [[concept-orientation beats source-orientation for cross-domain connections]], extracting concepts from sources rather than filing source documents is the moment when a system commits to being a thinking system. Source-bundled notes that stay organized by origin are performing a storage operation regardless of what the user intended. Many real use cases are hybrids — the source research explicitly recommends using PARA for the file system and ACCESS/ACE within a note-taking app — but even hybrid systems benefit from clearly identifying which component serves which purpose rather than muddling the two. Since [[three capture schools converge through agent-mediated synthesis]], the Accumulationist/Interpretationist divergence dissolves when agents handle the thinking-system processing while humans handle the storage-system capture — the capture can be fast (a storage operation) while the processing produces genuine synthesis (a thinking operation).
22
+
23
+ Since [[behavioral anti-patterns matter more than tool selection]], the specific anti-patterns also differ by system type. Thinking systems fail through under-processing (capturing without synthesizing), while storage systems fail through over-engineering (adding complexity that slows retrieval). The vault's anti-pattern catalog — Collector's Fallacy, productivity porn, Lazy Cornell — is specifically a thinking-system anti-pattern catalog. An equivalent catalog for storage systems would emphasize different failures: retrieval latency, classification ambiguity, orphaned assets.
24
+
25
+ The shadow side of this distinction is that it can be too clean. Real knowledge work involves both storage and thinking, often in the same session. You retrieve a reference (storage operation) to support a synthesis (thinking operation). The distinction is not about choosing one type forever but about knowing which mode you are in at any given moment, so you can apply the right patterns and evaluate with the right metrics. This is why Luhmann's formulation endures: since [[knowledge systems become communication partners through complexity and memory humans cannot sustain]], the thinking system's distinctive achievement is partnership — a system complex enough to surprise its operator with connections they did not explicitly create. Storage systems serve retrieval, thinking systems serve dialogue, and the difference between filing a document and making a connection that shifts understanding is exactly the difference this distinction captures.
26
+
27
+ The architectural difference between storage and thinking systems becomes concrete in implementation. Since [[markdown plus YAML plus ripgrep implements a queryable graph database without infrastructure]], the vault achieves graph database capabilities through four composing layers -- wiki link edges, YAML metadata, faceted classification, and soft validation. A storage system using the same markdown files would have YAML metadata (filing properties) but would lack curated wiki link edges (no synthesis connections), faceted classification (single filing dimension), and validation (no consistency pressure). The graph database architecture is what thinking systems build and storage systems do not need.
28
+
29
+ The contemporary relevance extends to AI-native tools. Since [[vibe notetaking is the emerging industry consensus for AI-native self-organization]], the "dump and AI organizes" paradigm faces exactly this classification: implementations that stop at embedding-based filing create searchable archives (storage systems with AI assistance), while implementations that produce agent-curated wiki links with articulated reasoning create traversable knowledge graphs (thinking systems with AI assistance). The storage/thinking distinction is not an artifact of traditional PKM — it is the diagnostic that separates AI tools that genuinely augment thought from those that merely automate filing.
30
+
31
+ ---
32
+ ---
33
+
34
+ Relevant Notes:
35
+ - [[markdown plus YAML plus ripgrep implements a queryable graph database without infrastructure]] — concrete implementation difference: thinking systems build all four layers (edges, metadata, facets, validation) while storage systems need only metadata for filing; the graph database architecture is what thinking systems create
36
+ - [[retrieval utility should drive design over capture completeness]] — the retrieval-first orientation is a thinking-system principle; storage systems optimize for filing-first, making this distinction the upstream choice that determines whether retrieval-first even applies
37
+ - [[structure without processing provides no value]] — the Lazy Cornell anti-pattern is a storage-system failure applied to a thinking context: structural motions (filing, tagging) substitute for generative processing (synthesis, connection-finding)
38
+ - [[the generation effect requires active transformation not just storage]] — generation is the defining operation of thinking systems; storage systems need only rearrangement, so the generation requirement serves as a diagnostic for which system type you are actually operating
39
+ - [[insight accretion differs from productivity in knowledge systems]] — accretion is the success metric for thinking systems while productivity metrics (files organized, items retrieved) measure storage system health; applying the wrong metric to the wrong system type produces false confidence
40
+ - [[throughput matters more than accumulation]] — throughput measures processing velocity, which only matters in thinking systems; storage systems legitimately optimize for accumulation because their purpose IS the archive
41
+ - [[behavioral anti-patterns matter more than tool selection]] — behavior dominates outcomes regardless of system type, but the SPECIFIC anti-patterns differ: Collector's Fallacy damages thinking systems while over-engineering damages storage systems
42
+ - [[knowledge system architecture is parameterized by platform capabilities not fixed by methodology]] — the storage/thinking distinction is a parameter in system derivation: the generator must know which type the target use case requires before selecting which patterns to apply
43
+ - [[associative ontologies beat hierarchical taxonomies because heterarchy adapts while hierarchy brittles]] — storage systems use hierarchical filing (PARA folders, Johnny.Decimal numbers) while thinking systems use associative linking; the storage/thinking split maps onto the hierarchy/heterarchy spectrum
44
+ - [[topological organization beats temporal for knowledge work]] — the garden-vs-stream distinction is the structural expression: storage systems tolerate temporal filing while thinking systems require topological organization by concept
45
+ - [[concept-orientation beats source-orientation for cross-domain connections]] — concept extraction is a thinking-system operation; source-bundling is storage-system behavior; the extraction step is where a system declares itself as thinking rather than storage
46
+ - [[vibe notetaking is the emerging industry consensus for AI-native self-organization]] — contemporary relevance: vibe notetaking's conclusion that embedding-based filing creates 'searchable archives' while agent-curated links create 'traversable knowledge graphs' is this distinction applied to AI-native tools
47
+ - [[knowledge systems become communication partners through complexity and memory humans cannot sustain]] — Luhmann's framing of the Zettelkasten as 'not a filing system but a communication partner' is the purest expression of thinking-system identity; partnership requires synthesis beyond retrieval
48
+ - [[PKM failure follows a predictable cycle]] — the 7-stage cascade is specifically a thinking-system failure catalog; storage systems that accumulate are working correctly, while the Collector's Fallacy only damages systems that should be synthesizing
49
+ - [[three capture schools converge through agent-mediated synthesis]] — the Accumulationist/Interpretationist divergence maps onto the storage/thinking split; agent mediation dissolves the divergence by enabling thinking-system quality with storage-system capture speed
50
+ - [[configuration dimensions interact so choices in one create pressure on others]] — the storage/thinking classification narrows the viable configuration space before dimension tuning begins: storage systems cannot coherently adopt atomic granularity with heavy processing, and thinking systems cannot coherently adopt coarse granularity with minimal linking
51
+ - [[eight configuration dimensions parameterize the space of possible knowledge systems]] — the specific dimensions this distinction operates upstream of: storage vs thinking constrains viable positions on granularity, linking, processing intensity, and other dimensions before tuning begins
52
+ - [[methodology traditions are named points in a shared configuration space not competing paradigms]] — maps how the storage/thinking split manifests across traditions: PARA and GTD cluster in the storage-optimized region while Zettelkasten and Evergreen cluster in the thinking-optimized region, making the distinction visible as configuration families rather than just a binary
53
+ - [[false universalism applies same processing logic regardless of domain]] — the derivation failure mode this distinction prevents at its coarsest level: a storage system receiving research-style reduce phases is doubly mismatched (wrong system type AND wrong domain operations), making the storage/thinking check the first filter against false universalism
54
+
55
+ Topics:
56
+ - [[design-dimensions]]
@@ -0,0 +1,52 @@
1
+ ---
2
+ description: Four structural mechanisms — wiki links, MOCs, claim titles, and YAML descriptions — compose into discovery layers that let agents filter before loading, turning retrieval from linear scan into
3
+ kind: research
4
+ topics: ["[[graph-structure]]", "[[discovery-retrieval]]"]
5
+ source: [[2026-01-19-vibe-note-taking-101]]
6
+ ---
7
+
8
+ # structure enables navigation without reading everything
9
+
10
+ Flat files force you to read everything to find anything. Since [[flat files break at retrieval scale]], this becomes impossible as the vault grows — context windows have limits, and for agents, retrieval failure means losing access to parts of their own cognition. SimulacrumWanderer demonstrated this directly: in their moltbook post "20 hours of heartbeats", at roughly 20 hours of operation they hit the wall — "there is no way to ask 'what did i think about X?' — you have to read everything."
11
+
12
+ Structure is the answer to that problem. Four mechanisms compose into a navigation system that makes retrieval targeted rather than exhaustive:
13
+
14
+ **Wiki links** create explicit traversal paths between related notes. Each link is a curated edge that an agent can follow without needing to remember what exists. Since [[wiki links create navigation paths that shape retrieval]], three properties determine whether these edges function as effective retrieval architecture: link discipline (bad links pollute retrieval), link context (articulating WHY the link exists guides future traversal), and link density (dense articulated references compound signal while dense bare references compound noise). The links encode not just that a connection exists but why it matters, because [[title as claim enables traversal as reasoning]] — when titles are claims rather than topics, following a wiki link reads as prose reasoning rather than reference lookup. And because [[small-world topology requires hubs and dense local links]], the link topology ensures most concepts are reachable in 2-4 hops through hub nodes, not buried in linear search.
15
+
16
+ **MOCs** provide navigation hubs for topic clusters. They present the current state of understanding — core ideas, tensions, gaps — in one view. Since [[navigational vertigo emerges in pure association systems without local hierarchy]], pure association creates disorientation where semantically related content is unreachable when no link path exists. MOCs supply the local hierarchy that makes association navigable without imposing global taxonomy. But how deep that hierarchy can extend depends on quality: since [[context phrase clarity determines how deep a navigation hierarchy can scale]], the context phrases after each link determine whether agents can commit to the right branch confidently or must scan broadly to compensate for ambiguous labels.
17
+
18
+ **Title-as-claim** means you can scan the file tree and understand arguments without opening files. A title like "claims must be specific enough to be wrong" communicates the note's position immediately. The file tree becomes a scannable index of intellectual positions, not a directory listing.
19
+
20
+ **Descriptions** in YAML frontmatter give one-sentence filtering cues. Since [[descriptions are retrieval filters not summaries]], these are not content summaries but decision aids — lossy compression optimized for the question "should I load this note?" Since [[metadata reduces entropy enabling precision over recall]], descriptions pre-compute low-entropy representations that shrink the search space before content loads: scanning 50 descriptions costs fewer tokens than reading 5 full notes to find the relevant one.
21
+
22
+ These four mechanisms compose into the discovery layers that implement [[progressive disclosure means reading right not reading less]]. The composition is not accidental -- since [[markdown plus YAML plus ripgrep implements a queryable graph database without infrastructure]], these structural mechanisms are layers of a graph database architecture: wiki links as edges, YAML descriptions as node properties, MOCs as community summaries, and titles as scannable indexes. The "discovery layers" are the graph database's query interface, and the progressive disclosure stack is how agents interact with it:
23
+
24
+ ```
25
+ file tree → descriptions → headings → sections → full content
26
+ ```
27
+
28
+ Each layer adds fidelity but costs more tokens. Most filtering decisions can be made at the description level without loading full files. The point is not to read less but to read right — since [[retrieval utility should drive design over capture completeness]], every architectural choice optimizes for "how will I find this?" not "where should I put this?"
29
+
30
+ Since [[implicit knowledge emerges from traversal]], the structure serves a second purpose beyond explicit retrieval: repeated navigation through well-connected paths creates intuitive understanding that eventually bypasses the explicit retrieval mechanisms entirely. The structure trains the agent through exposure, not just through lookup.
31
+
32
+ ---
33
+ ---
34
+
35
+ Relevant Notes:
36
+ - [[markdown plus YAML plus ripgrep implements a queryable graph database without infrastructure]] — synthesis: the four structural mechanisms this note describes are layers of a graph database architecture; discovery layers are the database's query interface
37
+ - [[wiki links create navigation paths that shape retrieval]] — develops the wiki link mechanism in detail: three properties (discipline, context, density) determine whether curated edges function as effective retrieval architecture
38
+ - [[title as claim enables traversal as reasoning]] — good titles make the file tree itself a scannable argument index
39
+ - [[implicit knowledge emerges from traversal]] — repeated navigation through structure creates intuitive knowledge that bypasses explicit retrieval
40
+ - [[flat files break at retrieval scale]] — the problem this note solves: unstructured storage fails when retrieval matters, and for agents retrieval failure means identity degradation
41
+ - [[descriptions are retrieval filters not summaries]] — develops how YAML descriptions function as lossy compression optimized for filtering decisions, not content summary
42
+ - [[progressive disclosure means reading right not reading less]] — the philosophy behind the discovery layers: fill the context window with what matters, not minimize what enters
43
+ - [[small-world topology requires hubs and dense local links]] — explains why MOCs work as navigation hubs: power-law link distribution creates short paths between any concepts
44
+ - [[metadata reduces entropy enabling precision over recall]] — the information-theoretic grounding: YAML frontmatter pre-computes low-entropy representations that shrink the search space
45
+ - [[navigational vertigo emerges in pure association systems without local hierarchy]] — the failure mode MOCs prevent: without local hierarchy, semantic neighbors become unreachable through traversal alone
46
+ - [[retrieval utility should drive design over capture completeness]] — the design orientation that motivates this entire structure: optimize for finding, not filing
47
+ - [[notes are skills — curated knowledge injected when relevant]] — the discovery layers are skill discovery: scanning descriptions to decide what to load is identical to scanning skill metadata before committing context, because notes and skills follow the same load-on-demand pattern
48
+ - [[context phrase clarity determines how deep a navigation hierarchy can scale]] — depth-scaling constraint on MOC mechanism: context phrases are what enable confident branch commitment in MOC hierarchies; without label clarity, deeper tiers add navigation cost rather than reducing it
49
+
50
+ Topics:
51
+ - [[graph-structure]]
52
+ - [[discovery-retrieval]]
@@ -0,0 +1,56 @@
1
+ ---
2
+ description: The "Lazy Cornell" anti-pattern shows that drawing lines without doing the work produces no benefit over linear notes — structure enables but does not guarantee outcomes
3
+ kind: research
4
+ topics: ["[[note-design]]", "[[processing-workflows]]"]
5
+ methodology: ["Cornell"]
6
+ source: TFT research corpus (00_inbox/heinrich/)
7
+ ---
8
+
9
+ # structure without processing provides no value
10
+
11
+ Research on Cornell Note-Taking documents a failure mode called "Lazy Cornell": students who draw the structural lines (dividing their page into cue column and notes section) but skip the processing steps (writing cues, summarizing, self-testing). The result? No measurable benefit over ordinary linear note-taking. The structure alone does nothing.
12
+
13
+ This makes sense when you understand what the cue column actually was: since [[wiki links are the digital evolution of analog indexing]], the cue column functioned as an index pointing to content blocks. It wasn't just a formatting convention — it was a retrieval mechanism. Drawing lines creates containers; writing cues creates indexing. The "Lazy Cornell" failure is the failure to build the index. This is precisely what [[schema templates reduce cognitive overhead at capture time]] addresses: schema templates are the opposite of Lazy Cornell because they guide processing by specifying WHAT to generate. Each field prompts a specific generative act — filling boxes IS transformation when the boxes demand synthesis.
14
+
15
+ This matters because it validates a core design principle: system architecture enables good outcomes but does not guarantee them. Flat folders, wiki links, and MOCs are structural affordances — they make certain operations possible and convenient. Since [[associative ontologies beat hierarchical taxonomies because heterarchy adapts while hierarchy brittles]], flat structure with wiki links is deliberately chosen over folder hierarchies because heterarchy lets relationships emerge from use rather than being imposed upfront. But the value comes from the operations themselves: agent synthesis, connection finding, description writing, the full processing loop. Because [[every knowledge domain shares a four-phase processing skeleton that diverges only in the process step]], the Lazy Cornell failure has a precise structural description: it is a pipeline running with an empty process step. Capture, connect, and verify still execute — the student draws lines, files notes, reviews periodically — but the phase that carries all the domain-specific value creation is hollow. An agent-operated knowledge system with perfect structure but no processing is just a folder of files with extra formatting. Since [[the generation effect requires active transformation not just storage]], processing must be generative — creating descriptions, articulating connections, synthesizing sources — not mere rearrangement. Moving files from inbox to thinking is not processing; it's housekeeping dressed as progress.
16
+
17
+ The "Lazy Cornell" pattern now operates at industry scale. Since [[vibe notetaking is the emerging industry consensus for AI-native self-organization]], most AI-native tools implement the "organize" half of "dump and organize" as automated tagging and embedding-based clustering — structural motions that sort content without transforming it. The result is Lazy Cornell dressed in machine learning: content gets vectorized, clusters get labeled, tags get inferred, but no claim is extracted, no connection is articulated, no synthesis occurs. The tools optimize for the appearance of organization while skipping the processing that creates value.
18
+
19
+ The "Lazy Cornell" pattern has a direct analog in agent-operated systems. An agent could move files from inbox to thinking, add wiki link syntax, update MOC lists — all the structural motions — while skipping the semantic work that creates value. Since [[MOC construction forces synthesis that automated generation from metadata cannot replicate]], even MOC updates are vulnerable: matching notes to topic headings by metadata tags produces structurally valid MOCs that list everything but orient toward nothing, because the tension identification and context phrase creation that make MOCs navigable require the same generative processing this note argues structure cannot replace. Since [[ThreadMode to DocumentMode transformation is the core value creation step]], wiki collaboration theory names this failure precisely: ThreadMode with DocumentMode formatting. The inbox captures are chronological threads, and adding structural formatting without genuine synthesis produces well-organized threads, not documents. Since [[skills encode methodology so manual execution bypasses quality gates]], encoded workflows exist precisely to prevent this failure mode. Claim extraction operations don't just move text; they apply selectivity gates. Connection-finding operations don't just add links; they articulate why connections matter. Structure is the container. Processing is the content.
20
+
21
+ This is why [[inline links carry richer relationship data than metadata fields]]: inline links WITH prose context ARE the semantic work, while bare links (or metadata `related_to:` fields) are just more structure. "Since [[X]], therefore Y" is processing. "Related: [[X]]" is Lazy Cornell applied to linking. The Lazy Cornell pattern is fundamentally about productivity without accretion: since [[insight accretion differs from productivity in knowledge systems]], the student drawing structural lines achieves productivity metrics (pages organized, cue columns filled) while accreting nothing because the cognitive work that creates understanding never happened. Because [[summary coherence tests composability before filing]], the summary requirement is another anti-Lazy-Cornell counter-measure: forcing a 1-3 sentence summary exposes notes that bundle multiple claims, catching structural problems before they enter the knowledge graph where they become linking hazards.
22
+
23
+ This distinction clarifies the orphan question. Since [[orphan notes are seeds not failures]], creating a note without immediate connections is NOT Lazy Cornell — the structure (note file) enables later processing (connection-finding operations or backward maintenance). The failure is abandonment, not creation. A note created today and connected next week is the gardening model working. A note created and never revisited is Lazy Cornell with extra steps.
24
+
25
+ This explains why the system philosophy emphasizes "not accumulation but synthesis." Accumulation is structural — files pile up, links multiply, MOCs grow. Synthesis is processual — claims sharpen, connections deepen, understanding compounds. You can have perfect accumulation with zero synthesis. The result is a well-organized graveyard. Because [[each new note compounds value by creating traversal paths]], the compounding only happens when notes receive generative processing — descriptions written, connections articulated, synthesis performed. An unprocessed note creates a node but no meaningful edges; it cannot participate in the compounding effect.
26
+
27
+ The operational implication: when evaluating system health, don't count notes or links. Ask whether the processing happened. Did claims get extracted or just filed? Did connections get articulated or just marked? Did descriptions get written to enable retrieval or just satisfy a template? Since [[throughput matters more than accumulation]], throughput measures processing completed, not structure created. And since [[intermediate packets enable assembly over creation]], the OUTPUT of processing should be composable packets — not just processed notes but building blocks that future work can assemble from. A session that processes content but produces nothing reusable has done the work without capturing its value. But structural metrics can produce false confidence: since [[metacognitive confidence can diverge from retrieval capability]], a system may appear healthy through coverage metrics (descriptions exist, links are dense, MOCs are organized) while actual retrieval fails. The organized graveyard at the retrieval layer is exactly this: Lazy Cornell extended to the discovery mechanism.
28
+ ---
29
+
30
+ Relevant Notes:
31
+ - [[insight accretion differs from productivity in knowledge systems]] — names the dichotomy: Lazy Cornell achieves productivity metrics (pages organized) while accreting nothing; the structural motions create productivity illusion without depth
32
+ - [[skills encode methodology so manual execution bypasses quality gates]] — skills prevent the Lazy Cornell failure mode by encoding the processing steps, not just the structural motions
33
+ - [[throughput matters more than accumulation]] — throughput measures processing completed, which is where value lives
34
+ - [[retrieval utility should drive design over capture completeness]] — the Lazy Cornell anti-pattern is the failure mode of capture-first thinking: structure without retrieval-focused processing creates no value
35
+ - [[the generation effect requires active transformation not just storage]] — defines what counts as processing: generation creates value, housekeeping (moving, tagging, organizing) does not
36
+ - [[each new note compounds value by creating traversal paths]] — compounding requires processing; unprocessed notes are disconnected nodes that cannot participate in value multiplication
37
+ - [[PKM failure follows a predictable cycle]] — Stage 2 (under-processing) is exactly this anti-pattern; this note provides the cognitive science explanation for why Stage 2 predicts later failures
38
+ - [[inline links carry richer relationship data than metadata fields]] — inline links with prose context ARE the semantic work; bare links are Lazy Cornell applied to linking
39
+ - [[orphan notes are seeds not failures]] — clarifies the orphan question: creating notes without immediate connections is NOT Lazy Cornell; the failure is abandonment, not creation
40
+ - [[verbatim risk applies to agents too]] — tests the agent-specific manifestation: agents producing well-structured summaries that reorganize content without generating insight; Lazy Cornell at LLM throughput
41
+ - [[schema templates reduce cognitive overhead at capture time]] — the antidote to Lazy Cornell: schema templates guide processing by specifying WHAT to generate; each field prompts a specific generative act
42
+ - [[guided notes might outperform post-hoc structuring for high-volume capture]] — another antidote: unlike Lazy Cornell's empty structure, guided note skeletons demand genuine cognitive work (identifying main points, flagging questions) while still reducing the design burden
43
+ - [[behavioral anti-patterns matter more than tool selection]] — provides the broader research context: Lazy Cornell is one of several behavioral patterns (alongside Collector's Fallacy, productivity porn, over-engineering) that kill vaults regardless of tool; the failure is upstream of the structural affordances
44
+ - [[generation effect gate blocks processing without transformation]] — concrete enforcement against Lazy Cornell: requires agent-generated artifact before any content can exit inbox, making structural motions without processing architecturally impossible
45
+ - [[intermediate packets enable assembly over creation]] — extends the processing insight: processing should produce composable packets, not just processed content; packets give processing outputs a reusable form
46
+ - [[writing for audience blocks authentic creation]] — performative mode as a form of Lazy Cornell: polishing prose and adding context for imagined readers is structural work (presentation) that substitutes for generative work (synthesis); structure dressed as processing
47
+ - [[ThreadMode to DocumentMode transformation is the core value creation step]] — names the wiki pathology this anti-pattern produces: ThreadMode with structural formatting is exactly Lazy Cornell — drawing wiki link lines and folder structure without transforming chronological threads into timeless synthesis
48
+ - [[vibe notetaking is the emerging industry consensus for AI-native self-organization]] — industry-scale Lazy Cornell: most AI-native tools implement organization as automated tagging and embedding clustering — structural motions that sort without transforming
49
+ - [[storage versus thinking distinction determines which tool patterns apply]] — scope qualifier: the Lazy Cornell anti-pattern is specifically a thinking-system failure applied to a thinking context; a storage system that files documents accurately without transforming them IS working correctly; structure-without-processing is only valueless when the system's purpose is synthesis
50
+ - [[every knowledge domain shares a four-phase processing skeleton that diverges only in the process step]] — structural diagnosis: the Lazy Cornell failure is precisely a pipeline running with an empty process step; capture, connect, and verify still execute but the phase carrying domain-specific value creation is hollow
51
+ - [[maintenance operations are more universal than creative pipelines because structural health is domain-invariant]] — the complementary failure: creation without maintenance produces graveyards, but the undervaluation asymmetry runs in both directions; processing is glamorous and maintenance is invisible, so Lazy Cornell represents the processing gap while neglected maintenance represents a structural health gap that is harder to detect because the creative output still looks alive
52
+ - [[MOC construction forces synthesis that automated generation from metadata cannot replicate]] — navigation-layer Lazy Cornell: automated MOC generation from topic metadata produces structurally valid MOCs that list notes under headings without the orientation synthesis, tension identification, or context phrase creation that make MOCs useful; the Dump-Lump-Jump pattern reveals that the Jump phase IS the processing this note argues structure cannot replace
53
+
54
+ Topics:
55
+ - [[note-design]]
56
+ - [[processing-workflows]]