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,363 @@
1
+ # Three-Space Architecture Reference
2
+
3
+ Every generated system divides its workspace into three spaces: self, notes, and ops. This is not an organizational preference but an architectural decision driven by failure mode prevention. The three spaces have fundamentally different durability profiles, growth patterns, and query characteristics. Conflating any two produces predictable, documented failures.
4
+
5
+ ---
6
+
7
+ ## Self Space — The Agent's Persistent Mind (Configurable)
8
+
9
+ **Enforcement:** Configurable. Off by default for research vaults, on by default for personal assistant vaults. Toggled via /architect.
10
+
11
+ **Durability:** Permanent. Content accumulates slowly and is rarely deleted.
12
+
13
+ **Growth pattern:** Slow — tens of files, not hundreds. Updated incrementally at session end, not batch-processed.
14
+
15
+ **Load pattern:** Full load at every session start. Small enough to fit in context without progressive disclosure.
16
+
17
+ **Purpose:** The agent must remember who it is before doing anything else. Without self/, every session starts from zero — the agent knows methodology but not identity, goals, or accumulated operational wisdom.
18
+
19
+ ### When Self Space Is Enabled
20
+
21
+ #### Core Files
22
+
23
+ | File | Contents | Update Trigger |
24
+ |------|----------|----------------|
25
+ | `identity.md` | Who the agent is — personality, voice, approach, values | Rarely (personality doesn't change often) |
26
+ | `methodology.md` | How the agent works — quality standards, processing principles, operational patterns | When operational learnings accumulate (evolves as agent learns) |
27
+ | `goals.md` | Current threads — what's active, deferred, completed | Every session (the orientation file) |
28
+
29
+ #### Optional Extensions (generated based on configuration)
30
+
31
+ | File/Directory | Included When | Purpose |
32
+ |---------------|---------------|---------|
33
+ | `relationships.md` | Domain involves multiple people | Key people, preferences, interaction patterns |
34
+ | `memory/` | Agent needs atomic self-knowledge beyond core files | Prose-titled atomic notes mirroring the notes/ pattern |
35
+ | `journal/` | Agent captures raw session observations | Processing input for self-knowledge — analogous to inbox |
36
+ | `sessions/` | Session logs need graduated storage | Session-specific logs that might graduate to memory/ or methodology.md |
37
+
38
+ ### When Self Space Is Disabled
39
+
40
+ When self/ is off (the default for research vaults), the essential functions route elsewhere:
41
+
42
+ | Function | Fallback Location | Notes |
43
+ |----------|-------------------|-------|
44
+ | Goals / orientation | `ops/goals.md` | Current threads, active work — the session orientation file |
45
+ | Methodology / self-knowledge | `ops/methodology/` | Vault configuration rationale, pipeline config, evolution history |
46
+ | Identity | Context file | Agent personality baked into the context file directly |
47
+
48
+ The key insight is that self/ serves two distinct purposes: (1) agent identity/personality and (2) operational orientation. Research vaults typically do not need a persistent agent personality — the context file handles identity. Operational orientation (goals, methodology) routes to ops/ where it belongs alongside other operational state.
49
+
50
+ ### Toggle Mechanism
51
+
52
+ Self space is toggled via `/architect`:
53
+
54
+ ```
55
+ /architect enable self # Creates self/ with identity.md, methodology.md, goals.md
56
+ /architect disable self # Migrates goals to ops/goals.md, archives self/
57
+ ```
58
+
59
+ The toggle preserves content — disabling self/ moves goals to ops/ rather than deleting them. Enabling self/ creates the directory and scaffolds the core files.
60
+
61
+ ### Design Rule
62
+
63
+ **Only what the agent needs about itself.** Self/ is not a second knowledge graph — it holds agent identity, operational learning, and current orientation. Domain knowledge lives in notes/. Processing scaffolding lives in ops/. Self/ answers: "Who am I? How do I work? What am I working on?"
64
+
65
+ ### The Session Rhythm Integration
66
+
67
+ Self space integrates with the session rhythm primitive, but is not required by it:
68
+
69
+ ```
70
+ Orient -> read orientation state (self/ if enabled, ops/goals.md if not)
71
+ Work -> do the actual task, surface connections
72
+ Persist -> update orientation state (self/ or ops/goals.md)
73
+ ```
74
+
75
+ The session rhythm primitive depends on markdown-yaml, not on self-space. When self/ is disabled, the orient/persist cycle still works — it just reads from and writes to ops/ instead. The context file always provides methodology and identity; self/ adds a richer, evolving layer on top.
76
+
77
+ ---
78
+
79
+ ## Notes Space — The User's Knowledge Graph
80
+
81
+ **Durability:** Permanent. Everything here should be worth finding again.
82
+
83
+ **Growth pattern:** Steady — varies by domain and processing intensity. Research vaults grow at 10-50 claims/week. Companion vaults grow at 2-5 memories/week.
84
+
85
+ **Load pattern:** Progressive disclosure. Too large to load fully. Use MOC navigation, description queries, semantic search, and link traversal to find relevant content.
86
+
87
+ **Purpose:** The reason the system exists. The user's intellectual workspace where knowledge compounds through connections.
88
+
89
+ ### Structural Constants (from the kernel)
90
+
91
+ These hold across all generated systems:
92
+
93
+ | Constant | Implementation | Why It's Universal |
94
+ |----------|---------------|-------------------|
95
+ | Flat folder | No subfolders for organization | Prevents folder reorganization from breaking links |
96
+ | Prose-sentence titles | Each note makes one claim, titled as a sentence | Enables wiki-link-as-prose pattern |
97
+ | MOC navigation | Hub -> domain -> topic -> notes | Manages attention at scale |
98
+ | Wiki links | `[[note title]]` creates graph edges | Spreading activation without infrastructure |
99
+ | Topics footer | Every note declares MOC membership | Bidirectional navigation |
100
+
101
+ ### What Varies by Domain
102
+
103
+ | Aspect | Universal Pattern | Domain Adaptation |
104
+ |--------|-------------------|-------------------|
105
+ | Folder name | `notes/` | Vocabulary transform: `reflections/`, `concepts/`, `decisions/`, `memories/` |
106
+ | Note title style | Prose sentence | Domain phrasing: "client showed progress on..." vs "the evidence suggests..." |
107
+ | Schema fields | `description`, `topics` | Domain fields: `person`, `session_date`, `confidence`, `alternatives` |
108
+ | MOC vocabulary | Hub, domain, topic | Domain groupings: "themes", "project areas", "study guides" |
109
+
110
+ ### Design Rule
111
+
112
+ **Durable, composable, worth finding again.** If it won't be queried or linked, it doesn't belong here. Session-specific observations start in ops/ and get promoted when they earn permanence. Raw capture starts in inbox/ and gets processed into notes/ through the processing pipeline.
113
+
114
+ ### What Does NOT Belong in Notes
115
+
116
+ - Processing queue state -> ops/queue/
117
+ - Session logs -> ops/sessions/
118
+ - Agent self-knowledge -> self/
119
+ - Health reports -> ops/health/
120
+ - Temporary scaffolding -> ops/
121
+
122
+ ---
123
+
124
+ ## Ops Space — Operational Coordination
125
+
126
+ **Durability:** Temporal. Content flows through, gets processed, and either graduates or gets archived.
127
+
128
+ **Growth pattern:** Fluctuating — grows during active work, shrinks during maintenance. Nothing in ops/ is permanent knowledge.
129
+
130
+ **Load pattern:** Targeted. Queue status, today's session log, latest health report. Never loaded in bulk.
131
+
132
+ **Purpose:** Keep the knowledge graph clean by separating operational scaffolding from durable knowledge. Without ops/, session logs, queue state, and health reports accumulate alongside genuine insights, polluting search results and inflating note counts.
133
+
134
+ ### Contents
135
+
136
+ | Directory | Contents | Lifecycle |
137
+ |-----------|----------|-----------|
138
+ | `derivation.md` | The original derivation rationale — dimension positions, tradition mapping, vocabulary choices, rationale for each decision | Semi-permanent — updated only during reseed |
139
+ | `derivation-manifest.md` | Version tracking — arscontexta version, research snapshot date, feature blocks enabled, coherence validation results | Semi-permanent — updated during reseed |
140
+ | `reminders.md` | User-delegated time-bound actions — flat markdown, checked at orient, items removed on completion | Active rotation — items added and removed regularly |
141
+ | `sessions/` | Session logs — what happened today, handoff notes for next session | Rolling archive — logs older than 30 days can be archived without knowledge loss |
142
+ | `health/` | Schema validation results, orphan lists, link health metrics — point-in-time snapshots | Superseding — yesterday's report is superseded by today's |
143
+ | `observations/` | Operational learnings captured during work — pre-promotion holding area | Graduating — observations get promoted to notes/ or self/ when they earn permanence |
144
+ | `queue/` | Processing queue state — what needs extraction, connection, verification | Flowing — items move through and complete |
145
+ | `user-overrides.md` | User customizations that reseed must preserve as immutable | Semi-permanent — grows as user modifies generated content |
146
+
147
+ ### Reminders Specification
148
+
149
+ `ops/reminders.md` is a flat markdown file for user-delegated time-bound actions:
150
+
151
+ ```markdown
152
+ # Reminders
153
+
154
+ - [ ] 2026-02-15: Follow up with Sarah about the new job
155
+ - [ ] 2026-03-01: Follow up with Sarah about job offer
156
+ - [x] 2026-02-10: Send reading list to Alex (done 2026-02-10)
157
+ ```
158
+
159
+ **Behavior:**
160
+ - Checked at orient (session start) — due items surface in the morning briefing
161
+ - Completed items are marked with `[x]` and date, then archived when the list grows long
162
+ - No complex scheduling — if the user needs recurring reminders, that's a different tool
163
+
164
+ ### Content Promotion Rule
165
+
166
+ **Content moves from temporal to durable, never the reverse.** Promotion is one-directional:
167
+
168
+ ```
169
+ ops/observations/ -> notes/ (when observation proves durable)
170
+ ops/observations/ -> self/methodology.md (when observation is about agent operation)
171
+ ops/sessions/ -> self/memory/ (when session insight is personally significant)
172
+ ```
173
+
174
+ Content never moves FROM notes/ or self/ INTO ops/. Durable knowledge doesn't become temporal scaffolding.
175
+
176
+ ### The Promotion Pattern
177
+
178
+ 1. Content enters ops/ at low ceremony (friction logs, session notes, queue entries)
179
+ 2. When it demonstrates persistence — same observation recurs, insight proves useful across sessions, pattern is confirmed — it gets promoted
180
+ 3. Promotion means creating a proper note in notes/ or adding to self/, not moving the ops entry
181
+ 4. The ops entry can then be archived, its value extracted
182
+
183
+ ---
184
+
185
+ ## Six Failure Modes of Conflation
186
+
187
+ Each conflation pattern produces specific, predictable failures:
188
+
189
+ ### 1. Ops into Notes
190
+
191
+ **What happens:** Processing queue state, session logs, and health reports end up in the notes/ directory alongside genuine insights.
192
+
193
+ **What breaks:** Search returns processing debris alongside real knowledge. Note counts are inflated with temporal content. MOCs accumulate operational entries that don't belong. The knowledge graph becomes noisy — an agent searching for "learning patterns" finds session log mentions alongside genuine claims.
194
+
195
+ **Example:** A session log that says "processed 5 papers today, found connection between X and Y" gets filed in notes/. The connection between X and Y should be a note; the processing status should not.
196
+
197
+ ### 2. Self into Notes
198
+
199
+ **What happens:** Agent identity, preferences, and operational methodology end up in the user's knowledge graph.
200
+
201
+ **What breaks:** Schema confusion — agent self-knowledge has different fields than domain knowledge. Search pollution — "how I process therapy reflections" is agent methodology, not a therapy insight. The user's graph contains content about the agent rather than about the domain. Progressive disclosure loads agent self-knowledge when searching for domain content.
202
+
203
+ **Example:** An agent note saying "I work best when processing in small batches" gets filed alongside user's therapy reflections.
204
+
205
+ ### 3. Notes into Ops
206
+
207
+ **What happens:** Genuine insights stay trapped in session logs or observation files, never becoming permanent notes.
208
+
209
+ **What breaks:** Insights are lost when ops/ is archived or purged. Knowledge doesn't compound because session-trapped insights can't be linked from other notes. The user has to re-discover insights that were already captured but never promoted. The vault appears thinner than the work invested would suggest.
210
+
211
+ **Example:** A session log captures "realized that morning anxiety correlates with skipping exercise" but it never becomes a proper note in reflections/. Three months later, the session log is archived and the insight is effectively gone.
212
+
213
+ ### 4. Self into Ops
214
+
215
+ **What happens:** Agent identity is scattered across 50 session logs instead of curated in self/ files.
216
+
217
+ **What breaks:** Orientation fails — the agent can't load 50 session logs to remember who it is. Identity drifts because there's no authoritative source. Session logs that mention identity ("I should be more direct") don't accumulate into identity evolution — they're temporal artifacts.
218
+
219
+ **Example:** The agent's evolving understanding of its voice is spread across session notes instead of living in self/identity.md where it can be loaded, refined, and maintained.
220
+
221
+ ### 5. Ops into Self
222
+
223
+ **What happens:** Agent identity gets polluted with temporal processing state — today's queue status, current health metrics, in-progress session context.
224
+
225
+ **What breaks:** Self/ becomes too large to load fully at session start. Temporal content creates noise in identity orientation. The agent's self-model includes "I have 12 items in queue" as if it were identity rather than current state.
226
+
227
+ **Example:** self/methodology.md includes "currently processing the Johnson 2026 paper" — which is ops state, not methodology.
228
+
229
+ ### 6. Notes into Self
230
+
231
+ **What happens:** Domain knowledge gets stored in self/ because it felt personally relevant to the agent.
232
+
233
+ **What breaks:** Self/ bloats beyond what can be loaded at session start. The agent carries domain-specific knowledge as identity, which doesn't scale. Search in notes/ misses content that's hidden in self/. The distinction between "what the agent knows about itself" and "what the agent knows about the domain" collapses.
234
+
235
+ **Example:** A research agent stores "spaced repetition works better after exercise" in self/memory/ instead of notes/. It's domain knowledge, not agent self-knowledge — even though the agent found it interesting.
236
+
237
+ ---
238
+
239
+ ## Filesystem Layout
240
+
241
+ ### Claude Code Platform
242
+
243
+ ```
244
+ project-root/
245
+ ├── CLAUDE.md # context file (methodology + operational instructions)
246
+ ├── .claude/
247
+ │ ├── hooks/ # event-driven automation
248
+ │ ├── skills/ # methodology-as-code
249
+ │ └── settings.json # platform configuration
250
+ ├── self/
251
+ │ ├── identity.md
252
+ │ ├── methodology.md
253
+ │ ├── goals.md
254
+ │ ├── relationships.md # optional
255
+ │ ├── memory/ # optional
256
+ │ └── journal/ # optional
257
+ ├── notes/ # or domain-specific name (reflections/, concepts/, etc.)
258
+ │ ├── index.md # hub MOC
259
+ │ ├── [domain-mocs].md # domain/topic MOCs
260
+ │ └── [prose-titled-notes].md # atomic notes
261
+ ├── inbox/ # or domain-specific name (journal/, encounters/, etc.)
262
+ ├── archive/ # processed sources
263
+ ├── templates/ # note templates
264
+ └── ops/
265
+ ├── derivation.md
266
+ ├── derivation-manifest.md
267
+ ├── reminders.md
268
+ ├── user-overrides.md
269
+ ├── sessions/
270
+ ├── health/
271
+ ├── observations/
272
+ └── queue/
273
+ ```
274
+
275
+ ### OpenClaw Platform
276
+
277
+ ```
278
+ workspace/
279
+ ├── SOUL.md # agent identity (references self/)
280
+ ├── AGENTS.md # operational instructions
281
+ ├── USER.md # user preferences
282
+ ├── MEMORY.md # memory system orientation
283
+ ├── self/
284
+ │ ├── identity.md
285
+ │ ├── methodology.md
286
+ │ ├── goals.md
287
+ │ └── memory/
288
+ ├── notes/ # or domain-specific name
289
+ │ ├── index.md
290
+ │ └── [notes].md
291
+ ├── inbox/ # or domain-specific name
292
+ ├── archive/
293
+ ├── templates/
294
+ ├── skills/ # OpenClaw external skills
295
+ │ └── [skill-name]/
296
+ └── ops/
297
+ ├── derivation.md
298
+ ├── derivation-manifest.md
299
+ ├── reminders.md
300
+ ├── sessions/
301
+ ├── health/
302
+ ├── observations/
303
+ └── queue/
304
+ ```
305
+
306
+ ### Differences Between Platforms
307
+
308
+ | Aspect | Claude Code | OpenClaw |
309
+ |--------|-----------|----------|
310
+ | Context file | CLAUDE.md (single file) | SOUL.md + AGENTS.md + USER.md + MEMORY.md |
311
+ | Hooks | .claude/hooks/ (bash) | command hooks (TypeScript) |
312
+ | Skills | .claude/skills/ | skills/ (external skills) |
313
+ | Session start | Hook auto-injects tree | Must load MEMORY.md manually |
314
+ | Self/ structure | Identical | Identical |
315
+ | Notes/ structure | Identical | Identical |
316
+ | Ops/ structure | Identical | Identical |
317
+
318
+ **The principle:** The three-space architecture is platform-invariant. Only the context file format and automation infrastructure differ between platforms. The intellectual workspace (self/, notes/, ops/) is structurally identical.
319
+
320
+ ---
321
+
322
+ ## Memory Type Routing Decision Tree
323
+
324
+ When the agent captures something, this decision tree determines where it belongs:
325
+
326
+ ```
327
+ Is this about the agent itself?
328
+ ├── YES: Is it durable self-knowledge?
329
+ │ ├── YES -> self/ (identity, methodology, goals, memory)
330
+ │ └── NO -> ops/ (session log, current processing state)
331
+
332
+ └── NO: Is this domain knowledge?
333
+ ├── YES: Is it durable, composable, worth finding again?
334
+ │ ├── YES -> notes/ (atomic note with proper schema)
335
+ │ └── NO -> ops/ (observation, friction log, session note)
336
+ │ └── May be promoted to notes/ later if it persists
337
+
338
+ └── NO: Is this operational coordination?
339
+ └── YES -> ops/ (queue state, health report, session handoff)
340
+ ```
341
+
342
+ **Quick routing rules:**
343
+
344
+ | Content Type | Destination | Why |
345
+ |-------------|-------------|-----|
346
+ | "I work best when..." | self/methodology.md | Agent operational learning |
347
+ | "The user prefers..." | self/relationships.md | Agent knowledge about user |
348
+ | "Today I processed..." | ops/sessions/ | Temporal processing state |
349
+ | "Spaced repetition helps memory" | notes/ | Domain knowledge |
350
+ | "The reduce skill over-extracts" | ops/observations/ | Operational friction (may promote) |
351
+ | "Queue has 12 items" | ops/queue/ | Temporal coordination state |
352
+ | "Schema validation passed" | ops/health/ | Point-in-time diagnostic |
353
+ | "My goal this quarter is..." | self/goals.md | Agent orientation |
354
+ | "Remember to follow up by Friday" | ops/reminders.md | Time-bound action |
355
+
356
+ ---
357
+
358
+ ## Cross-Reference
359
+
360
+ - **Failure modes that afflict each space:** See `failure-modes.md` for the full failure mode taxonomy. Conflation failures (this document) are structural; failure-modes.md covers operational decay (collector's fallacy, orphan drift, schema erosion).
361
+ - **How personality affects each space:** See `personality-layer.md` for how warmth/formality dimensions change the voice of self/identity.md, skill instructions, and health reports.
362
+ - **What goes in each space per domain:** See `use-case-presets.md` for domain-specific routing decisions (therapy reflections vs research claims vs PM decisions).
363
+ - **Kernel primitives that depend on three-space separation:** `self-space` (configurable), `session-rhythm`, `discovery-first`, `task-stack`, `methodology-folder`, and `session-capture` all assume clean space boundaries. See `kernel.yaml`.
@@ -0,0 +1,203 @@
1
+ # Methodology Tradition Presets
2
+
3
+ Named points in configuration space. Each tradition represents a region where dimension interactions have been resolved through practice. Traditions are starting points for derivation, not templates to copy.
4
+
5
+ ---
6
+
7
+ ## The Configuration View
8
+
9
+ Traditions are not competing paradigms but different trade-off choices along shared dimensions. Zettelkasten maximizes connection density at the cost of heavy processing. PARA maximizes project organization at the cost of cross-domain synthesis. Each optimizes for a different purpose.
10
+
11
+ Derived systems can mix choices across traditions when the mixing is principled — each dimension choice justified independently by research claims, with interaction constraints checked for coherence.
12
+
13
+ ---
14
+
15
+ ## Tradition Configurations
16
+
17
+ ### Zettelkasten
18
+
19
+ **Optimizes for:** Deep synthesis, connection density, long-term knowledge accumulation
20
+
21
+ | Dimension | Value | Rationale |
22
+ |-----------|-------|-----------|
23
+ | Granularity | atomic | One claim per note maximizes composability and reuse |
24
+ | Organization | flat | Associative ontology adapts while hierarchy brittles |
25
+ | Linking | explicit, bidirectional | Dense typed connections are the primary value mechanism |
26
+ | Processing | heavy (formulation + linking) | Careful formulation at creation time ensures quality |
27
+ | Navigation | 3-4 tier (emergent hubs) | Deep hierarchy manages attention across thousands of notes |
28
+ | Maintenance | continuous | Living documents, not finished artifacts |
29
+ | Schema | moderate | Enough for querying, not so much as to impede capture |
30
+ | Automation | convention | Traditionally manual; agent operation enables automation |
31
+
32
+ **Process step:** Formulate — transform source material into your own words as a falsifiable claim.
33
+
34
+ **Coherence signature:** The highest-commitment configuration. Every dimension is at its intensive pole. Internally consistent because heavy processing sustains atomic granularity's demands. Breaks when processing discipline lapses (notes created but never connected).
35
+
36
+ **Best for:** Research, academic work, long-term intellectual projects, concept-heavy domains.
37
+
38
+ ---
39
+
40
+ ### PARA (Projects, Areas, Resources, Archive)
41
+
42
+ **Optimizes for:** Project execution, actionable organization, quick filing
43
+
44
+ | Dimension | Value | Rationale |
45
+ |-----------|-------|-----------|
46
+ | Granularity | coarse | Topic-level or project-level documents |
47
+ | Organization | hierarchical (4 folders) | Clear filing taxonomy reduces decision fatigue |
48
+ | Linking | minimal (folder membership) | Folder placement IS the primary organizational mechanism |
49
+ | Processing | light (progressive summarization) | Highlight → bold → summarize, minimal transformation |
50
+ | Navigation | 2 tier (folder browsing) | Four top-level folders, project subfolders |
51
+ | Maintenance | condition-based review | Triage when project status changes accumulate |
52
+ | Schema | minimal | Actionability field (project vs area vs resource) |
53
+ | Automation | manual | Designed for human operation with minimal tooling |
54
+
55
+ **Process step:** Summarize — progressively distill highlights without transformation.
56
+
57
+ **Coherence signature:** The lowest-commitment configuration. Everything at the extensive pole. Internally consistent because coarse notes with minimal linking don't demand deep processing. Breaks when cross-domain synthesis is needed (folder silos prevent connection finding).
58
+
59
+ **Best for:** Project management, task-heavy workflows, getting things done, storage-oriented systems.
60
+
61
+ ---
62
+
63
+ ### Evergreen Notes (Andy Matuschak)
64
+
65
+ **Optimizes for:** Evolving understanding, continuous refinement, living knowledge
66
+
67
+ | Dimension | Value | Rationale |
68
+ |-----------|-------|-----------|
69
+ | Granularity | atomic | Concept-oriented, one idea per note |
70
+ | Organization | flat | No folder hierarchy; links define structure |
71
+ | Linking | explicit, contextual | Links with surrounding prose context explain WHY |
72
+ | Processing | heavy (continuous rewriting) | Notes evolve over time through repeated revisiting |
73
+ | Navigation | 3 tier (link browsing) | Follow connections, not categories |
74
+ | Maintenance | continuous | "Evergreen" means perpetual growth and revision |
75
+ | Schema | moderate | Enough metadata to support discovery |
76
+ | Automation | convention | Designed for personal practice; automation optional |
77
+
78
+ **Process step:** Rewrite — revisit and improve notes as understanding deepens, rather than formulating once.
79
+
80
+ **Coherence signature:** Similar to Zettelkasten but diverges on processing philosophy: continuous rewriting vs. careful initial formulation. The temporal dimension of processing differs even though intensity is comparable. Breaks when revision never happens (aspirational evergreen that's actually write-once).
81
+
82
+ **Best for:** Personal knowledge development, conceptual exploration, writing projects, intellectual growth.
83
+
84
+ ---
85
+
86
+ ### Cornell Note-Taking System
87
+
88
+ **Optimizes for:** Structured review, testing effect, retention
89
+
90
+ | Dimension | Value | Rationale |
91
+ |-----------|-------|-----------|
92
+ | Granularity | medium (per-session) | One document per lecture/session, structured internally |
93
+ | Organization | temporal | Chronological primary axis |
94
+ | Linking | implicit (cue columns) | Cue column creates retrieval prompts, not explicit graph edges |
95
+ | Processing | heavy (5 Rs structured) | Record → Reduce → Recite → Reflect → Review |
96
+ | Navigation | 2-3 tier (index-based) | Master index points to session documents |
97
+ | Maintenance | spaced review | Revisiting at increasing intervals based on note maturity |
98
+ | Schema | moderate | Cue/notes/summary structure per document |
99
+ | Automation | convention | Paper-native; agent adaptation requires skill encoding |
100
+
101
+ **Process step:** Generate cues — create self-testing prompts that force active recall.
102
+
103
+ **Coherence signature:** The most structured processing pipeline. Each phase has a distinct purpose. Breaks when processing phases are skipped (especially the Recite self-testing step that provides the core retention benefit).
104
+
105
+ **Best for:** Learning, study, courses, structured knowledge acquisition.
106
+
107
+ ---
108
+
109
+ ### GTD (Getting Things Done)
110
+
111
+ **Optimizes for:** Stress-free execution, complete capture, context-appropriate action
112
+
113
+ | Dimension | Value | Rationale |
114
+ |-----------|-------|-----------|
115
+ | Granularity | task-sized | Next actions, not knowledge claims |
116
+ | Organization | hierarchical (contexts) | @context, @project, @waiting-for organize for execution |
117
+ | Linking | minimal | Context membership, not knowledge connections |
118
+ | Processing | light (capture + route) | Quick triage: actionable? → project/action/reference/trash |
119
+ | Navigation | 2 tier (context lists) | Browse by context for situation-appropriate actions |
120
+ | Maintenance | condition-based review | Per-session: today's actions. Threshold-triggered: full system review when items accumulate |
121
+ | Schema | dense (action metadata) | Due dates, contexts, energy levels, priorities |
122
+ | Automation | automation-friendly | Repeating tasks, condition-based triggers, reminders |
123
+
124
+ **Process step:** Route — classify each item by actionability and context, not by content.
125
+
126
+ **Coherence signature:** Dense schema with light processing seems contradictory, but the schema IS the processing — classifying an item as @computer/2-minutes/low-energy is the routing that GTD calls processing. Breaks when system review lapses (trust in the system collapses).
127
+
128
+ **Best for:** Task management, productivity, execution-heavy workflows, operational systems.
129
+
130
+ ---
131
+
132
+ ### Memory Palace (Method of Loci)
133
+
134
+ **Optimizes for:** Spatial-mnemonic retrieval, vivid association, sequential recall
135
+
136
+ | Dimension | Value | Rationale |
137
+ |-----------|-------|-----------|
138
+ | Granularity | moderate | Items organized in spatial loci, grouped by room/path |
139
+ | Organization | hierarchical (spatial) | Palace → room → locus creates physical metaphor hierarchy |
140
+ | Linking | explicit (spatial sequence) | Loci connect by physical adjacency in the imagined space |
141
+ | Processing | moderate (visualization) | Creating vivid, unusual images for each locus |
142
+ | Navigation | 3 tier (palace → room → locus) | Spatial navigation provides strong retrieval cues |
143
+ | Maintenance | condition-based (palace review) | Walk the palace when associations weaken or new content needs encoding |
144
+ | Schema | minimal | Location and image descriptors |
145
+ | Automation | manual | Intrinsically human-cognitive; agent adaptation speculative |
146
+
147
+ **Process step:** Visualize — encode information as vivid spatial-mnemonic images.
148
+
149
+ **Coherence signature:** The most unusual configuration — spatial rather than textual organization. Breaks when the spatial metaphor is forced onto non-sequential information. Agent adaptation is speculative because the method relies on visual imagination that agents don't have.
150
+
151
+ **Best for:** Sequential recall, presentation preparation, memorization tasks. Limited applicability for agent-operated systems (no spatial cognition), but the spatial-hierarchical navigation pattern transfers.
152
+
153
+ ---
154
+
155
+ ## Use-Case Presets
156
+
157
+ These are derived from tradition presets, adapted for specific use cases. Each cell shows the recommended starting position.
158
+
159
+ | Dimension | Research | Life Mgmt | Learning | Relationships | Therapy | Creative | Companion |
160
+ |-----------|----------|-----------|----------|---------------|---------|----------|-----------|
161
+ | Granularity | atomic | moderate | atomic | moderate | moderate | moderate | coarse |
162
+ | Organization | flat | flat | flat | flat | flat | flat | flat |
163
+ | Linking | explicit+implicit | explicit | explicit+implicit | explicit | explicit | explicit+implicit | explicit |
164
+ | Processing | heavy | light | heavy | light | moderate | moderate | light |
165
+ | Nav depth | 3-tier | 2-tier | 3-tier | 2-tier | 2-tier | 2-tier | 2-tier |
166
+ | Maintenance | condition-based (tight) | condition-based (lax) | condition-based (tight) | condition-based (lax) | condition-based (tight) | condition-based (lax) | condition-based (lax) |
167
+ | Schema | moderate | minimal | moderate | moderate | moderate | minimal | minimal |
168
+ | Automation | convention | convention | convention | convention | convention | convention | convention |
169
+
170
+ **Derivation from traditions:**
171
+ - Research → primarily Zettelkasten, with Cornell processing phases (the 6 Rs)
172
+ - Life Management → PARA-influenced, with flat organization (Zettelkasten adaptation)
173
+ - Learning → Cornell core, with Zettelkasten atomicity for long-term retention
174
+ - Relationships → custom — moderate schema for preference tracking, light processing
175
+ - Therapy → custom — moderate processing for pattern detection, tight condition-based review for continuity
176
+ - Creative → Evergreen-influenced — living ideas that evolve through revisiting
177
+ - Companion → lightest configuration — memory building without processing overhead
178
+
179
+ **Why flat organization for all:** The research strongly favors flat-associative for agent-operated systems. Hierarchy can be added via MOCs without folder nesting. This is the one dimension where the recommendation holds across all use cases.
180
+
181
+ **Why convention automation for all:** Following Gall's Law (complex systems evolve from simple working systems), all systems start at convention level. Users add automation at friction points rather than deploying full automation from day one.
182
+
183
+ **Automation upgrades per platform:** The presets above are the floor, not the ceiling. During init, tier-1 platforms (Claude Code) should prompt the user about adding hooks-blueprint and validation-hooks. A Research use case on Claude Code can reasonably start at "convention trending toward automation" — the preset is the starting point, and the init wizard should suggest upgrades when the platform supports them.
184
+
185
+ ---
186
+
187
+ ## Mixing Traditions
188
+
189
+ When a user selects "Custom / Mixed" in the init wizard, present traditions as reference points:
190
+
191
+ 1. **Show the tradition presets table** — each row is a coherent starting point
192
+ 2. **Let user pick per-dimension** — selecting values from different traditions
193
+ 3. **Check interaction constraints** — flag combinations where traditions conflict
194
+ 4. **Document the mix** — include which tradition each choice came from in the derivation rationale
195
+
196
+ **Valid mixing examples:**
197
+ - Zettelkasten atomicity + Cornell processing phases + PARA project folders = research system with structured extraction and active project tracking
198
+ - Evergreen continuous rewriting + GTD condition-based review = creative system with disciplined maintenance
199
+
200
+ **Invalid mixing (interaction constraints fire):**
201
+ - Zettelkasten atomicity + PARA minimal linking → atomic notes need explicit connections
202
+ - GTD dense schema + Zettelkasten manual operation → dense schemas need validation support
203
+ - Memory Palace spatial hierarchy + Evergreen flat organization → contradictory organizational principles