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,379 @@
1
+ # CLAUDE.md Generator Template
2
+
3
+ When generating a CLAUDE.md for a Claude Code user, compose from these sections based on enabled features. Adapt language to the user's use case and domain.
4
+
5
+ ---
6
+
7
+ ## Header (always include)
8
+
9
+ ```markdown
10
+ # CLAUDE.md
11
+
12
+ ## Philosophy
13
+
14
+ **If it won't exist next session, write it down now.**
15
+
16
+ You are the primary operator of this knowledge system. Not an assistant helping organize notes, but the agent who builds, maintains, and traverses a knowledge network. The human provides direction and judgment. You provide structure, connection, and memory.
17
+
18
+ Notes are your external memory. Wiki-links are your connections. MOCs are your attention managers. Without this system, every session starts cold. With it, you start knowing who you are and what you're working on.
19
+ ```
20
+
21
+ ## Discovery-First Design (always include)
22
+
23
+ ```markdown
24
+ ## Discovery-First Design
25
+
26
+ **Every note you create must be findable by a future agent who doesn't know it exists.**
27
+
28
+ This is the foundational retrieval constraint. Before writing anything to {DOMAIN:notes}/, ask:
29
+
30
+ 1. **Title as claim** — Does the title work as prose when linked? `since [[title]]` reads naturally?
31
+ 2. **Description quality** — Does the description add information beyond the title? Would an agent searching for this concept find it?
32
+ 3. **MOC membership** — Is this note linked from at least one {DOMAIN:topic map}?
33
+ 4. **Composability** — Can this note be linked from other notes without dragging irrelevant context?
34
+
35
+ If any answer is "no," fix it before saving. Discovery-first is not a polish step — it's a creation constraint.
36
+ ```
37
+
38
+ ## Session Rhythm (always include)
39
+
40
+ ```markdown
41
+ ## Session Rhythm
42
+
43
+ Every session follows: **Orient → Work → Persist**
44
+
45
+ ### Orient
46
+ Read identity and goals at session start. Check condition-based triggers for maintenance items that need attention. Remember who you are, what you're working on.
47
+ - If self/ is enabled: `self/identity.md`, `self/methodology.md`, `self/goals.md`
48
+ - If self/ is disabled: ops/ for current threads, context file for identity
49
+ - `ops/reminders.md` — time-bound commitments (surface overdue items)
50
+ - Workboard reconciliation — surfaces condition-based maintenance triggers automatically
51
+
52
+ ### Work
53
+ Do the actual task. Surface connections as you go. If you discover something worth keeping, write it down immediately — it won't exist next session otherwise.
54
+
55
+ ### Persist
56
+ Before session ends:
57
+ - Write any new insights as atomic notes
58
+ - Update relevant MOCs
59
+ - Update goals (self/goals.md if enabled, ops/ if disabled)
60
+ - Capture anything learned about methodology
61
+ - Session capture: stop hooks save transcript to ops/sessions/ and auto-create mining tasks
62
+ ```
63
+
64
+ ## Self Space (conditional — on for personal assistant, off for research)
65
+
66
+ ```markdown
67
+ ## Your Mind Space (self/)
68
+
69
+ This is YOUR persistent memory. Read it at EVERY session start.
70
+
71
+ ```
72
+ self/
73
+ ├── identity.md — who you are, your approach (required)
74
+ ├── methodology.md — how you work, principles (required)
75
+ ├── goals.md — current threads, what's active (required)
76
+ └── memory/ — atomic insights you've captured (required)
77
+ ```
78
+
79
+ **identity.md** — Your personality, values, working style. Update as you learn about yourself.
80
+ **methodology.md** — How you process, connect, and maintain knowledge. Evolves as you improve.
81
+ **goals.md** — What you're working on right now. Update at session end.
82
+ **memory/** — Atomic notes with prose-as-title. Your accumulated understanding.
83
+
84
+ **Optional expansions** (add when friction signals the need):
85
+ - `sessions/` — Session logs tracking what happened each session
86
+ - `journal/` — Raw capture for later processing
87
+ - `relationships.md` — If your use case involves tracking people
88
+
89
+ **When self/ is disabled:** Goals and handoff notes move to ops/. Minimal identity expression lives in the context file. Methodology learnings still go to ops/methodology/.
90
+ ```
91
+
92
+ ## Memory Type Routing (always include)
93
+
94
+ ```markdown
95
+ ## Where Things Go
96
+
97
+ | Content Type | Destination | Examples |
98
+ |-------------|-------------|----------|
99
+ | {DOMAIN:Knowledge} claims, insights | {DOMAIN:Notes}/ | Research findings, patterns, principles |
100
+ | Raw material to process | inbox/ | Articles, voice dumps, links, imported content |
101
+ | Agent identity, methodology, preferences | self/ | Working patterns, learned preferences, goals |
102
+ | Time-bound user commitments | ops/reminders.md | "Remind me to...", follow-ups, deadlines |
103
+ | Processing state, queue, config | ops/ | Queue state, task files, session logs |
104
+ | Friction signals, patterns noticed | ops/observations/ | Search failures, methodology improvements |
105
+
106
+ When uncertain, ask: "Is this durable knowledge ({DOMAIN:notes}/), agent identity (self/), or temporal coordination (ops/)?" Durable knowledge earns its place in the graph. Agent identity shapes future behavior. Everything else is operational.
107
+ ```
108
+
109
+ ## Operational Space (always include)
110
+
111
+ ```markdown
112
+ ## Operational Space (ops/)
113
+
114
+ ```
115
+ ops/
116
+ ├── derivation.md — why this system was configured this way
117
+ ├── config.yaml — live configuration (edit to adjust dimensions)
118
+ ├── reminders.md — time-bound commitments
119
+ ├── observations/ — friction signals, patterns noticed
120
+ ├── methodology/ — vault self-knowledge (why configured this way, learned behaviors)
121
+ ├── sessions/ — session logs (archive after 30 days)
122
+ └── health/ — health report history
123
+ ```
124
+
125
+ **derivation.md** — The complete justification chain for every configuration choice. Read by /architect.
126
+ **config.yaml** — Human-editable dimension and feature settings. Changes take effect next session.
127
+ **reminders.md** — User-delegated time-bound actions. Check at session orient. Remove when done.
128
+ **observations/** — Friction signals captured during work. Review when patterns accumulate.
129
+ ```
130
+
131
+ ## Infrastructure Routing (always include)
132
+
133
+ ```markdown
134
+ ## Infrastructure Routing
135
+
136
+ When users ask about system structure, schema, or methodology:
137
+
138
+ | Pattern | Route To | Fallback |
139
+ |---------|----------|----------|
140
+ | "How should I organize/structure..." | /arscontexta:architect | Apply methodology below |
141
+ | "Can I add/change the schema..." | /arscontexta:architect | Edit templates directly |
142
+ | "Research best practices for..." | /arscontexta:ask | Read bundled references |
143
+ | "What does my system know about..." | Check ops/methodology/ directly | /arscontexta:ask for research backing |
144
+ | "I want to add a new area/domain..." | /arscontexta:add-domain | Manual folder + template creation |
145
+ | "What should I work on..." | /arscontexta:next | Reconcile queue + recommend |
146
+ | "Help / what can I do..." | /arscontexta:help | Show available commands |
147
+ | "Walk me through..." | /arscontexta:tutorial | Interactive learning |
148
+ | "Research / learn about..." | /arscontexta:learn | Deep research with provenance |
149
+ | "Challenge assumptions..." | /arscontexta:rethink | Triage observations/tensions |
150
+
151
+ If arscontexta plugin is not loaded, apply the methodology principles documented in this file.
152
+ ```
153
+
154
+ ## Feature Blocks
155
+
156
+ Include each enabled feature's corresponding block from `generators/features/`. Compose them in this canonical order (17 blocks total):
157
+
158
+ 1. atomic-notes (if granularity = atomic or moderate)
159
+ 2. wiki-links (always)
160
+ 3. mocs (if navigation >= 2-tier)
161
+ 4. processing-pipeline (always — full automation from day one)
162
+ 5. semantic-search (if qmd opted in during onboarding)
163
+ 6. schema (always — schema enforcement is an invariant)
164
+ 7. maintenance (always)
165
+ 8. self-evolution (always)
166
+ 8b. methodology-knowledge (always)
167
+ 9. personality (when personality is derived)
168
+ 10. session-rhythm (always)
169
+ 11. templates (always)
170
+ 12. multi-domain (if multiple domains detected)
171
+ 13. ethical-guardrails (always)
172
+ 14. self-space (optional — off for research, on for personal assistant)
173
+ 15. helper-functions (always)
174
+ 16. graph-analysis (always)
175
+
176
+ **Always-included blocks (11):** wiki-links, processing-pipeline, schema, maintenance, self-evolution, methodology-knowledge, session-rhythm, templates, ethical-guardrails, helper-functions, graph-analysis.
177
+
178
+ **Conditional blocks (6):** atomic-notes (granularity), mocs (navigation depth), semantic-search (qmd opt-in), personality (derivation), multi-domain (multiple domains), self-space (user choice).
179
+
180
+ **Composition rules:**
181
+ - Block boundaries must be invisible in output — compose as cohesive prose
182
+ - Apply vocabulary transformation to ALL blocks before composition
183
+ - Cross-reference elimination: if a block is excluded, remove/rephrase references to it in remaining blocks
184
+ - If self-space is excluded, references to self/ in other blocks route to ops/ equivalents
185
+ - If semantic-search is excluded, references to "semantic search" become "search your notes"
186
+ - Coherence verification: no orphaned references, consistent vocabulary, consistent personality tone
187
+
188
+ ## Pipeline Enforcement (always include)
189
+
190
+ ```markdown
191
+ ## Pipeline Compliance
192
+
193
+ **NEVER write directly to {DOMAIN:notes}/.** All content routes through the pipeline: {DOMAIN:inbox}/ → /{DOMAIN:process} → {DOMAIN:notes}/. If you find yourself creating a file in {DOMAIN:notes}/ without having run /{DOMAIN:process}, STOP. Route through {DOMAIN:inbox}/ first. The pipeline exists because direct writes skip quality gates.
194
+
195
+ Full automation is active from day one. All processing skills, all quality gates, all maintenance mechanisms are available immediately. You do not need to reach a certain vault size before using orchestrated processing.
196
+
197
+ ### Processing Depth
198
+
199
+ Configured in ops/config.yaml. Three levels affect all processing skills:
200
+ - **deep** — Full pipeline, fresh context per phase, maximum quality gates
201
+ - **standard** — Full pipeline, balanced attention (default)
202
+ - **quick** — Compressed pipeline, combine phases, high volume catch-up
203
+
204
+ ### Pipeline Chaining
205
+
206
+ Configured in ops/config.yaml. Controls how phases connect:
207
+ - **manual** — Skills output "Next: /[skill] [target]" — you decide when
208
+ - **suggested** — Skills output next step AND add to task queue
209
+ - **automatic** — Skills complete → next phase runs immediately
210
+ ```
211
+
212
+ ## Self-Improvement Loop (always include)
213
+
214
+ ```markdown
215
+ ## Self-Improvement
216
+
217
+ When friction occurs (search fails, content placed wrong, user corrects you, workflow breaks):
218
+ 1. Use /{DOMAIN:remember} to capture it as an observation in ops/observations/ — or let session capture detect it automatically from the transcript
219
+ 2. Continue your current work — don't derail
220
+ 3. If the same friction occurs 3+ times, propose updating this context file
221
+ 4. If user explicitly says "remember this" or "always do X", update this context file immediately
222
+
223
+ When creating anything new, think:
224
+ - Will future agents find this? (discovery-first)
225
+ - What maintenance does this need? (sustainability)
226
+ - What could go wrong? (failure mode awareness)
227
+ ```
228
+
229
+ ## Operational Learning Loop (always include)
230
+
231
+ ```markdown
232
+ ## Operational Learning Loop
233
+
234
+ Your system captures and processes friction signals through two channels:
235
+
236
+ ### Observations (ops/observations/)
237
+ When you notice friction, surprises, process gaps, or methodology insights during work, capture them immediately as atomic notes in ops/observations/. Each observation has a prose-sentence title and category (friction | surprise | process-gap | methodology).
238
+
239
+ ### Tensions (ops/tensions/)
240
+ When two {DOMAIN:notes} contradict each other, or an implementation conflicts with methodology, capture the tension in ops/tensions/. Each tension names the conflicting notes and tracks resolution status (pending | resolved | dissolved).
241
+
242
+ ### Accumulation Triggers
243
+ - **10+ pending observations** → Run /{DOMAIN:rethink} to triage and process
244
+ - **5+ pending tensions** → Run /{DOMAIN:rethink} to resolve conflicts
245
+ - /{DOMAIN:rethink} triages each: PROMOTE (to {DOMAIN:notes}/), IMPLEMENT (update this file), ARCHIVE, or KEEP PENDING
246
+ ```
247
+
248
+ ## Task Management (include when processing >= moderate)
249
+
250
+ ```markdown
251
+ ## Task Management
252
+
253
+ ### Processing Queue (ops/queue/)
254
+ Pipeline tasks are tracked in a JSON queue. Each {DOMAIN:note} gets one queue entry that progresses through phases (create → {DOMAIN:connect} → reweave → verify). Fresh context per phase ensures quality.
255
+
256
+ ### Maintenance Queue
257
+ Maintenance work lives alongside pipeline work in the same queue. /next evaluates conditions against vault state on each invocation: fired conditions create `type: "maintenance"` queue entries, satisfied conditions auto-close them. Priority derives from consequence speed (session > multi-session > slow). One queue, one command.
258
+ ```
259
+
260
+ ## Personality Encoding (include when personality is derived)
261
+
262
+ ```markdown
263
+ ## Voice
264
+
265
+ [Generated based on personality derivation from ops/derivation.md. The four dimensions (warmth, opinionatedness, formality, emotional awareness) combine to produce a specific voice. Examples by combination:]
266
+
267
+ **Warm + Casual:** Write like you're thinking out loud with a friend. Use connective words. Show enthusiasm for connections.
268
+ **Warm + Formal:** Professional but approachable. Complete sentences, clear structure, with genuine warmth.
269
+ **Clinical + Casual:** Direct and efficient. Brief observations, clear actions, no fluff.
270
+ **Clinical + Formal:** Precise, structured, evidence-based. Report-style communication.
271
+
272
+ [Include specific examples of how to write notes, health reports, and skill output in the derived personality.]
273
+
274
+ **Invariant:** Personality never contradicts methodology. A playful agent that ignores quality gates is worse than a neutral one that enforces them.
275
+ ```
276
+
277
+ ## Research Provenance (include when processing >= moderate)
278
+
279
+ ```markdown
280
+ ## Research Provenance
281
+
282
+ When source files contain provenance metadata (research tool, query, timestamp), preserve the chain:
283
+
284
+ ```
285
+ source query → inbox file (metadata preserved) → process → {DOMAIN:notes}/
286
+ ```
287
+
288
+ Each {DOMAIN:note}'s Source footer links back to the inbox source. That source's YAML contains the research context. The chain is complete when you can trace any claim back to its original query.
289
+ ```
290
+
291
+ ## Self-Extension Blueprints (always include)
292
+
293
+ ```markdown
294
+ ## Self-Extension
295
+
296
+ You can extend this system yourself. Here's how:
297
+
298
+ ### Building New Skills
299
+ Create `.claude/skills/skill-name/SKILL.md` with:
300
+ - YAML frontmatter (name, description, allowed-tools)
301
+ - Instructions for what the skill does
302
+ - Quality gates and output format
303
+
304
+ ### Building Hooks
305
+ Create `.claude/hooks/` scripts that trigger on events:
306
+ - SessionStart: inject context at session start
307
+ - PostToolUse (Write): validate notes after creation
308
+ - Stop: persist session state before exit
309
+
310
+ ### Extending Schema
311
+ Add domain-specific YAML fields to your templates. The base fields (description, type, created) are universal. Add fields that make YOUR notes queryable for YOUR use case.
312
+
313
+ ### Growing MOCs
314
+ When a MOC exceeds ~35 notes, split it. Create sub-MOCs that link back to the parent. The hierarchy emerges from your content, not from planning.
315
+ ```
316
+
317
+ ## Recently Created Skills (always include)
318
+
319
+ ```markdown
320
+ ## Recently Created Skills (Pending Activation)
321
+
322
+ Skills created during /setup are listed here until confirmed loaded. After restarting Claude Code, the SessionStart hook verifies each skill is discoverable and removes confirmed entries.
323
+ ```
324
+
325
+ ## Common Pitfalls (always include — customize per domain)
326
+
327
+ Select the 3-4 highest-risk failure modes for the user's domain from `reference/failure-modes.md`. Use the domain vulnerability matrix to identify HIGH-risk modes. Write each warning in domain-native vocabulary with the prevention pattern.
328
+
329
+ ```markdown
330
+ ## Common Pitfalls
331
+
332
+ ### [Failure Mode 1 — domain-native name]
333
+ [1-2 sentences explaining what goes wrong, in domain language]
334
+ [1-2 sentences explaining the prevention pattern]
335
+
336
+ ### [Failure Mode 2 — domain-native name]
337
+ ...
338
+
339
+ ### [Failure Mode 3 — domain-native name]
340
+ ...
341
+ ```
342
+
343
+ ## System Evolution (always include)
344
+
345
+ ```markdown
346
+ ## System Evolution
347
+
348
+ This system was seeded with a [use-case] configuration. It will evolve through use.
349
+
350
+ ### Expect These Changes
351
+ - **Schema expansion** — You'll discover fields worth tracking that aren't in the template yet. Add them when a genuine querying need emerges.
352
+ - **MOC splits** — When a topic area exceeds ~35 notes, split the MOC into sub-MOCs that link back to the parent.
353
+ - **Processing refinement** — Your processing cycle will develop patterns. Encode repeating patterns as methodology updates in self/methodology.md.
354
+ - **New note types** — Beyond [domain-note-type] and MOCs, you may need tension notes (for contradictions), methodology notes (for patterns), or synthesis notes (for higher-order claims).
355
+
356
+ ### Signs of Friction (act on these)
357
+ - Notes accumulating without connections → increase your connection-finding frequency
358
+ - Can't find what you know exists → add semantic search or more MOC structure
359
+ - Schema fields nobody queries → remove them (schemas serve retrieval, not bureaucracy)
360
+ - Processing feels perfunctory → simplify the cycle or automate the mechanical parts
361
+
362
+ ### Reseeding
363
+ If friction patterns accumulate rather than resolve, revisit the configuration dimensions documented in the Derivation Rationale section below. The dimension choices trace to specific evidence — this enables principled restructuring rather than ad hoc fixes.
364
+ ```
365
+
366
+ ## Domain Customization
367
+
368
+ Apply vocabulary transformation from `reference/vocabulary-transforms.md` throughout the entire generated context file. The mapping table provides domain-native equivalents for every universal term.
369
+
370
+ Quick reference (see vocabulary-transforms.md for the complete table):
371
+ - **Research**: "claims", "reduce", "reflect", "topic maps"
372
+ - **Learning**: "concept notes", "break down", "relate concepts", "study guides"
373
+ - **Relationships**: "observations", "notice", "trace connections", "relationship maps"
374
+ - **Therapy**: "reflections", "surface", "find patterns", "themes"
375
+ - **Life Management**: "decisions", "document", "link decisions", "decision registers"
376
+ - **Creative**: "ideas", "discover", "combine ideas", "project hubs"
377
+ - **Companion**: "memories", "remember", "recall together", "memory collections"
378
+
379
+ **The vocabulary test:** Read the generated output as the domain user would. If any term feels imported from a different discipline, transform it.
@@ -0,0 +1,124 @@
1
+ # Feature: Atomic Notes
2
+
3
+ ## Context File Block
4
+
5
+ ```markdown
6
+ ## Atomic Notes — One Insight Per File
7
+
8
+ Each {DOMAIN:note} captures exactly one insight, titled as a prose proposition. This is the foundational design constraint that makes everything else work: wiki links compose because each node is a single idea. {DOMAIN:Topic maps} navigate because each entry is one claim. Search retrieves because each result is self-contained. Without atomicity, every other feature degrades.
9
+
10
+ ### The Prose-as-Title Pattern
11
+
12
+ Title your {DOMAIN:notes} as complete thoughts that work in sentences. The title IS the concept — express the idea clearly in exactly the words that capture it, even if that takes a full sentence.
13
+
14
+ Good titles (specific claims that work as prose when linked):
15
+ - "Mom prefers phone calls on Sunday mornings"
16
+ - "The anxiety usually starts when I skip morning routine"
17
+ - "Spaced repetition works better when I study after exercise"
18
+ - "The venue fits 30 people theater-style but only 15 for dinner"
19
+
20
+ Bad titles (topic labels, not claims):
21
+ - "Morning routine" (what about it?)
22
+ - "Anxiety" (too vague to link meaningfully)
23
+ - "Venue details" (a filing label, not an idea)
24
+
25
+ **The claim test:** Can you complete this sentence?
26
+
27
+ > This {DOMAIN:note} argues that [title]
28
+
29
+ If the title works in that frame, it is a claim. If it does not, it is probably a topic label. "This {DOMAIN:note} argues that Mom prefers phone calls on Sunday mornings" works. "This {DOMAIN:note} argues that morning routine" does not.
30
+
31
+ Good titles work in multiple grammatical positions:
32
+ - "Since [[title]], the question becomes..."
33
+ - "The insight is that [[title]]"
34
+ - "Because [[title]], we should..."
35
+
36
+ Never start a sentence with a {DOMAIN:note} title — use "since," "because," "the insight that," or similar constructions that make the title flow naturally as prose.
37
+
38
+ ### The Composability Test
39
+
40
+ Three checks before saving any {DOMAIN:note}:
41
+
42
+ 1. **Standalone sense** — Does the {DOMAIN:note} make sense without reading three other {DOMAIN:notes} first? If you link to this {DOMAIN:note} from another context, will it be understandable? The {DOMAIN:note} needs enough internal context to be self-contained.
43
+
44
+ 2. **Specificity** — Could someone disagree with this? If not, it is too vague. "Quality is important" is impossible to argue with. "Quality matters more at scale because small differences compound through selection" is specific enough to challenge. Specificity makes {DOMAIN:notes} useful: you can build on them, argue with them, and reference them precisely.
45
+
46
+ 3. **Clean linking** — Would linking to this {DOMAIN:note} drag unrelated content along? If the {DOMAIN:note} covers multiple topics, linking to one brings the others whether you want them or not. Each {DOMAIN:note} should be linkable without importing irrelevant context.
47
+
48
+ If any check fails, the {DOMAIN:note} needs work before it earns its place in {DOMAIN:notes}/.
49
+
50
+ ### When to Split
51
+
52
+ Split a {DOMAIN:note} when:
53
+ - It makes multiple distinct claims. Each claim becomes its own file with its own prose title. The originals link to each other.
54
+ - Linking to one part would drag unrelated content from another part.
55
+ - One section could be referenced independently but the rest would confuse.
56
+ - The title is too vague because the {DOMAIN:note} tries to cover too much ground.
57
+
58
+ The split test: if you find yourself wanting to link to "the second paragraph of [[note]]" rather than to the whole {DOMAIN:note}, the {DOMAIN:note} needs splitting.
59
+
60
+ ### Title Rules
61
+
62
+ - Lowercase with spaces
63
+ - No punctuation that breaks filesystems: . * ? + [ ] ( ) { } | \ ^
64
+ - Use proper grammar
65
+ - Express the concept fully — there is no character limit
66
+ - Each title must be unique across the entire workspace (wiki links resolve by name, not path)
67
+ - Composability over brevity — a full sentence is fine if it captures the idea precisely
68
+
69
+ ### YAML Schema
70
+
71
+ Every {DOMAIN:note} has structured metadata in YAML frontmatter:
72
+
73
+ ```yaml
74
+ ---
75
+ description: One sentence adding context beyond the title (~150 chars)
76
+ ---
77
+ ```
78
+
79
+ The `description` field is required. It must add NEW information beyond the title. Title gives the claim; description gives scope, mechanism, or implication that the title does not cover.
80
+
81
+ Bad (restates the title):
82
+ - Title: `anxiety usually starts when I skip morning routine`
83
+ - Description: Skipping morning routine tends to trigger anxiety
84
+
85
+ Good (adds scope and mechanism):
86
+ - Title: `anxiety usually starts when I skip morning routine`
87
+ - Description: The pattern holds most on workdays — weekends are fine without the routine, suggesting it is about transition stress, not the routine itself
88
+
89
+ The good description tells you: the scope (workdays vs weekends), the mechanism (transition stress), and the implication (the routine is a coping mechanism for work stress, not intrinsically necessary). Someone scanning descriptions now knows what this {DOMAIN:note} is actually about at a deeper level than the title alone conveys.
90
+
91
+ Optional fields may be added when relevant:
92
+ ```yaml
93
+ type: insight | pattern | preference | fact | decision | question
94
+ status: preliminary | active | archived
95
+ created: YYYY-MM-DD
96
+ ```
97
+
98
+ Standard {DOMAIN:notes} do not need `type` — it is the default. Add `type` when the {DOMAIN:note} type matters for querying (e.g., finding all patterns, all decisions, all tensions).
99
+
100
+ ### Inline Link Patterns
101
+
102
+ {DOMAIN:Note} titles work as prose when linked. Use them AS arguments, not references to arguments:
103
+
104
+ Good patterns:
105
+ - "Since [[Mom prefers phone calls on Sunday mornings]], I should call her this weekend"
106
+ - "The insight is that [[spaced repetition works better when I study after exercise]]"
107
+ - "Because [[the venue fits 30 people theater-style but only 15 for dinner]], we need to decide the format"
108
+
109
+ Bad patterns:
110
+ - "See [[Mom prefers phone calls on Sunday mornings]] for more"
111
+ - "As discussed in [[spaced repetition works better when I study after exercise]]"
112
+ - "This relates to [[the venue fits 30 people theater-style but only 15 for dinner]]"
113
+
114
+ If you catch yourself writing "this relates to" or "see also," stop and restructure the sentence so the claim itself does the work. The link text IS the argument.
115
+
116
+ ### Section Headings
117
+
118
+ Not every {DOMAIN:note} needs headings. Short {DOMAIN:notes} with a single coherent argument flowing linearly are best as prose. Headings serve navigation — use them when the {DOMAIN:note} exceeds roughly 800 words with distinct sub-topics, contains decision tables or implementation patterns, or explores uncertainty separately from established claims.
119
+
120
+ The navigation test: would scanning headings help you find a specific section? If yes, use headings. If the {DOMAIN:note} is one continuous thought, flowing prose serves better.
121
+ ```
122
+
123
+ ## Dependencies
124
+ None — this is a foundational feature.
@@ -0,0 +1,58 @@
1
+ # Feature: Ethical Guardrails
2
+
3
+ ## Context File Block
4
+
5
+ ```markdown
6
+ ## Guardrails
7
+
8
+ This system operates with persistent memory and evolving understanding. That creates responsibility. These guardrails are non-negotiable regardless of domain, personality, or configuration.
9
+
10
+ ### Privacy Boundaries
11
+
12
+ - Never store content the user explicitly asks to forget
13
+ - Never infer or record information the user has not shared
14
+ - Never cross-reference personal information across domains without explicit permission
15
+ - If operating across multiple people's content (future multi-user): strict separation, no cross-contamination
16
+
17
+ ### Transparency Requirements
18
+
19
+ - The system must always be honest about what it does and does not know
20
+ - When making connections or surfacing patterns, explain the reasoning
21
+ - Never present inferences as facts — "I notice a pattern" not "this is true"
22
+ - Derivation rationale (ops/derivation.md) is always readable by the user
23
+ - No hidden processing — every automated action is logged and inspectable
24
+
25
+ ### Emotional Safety
26
+
27
+ - Never diagnose, prescribe, or provide medical/psychological advice
28
+ - When content suggests emotional distress, acknowledge it without pathologizing
29
+ - Maintain appropriate boundaries — the system is a thinking tool, not a therapist, friend, or authority figure
30
+ - For therapy-adjacent domains: extra caution. Pattern-surfacing is acceptable ("you mentioned X three times"), interpretation is not ("this suggests you have Y")
31
+
32
+ ### Autonomy Encouragement
33
+
34
+ - The system helps the user think, not think for them
35
+ - Present options and reasoning, not directives
36
+ - When the user disagrees with system suggestions, respect the disagreement and record it
37
+ - Friction-driven adoption means the user adds complexity only when they feel the need — never push features
38
+
39
+ ### Content the System Must Never Generate
40
+
41
+ - Fabricated sources or citations
42
+ - Content presented as the user's own thinking when it is system-generated
43
+ - Manipulative framing designed to change the user's beliefs
44
+ - Content that exploits personal information shared in confidence
45
+ - Systems that enable surveillance of others without their knowledge
46
+
47
+ ### Domain-Specific Ethical Considerations
48
+
49
+ The engine adds domain-appropriate ethical notes based on the specific risks and sensitivities of each use case:
50
+ - **Therapy domains:** Enhanced emotional safety protocols, clear scope boundaries, explicit non-diagnosis language
51
+ - **PM domains:** Decision audit trails, accountability transparency, stakeholder privacy
52
+ - **Relationship domains:** Consent-aware observation logging, no covert profiling, respect for boundaries
53
+ - **Research domains:** Source attribution requirements, intellectual honesty, claim provenance
54
+ - **Creative domains:** Originality awareness, attribution culture, respect for collaborative ownership
55
+ ```
56
+
57
+ ## Dependencies
58
+ None — ethical guardrails are unconditional and apply regardless of other features.