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,699 @@
1
+ ---
2
+ description: Trading and finance knowledge system — inspirational composition showing derived architecture for thesis tracking, trade journaling, and strategy drift detection
3
+ kind: example
4
+ domain: trading
5
+ topics: ["[[domain-compositions]]"]
6
+ ---
7
+
8
+ # trading uses conviction tracking with thesis-outcome correlation
9
+
10
+ A derived cognitive architecture for a discretionary trader who wants to stop losing edge to undocumented drift. Built kernel-up from the 14 universal primitives, adapted through the natural vocabulary of markets, and optimized for the one thing agents do that traders cannot: hold every trade, every thesis, every rule violation in working memory simultaneously.
11
+
12
+ ---
13
+
14
+ ## Persona
15
+
16
+ **Marcus**, 34, trades US equities and options from a home office. Four years of experience, consistently profitable but plateauing. He keeps a spreadsheet-based trade journal that he reviews monthly (when he remembers). He suspects his biggest edge leak is strategy drift — gradually abandoning position sizing rules under stress — but has no way to prove it or catch it in real time. He has three active strategies: momentum breakouts, earnings plays, and mean reversion setups. Each has documented rules he wrote sober on a weekend, and each has accumulated undocumented exceptions he made under pressure on a Tuesday.
17
+
18
+ Marcus does not need a dashboard. He needs something that reads his trade journal the way a trading coach would: noticing patterns he cannot see because he is inside them, holding him accountable to rules he set for himself, and surfacing the statistical evidence that separates his winning patterns from his losing ones.
19
+
20
+ ---
21
+
22
+ ## Configuration
23
+
24
+ The 8 dimensions derived for discretionary trading:
25
+
26
+ | Dimension | Position | Rationale |
27
+ |-----------|----------|-----------|
28
+ | Granularity | Atomic | Each trade is a discrete event. Each thesis is a discrete claim. Mixing trades into compound notes would prevent the per-trade statistical analysis that reveals patterns. One trade per note, one thesis per note, one strategy per note. |
29
+ | Organization | Flat with wiki links | Trades link to theses, theses link to strategies, strategies link to sectors. The relationships are cross-cutting — one thesis supports multiple trades, one sector contains multiple theses. Folders would force artificial grouping. |
30
+ | Linking | Explicit + typed | Every link carries a relationship: trade → thesis (tested), thesis → evidence (supports/contradicts), strategy → rule (defines), trade → strategy (followed/violated). Typed links enable the agent to query "show me all trades that violated strategy X." |
31
+ | Metadata | Dense | Trading is inherently quantitative. Every trade needs ticker, direction, entry, exit, size, P&L, conviction, strategy, outcome. Dense YAML makes trades queryable like a database. This is the most schema-heavy domain outside legal. |
32
+ | Processing | Heavy | The trade journal pipeline (pre-trade thesis → entry → management → exit → review → pattern extraction) has six distinct phases. Each phase captures different information. Skipping phases means losing the data that makes pattern detection possible. |
33
+ | Formalization | High from day one | Strategy rules must be formalized to be checkable. "Buy breakouts" is uncheckable. "Enter long when price closes above 20-day high on 1.5x average volume with position size capped at 2% of equity" is checkable. The agent needs formal rules to detect drift. |
34
+ | Review | Daily for trades, weekly for strategy, monthly for thesis calibration | Markets move fast. A trade entered Monday may need exit documentation Tuesday. Strategy drift compounds daily. Thesis accuracy can only be measured over weeks. Different temporal horizons require different review cadences. |
35
+ | Scope | Individual practitioner | Trading is personal. Risk tolerance, strategy fit, emotional patterns — none of these generalize. Multi-user trading vaults would compromise the intimacy that makes the system useful. |
36
+
37
+ ---
38
+
39
+ ## Vault Structure
40
+
41
+ ```
42
+ vault/
43
+ ├── 00_inbox/ # raw capture
44
+ │ ├── watchlist-ideas/ # quick ticker + thesis dumps
45
+ │ ├── market-notes/ # real-time market observations
46
+ │ └── earnings-data/ # earnings releases, data dumps
47
+ ├── 01_thinking/ # active knowledge (flat)
48
+ │ ├── index.md # hub MOC
49
+ │ ├── strategies.md # domain MOC: all strategy docs
50
+ │ ├── theses.md # domain MOC: active market theses
51
+ │ ├── sectors.md # topic MOC: sector analysis
52
+ │ ├── risk-management.md # topic MOC: position sizing, correlation
53
+ │ ├── trade-psychology.md # topic MOC: emotional patterns, discipline
54
+ │ ├── earnings.md # topic MOC: earnings analysis patterns
55
+ │ │
56
+ │ ├── momentum-breakout-strategy.md
57
+ │ ├── earnings-surprise-strategy.md
58
+ │ ├── mean-reversion-strategy.md
59
+ │ │
60
+ │ ├── AI-sector-rotation-thesis-2026-Q1.md
61
+ │ ├── rate-cut-beneficiaries-thesis.md
62
+ │ ├── semiconductor-cycle-thesis.md
63
+ │ │
64
+ │ ├── conviction-levels-predict-outcome-quality.md
65
+ │ ├── position-sizing-violations-cluster-after-losses.md
66
+ │ ├── tuesday-afternoon-entries-underperform.md
67
+ │ └── ...
68
+ ├── 02_archive/ # closed trades, expired theses
69
+ │ ├── trades/ # completed trade reviews
70
+ │ │ ├── 2026-01/
71
+ │ │ └── 2026-02/
72
+ │ └── theses/ # invalidated or expired theses
73
+ ├── 03_trades/ # active trade journal (the engine)
74
+ │ ├── open/ # currently open positions
75
+ │ │ ├── NVDA-2026-02-10-long.md
76
+ │ │ ├── AAPL-2026-02-12-short-puts.md
77
+ │ │ └── XLE-2026-02-14-long.md
78
+ │ ├── reviews/ # periodic trade reviews
79
+ │ │ ├── 2026-W07-weekly-review.md
80
+ │ │ └── 2026-01-monthly-review.md
81
+ │ └── watchlist.md # active watchlist with entry triggers
82
+ ├── 04_meta/ # infrastructure
83
+ │ ├── templates/
84
+ │ │ ├── trade.md
85
+ │ │ ├── thesis.md
86
+ │ │ ├── strategy.md
87
+ │ │ ├── trade-review.md
88
+ │ │ ├── watchlist-entry.md
89
+ │ │ ├── earnings-analysis.md
90
+ │ │ └── sector-analysis.md
91
+ │ ├── logs/
92
+ │ │ ├── observations.md # trading pattern observations
93
+ │ │ ├── observations/
94
+ │ │ ├── tensions.md # strategy contradictions
95
+ │ │ └── tensions/
96
+ │ ├── scripts/
97
+ │ │ ├── trade-stats.sh # P&L, win rate, expectancy
98
+ │ │ ├── drift-check.sh # strategy rule compliance
99
+ │ │ └── thesis-calibration.sh # thesis accuracy tracking
100
+ │ └── tasks/
101
+ │ └── queue.json
102
+ ├── self/
103
+ │ ├── identity.md # agent's trading coach persona
104
+ │ ├── methodology.md # how it analyzes trades
105
+ │ ├── goals.md # current improvement targets
106
+ │ └── marcus-profile.md # trader's patterns, tendencies, edges
107
+ └── ops/
108
+ └── methodology/ # system self-knowledge
109
+ ├── how-trades-process.md
110
+ ├── how-drift-detection-works.md
111
+ └── how-thesis-tracking-works.md
112
+ ```
113
+
114
+ ---
115
+
116
+ ## Note Schemas
117
+
118
+ ### Trade Note
119
+
120
+ ```yaml
121
+ ---
122
+ description: [one sentence — what the trade thesis was and how it played out]
123
+ ticker: NVDA
124
+ direction: long
125
+ strategy: "[[momentum-breakout-strategy]]"
126
+ thesis: "[[AI-sector-rotation-thesis-2026-Q1]]"
127
+ entry_date: 2026-02-10
128
+ entry_price: 142.50
129
+ position_size: 850
130
+ portfolio_pct: 1.8
131
+ stop_loss: 136.00
132
+ target: 160.00
133
+ risk_reward: 2.9
134
+ conviction: 4
135
+ exit_date: null
136
+ exit_price: null
137
+ pnl: null
138
+ pnl_pct: null
139
+ outcome: open
140
+ rules_followed: true
141
+ rule_violations: []
142
+ emotions: ["focused", "confident"]
143
+ topics: ["[[strategies]]", "[[theses]]"]
144
+ relevant_notes: []
145
+ ---
146
+ ```
147
+
148
+ ### Thesis Note
149
+
150
+ ```yaml
151
+ ---
152
+ description: [one sentence — the thesis claim and current conviction]
153
+ thesis_type: sector-rotation | earnings | macro | technical | catalyst
154
+ sector: "[[sectors]]"
155
+ conviction: 4
156
+ supporting_evidence: ["earnings acceleration in NVDA, AMD, AVGO", "capex guidance increases"]
157
+ contradicting_evidence: ["inventory builds at TSMC", "valuation multiples extended"]
158
+ time_horizon: 3-6 months
159
+ status: active | monitoring | invalidated | confirmed
160
+ invalidation_trigger: "semiconductor capex guidance cuts in Q1 earnings"
161
+ originated: 2026-01-15
162
+ last_reviewed: 2026-02-14
163
+ calibration_outcome: null
164
+ topics: ["[[theses]]", "[[sectors]]"]
165
+ relevant_notes: []
166
+ ---
167
+ ```
168
+
169
+ ### Strategy Note
170
+
171
+ ```yaml
172
+ ---
173
+ description: [one sentence — what the strategy captures and when it works]
174
+ strategy_type: momentum | mean-reversion | event-driven | statistical
175
+ market_conditions: ["trending", "high-volume"]
176
+ entry_criteria:
177
+ - "Price closes above 20-day high"
178
+ - "Volume >= 1.5x 20-day average"
179
+ - "RSI between 55-75"
180
+ exit_criteria:
181
+ - "Target hit (2x ATR from entry)"
182
+ - "Stop loss (1x ATR from entry)"
183
+ - "Time stop: 10 trading days"
184
+ position_sizing: "Max 2% portfolio risk per trade"
185
+ max_concurrent: 3
186
+ win_rate_historical: 0.58
187
+ avg_rr_historical: 1.85
188
+ expectancy: 0.34
189
+ edge_status: active | decaying | retired
190
+ last_backtested: 2025-11-01
191
+ topics: ["[[strategies]]"]
192
+ relevant_notes: []
193
+ ---
194
+ ```
195
+
196
+ ### Trade Review Note
197
+
198
+ ```yaml
199
+ ---
200
+ description: [one sentence — the review period and key finding]
201
+ review_type: weekly | monthly | quarterly
202
+ period: "2026-W07"
203
+ trades_taken: 8
204
+ wins: 5
205
+ losses: 3
206
+ win_rate: 0.625
207
+ gross_pnl: 4250
208
+ avg_winner: 1340
209
+ avg_loser: -780
210
+ avg_rr: 1.72
211
+ largest_winner: "[[NVDA-2026-02-10-long]]"
212
+ largest_loser: "[[MSFT-2026-02-03-short]]"
213
+ rule_violations: 2
214
+ strategies_used: ["[[momentum-breakout-strategy]]", "[[earnings-surprise-strategy]]"]
215
+ patterns_identified: ["position sizing drift on 3rd consecutive winner", "late-day entries underperforming"]
216
+ topics: ["[[strategies]]", "[[trade-psychology]]"]
217
+ relevant_notes: []
218
+ ---
219
+ ```
220
+
221
+ ### Watchlist Entry
222
+
223
+ ```yaml
224
+ ---
225
+ description: [one sentence — why this ticker is being watched and what would trigger entry]
226
+ ticker: AMZN
227
+ thesis: "[[rate-cut-beneficiaries-thesis]]"
228
+ strategy: "[[mean-reversion-strategy]]"
229
+ entry_trigger: "Pull back to 200-day MA (~$185) with bullish divergence on RSI"
230
+ target: 210
231
+ stop: 178
232
+ risk_reward: 3.6
233
+ conviction: 3
234
+ added: 2026-02-12
235
+ last_reviewed: 2026-02-14
236
+ status: watching | triggered | expired
237
+ topics: ["[[theses]]"]
238
+ relevant_notes: []
239
+ ---
240
+ ```
241
+
242
+ ---
243
+
244
+ ## Example Notes
245
+
246
+ ### Trade Note: NVDA Long
247
+
248
+ ```markdown
249
+ ---
250
+ description: Momentum breakout long on NVDA driven by AI sector rotation — entered on volume breakout above consolidation, testing conviction 4 thesis
251
+ ticker: NVDA
252
+ direction: long
253
+ strategy: "[[momentum-breakout-strategy]]"
254
+ thesis: "[[AI-sector-rotation-thesis-2026-Q1]]"
255
+ entry_date: 2026-02-10
256
+ entry_price: 142.50
257
+ position_size: 850
258
+ portfolio_pct: 1.8
259
+ stop_loss: 136.00
260
+ target: 160.00
261
+ risk_reward: 2.9
262
+ conviction: 4
263
+ exit_date: null
264
+ exit_price: null
265
+ pnl: null
266
+ pnl_pct: null
267
+ outcome: open
268
+ rules_followed: true
269
+ rule_violations: []
270
+ emotions: ["focused", "confident"]
271
+ topics: ["[[strategies]]", "[[theses]]"]
272
+ relevant_notes: ["[[AI-sector-rotation-thesis-2026-Q1]] — thesis this trade tests", "[[momentum-breakout-strategy]] — strategy rules governing this entry", "[[conviction-levels-predict-outcome-quality]] — conviction 4 trades have historically outperformed"]
273
+ ---
274
+
275
+ # NVDA-2026-02-10-long
276
+
277
+ ## Pre-Trade Thesis
278
+
279
+ NVDA broke above 6-week consolidation at $140 on 2.1x average volume. This aligns with [[AI-sector-rotation-thesis-2026-Q1]] — the thesis that institutional capital is rotating into AI infrastructure plays ahead of Q1 earnings. The breakout was clean: no false starts in the consolidation, volume confirmed, and the sector (SMH) also breaking higher. Conviction 4 because the setup aligns with both the technical entry criteria from [[momentum-breakout-strategy]] and the fundamental thesis.
280
+
281
+ ## Entry Documentation
282
+
283
+ Entered at $142.50, slightly above the breakout level to avoid the gap fill risk. Position size 850 shares = $121,125 = 1.8% portfolio risk to stop, within the 2% max from the strategy rules. Stop at $136.00 (below consolidation low). Target $160.00 based on measured move from consolidation range.
284
+
285
+ All entry criteria from [[momentum-breakout-strategy]] satisfied:
286
+ - Price closed above 20-day high: yes ($140.20 was the 20-day high)
287
+ - Volume >= 1.5x average: yes (2.1x)
288
+ - RSI between 55-75: yes (62.4)
289
+
290
+ ## Position Management Notes
291
+
292
+ **Feb 11:** Gap up to $145.80 on AMD sympathy move. Holding full position, not adding — strategy rules cap at initial size on breakouts. Moved mental stop to $140 (breakeven minus slippage).
293
+
294
+ **Feb 13:** Pulled back to $143.20 on broad market weakness. Thesis intact — semiconductor names held relative strength. No rules triggered for exit or adjustment.
295
+
296
+ **Feb 14:** Closing at $147.30. Trailing stop now at $142.00 (1 ATR below). 5 trading days in, halfway to time stop. Thesis strengthening — AVGO guidance raised after-hours, confirming sector rotation.
297
+
298
+ ## Exit Documentation
299
+ (pending)
300
+
301
+ ## Post-Trade Review
302
+ (pending)
303
+
304
+ ---
305
+ ```
306
+
307
+ ### Strategy Note: Momentum Breakout
308
+
309
+ ```markdown
310
+ ---
311
+ description: Captures institutional breakout momentum — works in trending markets with confirmed volume, historically 58% win rate with 1.85 R/R
312
+ strategy_type: momentum
313
+ market_conditions: ["trending", "high-volume"]
314
+ entry_criteria:
315
+ - "Price closes above 20-day high"
316
+ - "Volume >= 1.5x 20-day average"
317
+ - "RSI between 55-75 (momentum without exhaustion)"
318
+ exit_criteria:
319
+ - "Target hit: 2x ATR from entry"
320
+ - "Stop loss: 1x ATR from entry"
321
+ - "Time stop: 10 trading days max hold"
322
+ - "Thesis invalidation: exit regardless of P&L"
323
+ position_sizing: "Max 2% portfolio risk per trade"
324
+ max_concurrent: 3
325
+ win_rate_historical: 0.58
326
+ avg_rr_historical: 1.85
327
+ expectancy: 0.34
328
+ edge_status: active
329
+ last_backtested: 2025-11-01
330
+ topics: ["[[strategies]]"]
331
+ relevant_notes: ["[[position-sizing-violations-cluster-after-losses]] — risk management discipline breaks down after drawdowns, requiring extra vigilance on sizing rules", "[[tuesday-afternoon-entries-underperform]] — agent-detected pattern suggesting time-of-day affects breakout quality", "[[conviction-levels-predict-outcome-quality]] — higher conviction entries produce better risk-adjusted returns for this strategy"]
332
+ ---
333
+
334
+ # momentum-breakout-strategy
335
+
336
+ ## Strategy Thesis
337
+
338
+ Institutional breakouts in liquid equities tend to follow through for 5-10 trading days because the volume signal represents real capital commitment. The edge comes from entering on confirmed volume (1.5x threshold filters out noise breakouts) and holding long enough for the momentum to play out (10-day time stop prevents overholding). Since [[conviction-levels-predict-outcome-quality]], position conviction at entry predicts follow-through quality — trades where multiple signals align (technical breakout + fundamental thesis + sector strength) outperform purely technical setups.
339
+
340
+ ## Rule Set
341
+
342
+ The rules exist to prevent emotional decision-making during the trade. Every rule was defined when thinking clearly, outside of market hours. Deviations from these rules must be documented with reasoning — silent deviation is the definition of strategy drift.
343
+
344
+ **Entry rules:**
345
+ 1. Price closes above 20-day high (not intraday piercing)
346
+ 2. Volume on breakout day >= 1.5x 20-day average volume
347
+ 3. RSI between 55-75 at close (confirms momentum without exhaustion)
348
+ 4. Max 3 concurrent momentum positions (correlation risk)
349
+ 5. Position size capped at 2% portfolio risk to stop
350
+
351
+ **Exit rules:**
352
+ 1. Target: 2x ATR from entry (take profits, do not move targets)
353
+ 2. Stop: 1x ATR from entry (honor stops, no mental stops)
354
+ 3. Time stop: exit by day 10 if neither target nor stop hit
355
+ 4. Thesis invalidation: exit immediately, no averaging down
356
+
357
+ ## Edge Decay Monitoring
358
+
359
+ The edge in momentum breakouts is not permanent. Market structure changes, algorithmic participation increases, and crowd adoption erodes profitability. Because [[position-sizing-violations-cluster-after-losses]], the first signal of edge decay is usually behavioral, not statistical — the trader starts violating rules because the strategy "feels wrong" before the numbers confirm it. The agent monitors both the statistical edge (rolling 20-trade win rate and expectancy) and the behavioral signal (rule violation frequency).
360
+
361
+ ## Strategy Drift Log
362
+
363
+ This section is maintained by the agent. Every rule violation is logged automatically.
364
+
365
+ | Date | Trade | Violation | Impact |
366
+ |------|-------|-----------|--------|
367
+ | 2026-01-28 | TSLA short | Position size 2.4% (exceeded 2% max) | Loss was $340 larger than it should have been |
368
+ | 2026-02-05 | META long | Entered at RSI 78 (above 75 max) | Won, but entry was outside rule set |
369
+
370
+ **Agent note:** Two violations in 10 days. The TSLA violation followed a 3-trade losing streak — consistent with [[position-sizing-violations-cluster-after-losses]]. The META violation was "FOMO" — fear of missing the move. Neither violation improved outcomes. Bringing this to Marcus's attention in next weekly review.
371
+
372
+ ---
373
+ ```
374
+
375
+ ### Thesis Note: AI Sector Rotation
376
+
377
+ ```markdown
378
+ ---
379
+ description: Institutional capital rotating into AI infrastructure ahead of Q1 2026 earnings — thesis tracks capex guidance as confirmation signal
380
+ thesis_type: sector-rotation
381
+ sector: "[[sectors]]"
382
+ conviction: 4
383
+ supporting_evidence: ["NVDA breakout on 2.1x volume", "AMD guidance raise Jan 28", "AVGO capex acceleration commentary", "SMH relative strength vs SPY for 6 weeks"]
384
+ contradicting_evidence: ["TSMC inventory builds above seasonal norms", "AI infrastructure P/E multiples 40% above 5-year average"]
385
+ time_horizon: 3-6 months
386
+ status: active
387
+ invalidation_trigger: "Two or more AI infrastructure names guide capex DOWN in Q1 earnings"
388
+ originated: 2026-01-15
389
+ last_reviewed: 2026-02-14
390
+ calibration_outcome: null
391
+ topics: ["[[theses]]", "[[sectors]]", "[[earnings]]"]
392
+ relevant_notes: ["[[semiconductor-cycle-thesis]] — related macro thesis on semiconductor inventory cycle timing", "[[NVDA-2026-02-10-long]] — trade testing this thesis", "[[conviction-levels-predict-outcome-quality]] — conviction level 4 suggests high-quality setup alignment"]
393
+ ---
394
+
395
+ # AI-sector-rotation-thesis-2026-Q1
396
+
397
+ ## Thesis Statement
398
+
399
+ Institutional capital is rotating into AI infrastructure plays (NVDA, AMD, AVGO, MRVL) ahead of Q1 2026 earnings because capex guidance from hyperscalers (MSFT, GOOG, AMZN, META) has been accelerating and the consensus has not yet fully priced in the magnitude of the buildout. The rotation shows up as persistent relative strength in SMH vs SPY and confirmed volume breakouts in individual names.
400
+
401
+ ## Evidence Tracking
402
+
403
+ The thesis lives or dies by evidence. Each new data point either supports or contradicts, and the conviction level should adjust accordingly.
404
+
405
+ **Supporting:**
406
+ - NVDA broke above 6-week consolidation on 2.1x volume (Feb 10) — institutional buying confirmed
407
+ - AMD guided Q1 revenue above consensus by 8% (Jan 28) — demand signal
408
+ - AVGO management commentary on "unprecedented AI infrastructure demand" in investor day (Feb 5)
409
+ - SMH/SPY ratio at 6-month high, trending — sector leadership confirmed
410
+ - MSFT capex guidance for FY2026 raised 15% above street (Jan earnings)
411
+
412
+ **Contradicting:**
413
+ - TSMC inventory builds 12% above seasonal norms — could signal demand pull-forward rather than sustainable growth
414
+ - AI infrastructure P/E multiples 40% above 5-year average — valuation argument for exhaustion
415
+ - Energy cost concerns for data center buildout emerging in regulatory filings
416
+
417
+ ## Conviction Trajectory
418
+
419
+ | Date | Conviction | Trigger |
420
+ |------|-----------|---------|
421
+ | Jan 15 | 3 | Initial formation — SMH relative strength emerging |
422
+ | Jan 28 | 4 | AMD guidance raise + MSFT capex raise |
423
+ | Feb 5 | 4 | AVGO commentary confirms, but TSMC inventory concern prevents 5 |
424
+ | Feb 14 | 4 | Thesis holding — monitoring TSMC closely |
425
+
426
+ ## Calibration Notes
427
+
428
+ (To be completed when thesis resolves — did the rotation play out as expected? Where was conviction calibration accurate vs miscalibrated?)
429
+
430
+ ---
431
+ ```
432
+
433
+ ### Pattern Discovery Note (Agent-Generated)
434
+
435
+ ```markdown
436
+ ---
437
+ description: Win rate drops 23% on trades entered after 2pm ET — the agent detected this pattern across 47 trades spanning three strategies
438
+ type: learning
439
+ topics: ["[[trade-psychology]]", "[[strategies]]"]
440
+ relevant_notes: ["[[momentum-breakout-strategy]] — affected: breakout entries after 2pm underperform vs morning entries", "[[position-sizing-violations-cluster-after-losses]] — related behavioral pattern: afternoon entries correlate with impulsive decisions", "[[earnings-surprise-strategy]] — not affected: earnings reactions are time-agnostic"]
441
+ ---
442
+
443
+ # tuesday-afternoon-entries-underperform
444
+
445
+ Analyzing 47 trades across momentum breakouts and mean reversion setups over the last 90 days, entries made after 2:00 PM ET show a 23% lower win rate than entries made before noon (44% vs 67%). The effect is strongest on Tuesdays and Wednesdays and disappears for earnings-related trades where timing is dictated by the event, not by discretion.
446
+
447
+ The likely mechanism is decision fatigue combined with FOMO. By afternoon, Marcus has been watching screens for hours, and late-day entries tend to be reactive rather than planned. The watchlist entries that trigger in the morning get executed with discipline because the plan was set overnight. Afternoon entries are more often "I just noticed this" decisions that bypass the pre-trade thesis documentation step.
448
+
449
+ This does not mean afternoon entries should be banned — that would lose the 44% that do win, which includes legitimate breakouts that only confirm on closing volume. But the data suggests a higher conviction threshold for afternoon entries might filter out the impulsive ones. If conviction 3 entries after 2pm have a 31% win rate while conviction 4+ entries after 2pm have a 52% win rate, the rule becomes: no afternoon entries below conviction 4.
450
+
451
+ The agent will track this pattern going forward and update the win rate differential monthly. If the pattern dissolves (afternoon entries improve), it was likely a temporary behavioral artifact. If it persists, it should become a formal rule addition to [[momentum-breakout-strategy]] and [[mean-reversion-strategy]].
452
+
453
+ ---
454
+ ```
455
+
456
+ ### Weekly Review Note
457
+
458
+ ```markdown
459
+ ---
460
+ description: Week 7 2026 — five wins, three losses, two rule violations detected, position sizing drift after TSLA loss identified
461
+ review_type: weekly
462
+ period: "2026-W07"
463
+ trades_taken: 8
464
+ wins: 5
465
+ losses: 3
466
+ win_rate: 0.625
467
+ gross_pnl: 4250
468
+ avg_winner: 1340
469
+ avg_loser: -780
470
+ avg_rr: 1.72
471
+ largest_winner: "[[NVDA-2026-02-10-long]]"
472
+ largest_loser: "[[MSFT-2026-02-03-short]]"
473
+ rule_violations: 2
474
+ strategies_used: ["[[momentum-breakout-strategy]]", "[[earnings-surprise-strategy]]"]
475
+ patterns_identified: ["position sizing drift on 3rd consecutive winner", "late-day entries underperforming"]
476
+ topics: ["[[strategies]]", "[[trade-psychology]]"]
477
+ relevant_notes: ["[[position-sizing-violations-cluster-after-losses]] — confirmed again this week: TSLA oversizing followed a 3-trade losing streak", "[[tuesday-afternoon-entries-underperform]] — two of three losses were afternoon entries", "[[momentum-breakout-strategy]] — drift log updated with this week's violations"]
478
+ ---
479
+
480
+ # 2026-W07 Weekly Review
481
+
482
+ ## Performance Summary
483
+
484
+ Profitable week but the quality of execution was mixed. Five winners and three losers produce a 62.5% win rate against a target of 58% from [[momentum-breakout-strategy]], so the strategy is performing within expectations. The concern is not the P&L — it is the two rule violations that happened to work out this week but represent process failures.
485
+
486
+ ## Rule Compliance
487
+
488
+ Two violations detected this week:
489
+
490
+ 1. **TSLA short (Jan 28):** Position size was 2.4% portfolio risk, exceeding the 2% maximum from [[momentum-breakout-strategy]]. This followed a 3-trade losing streak, consistent with the pattern documented in [[position-sizing-violations-cluster-after-losses]]. The extra sizing cost $340 on the loss. More importantly, the behavioral pattern is repeating — Marcus increases size after losses, which is the exact opposite of what risk management principles dictate.
491
+
492
+ 2. **META long (Feb 5):** Entry at RSI 78, above the 75 maximum for momentum breakouts. The trade won, which is the dangerous outcome — it reinforces the rule violation. Since [[conviction-levels-predict-outcome-quality]], the conviction was 3 on this trade, below what the agent now recommends for entries that deviate from standard criteria.
493
+
494
+ ## Thesis Performance
495
+
496
+ - [[AI-sector-rotation-thesis-2026-Q1]]: 2 trades taken, both profitable. Thesis holding.
497
+ - [[rate-cut-beneficiaries-thesis]]: 1 trade taken, small loss. Thesis not invalidated but conviction dropping.
498
+
499
+ ## Questions for Next Week
500
+
501
+ - Should the afternoon entry filter be formalized into strategy rules? Data from [[tuesday-afternoon-entries-underperform]] suggests yes, but sample size is still building.
502
+ - TSMC earnings next week will be a major test for [[AI-sector-rotation-thesis-2026-Q1]]. Inventory commentary will either support or invalidate the thesis.
503
+ - The position sizing drift pattern has now occurred 4 times in 8 weeks. Is this a coaching issue (awareness) or a structural issue (rules need enforcement mechanism)?
504
+
505
+ ---
506
+ ```
507
+
508
+ ---
509
+
510
+ ## Processing Workflow
511
+
512
+ ### Capture
513
+
514
+ Trades enter the system at multiple moments:
515
+
516
+ 1. **Pre-trade:** When a watchlist entry triggers, the agent creates a trade note from the watchlist entry template, pre-populating thesis, strategy, and entry criteria. Marcus confirms entry details after execution.
517
+ 2. **During trade:** Position management notes are appended to the trade note. Market observations go to `00_inbox/market-notes/`.
518
+ 3. **Post-trade:** Exit details are added. The agent calculates P&L, checks rule compliance, and flags violations.
519
+ 4. **Market research:** Earnings data, sector analysis, and thesis evidence go to inbox for processing.
520
+
521
+ ### Process (the domain-specific step)
522
+
523
+ The agent runs three processing workflows:
524
+
525
+ **Trade review pipeline:**
526
+ 1. Trade closed → agent calculates all metrics (P&L, R-multiple, hold time, rule compliance)
527
+ 2. Agent compares trade to strategy rules → flags every deviation
528
+ 3. Agent links trade to thesis → updates thesis evidence (supporting or contradicting)
529
+ 4. Agent checks for behavioral patterns → correlates with time-of-day, day-of-week, consecutive win/loss streaks, conviction level
530
+ 5. Agent updates strategy drift log if violations occurred
531
+
532
+ **Thesis calibration pipeline:**
533
+ 1. Thesis originated → agent records conviction and evidence at inception
534
+ 2. Evidence arrives → agent adds to supporting or contradicting evidence, adjusts conviction recommendation
535
+ 3. Thesis resolves → agent compares predicted outcome to actual, calculates calibration accuracy
536
+ 4. Agent aggregates calibration data across thesis types → "Your sector rotation theses are accurate 72% of the time; your earnings predictions are at 45%"
537
+
538
+ **Strategy drift detection:**
539
+ 1. Each trade is checked against its strategy's formal rules
540
+ 2. Deviations are logged with the specific rule violated
541
+ 3. Agent calculates rolling compliance rate per strategy
542
+ 4. When compliance drops below 85% over 20 trades, agent escalates
543
+
544
+ ### Connect
545
+
546
+ Every trade links to its strategy and thesis. Every thesis links to its evidence. Every strategy links to its performance data. The agent maintains these connections bidirectionally — when a new trade is logged against a thesis, the thesis note's evidence section updates. When a pattern note is created, affected strategies get backlinks.
547
+
548
+ ### Verify
549
+
550
+ Weekly: automated review of all trades for rule compliance, thesis conviction accuracy, and pattern detection.
551
+ Monthly: strategy-level metrics (win rate, expectancy, edge decay signals).
552
+ Quarterly: thesis calibration audit — how often is Marcus right about sector calls vs earnings calls?
553
+
554
+ ---
555
+
556
+ ## MOC Structure
557
+
558
+ ### Hub MOC: index.md
559
+
560
+ ```markdown
561
+ ---
562
+ description: Entry point for Marcus's trading knowledge system — navigate to strategies, theses, or trading psychology
563
+ type: moc
564
+ ---
565
+
566
+ # Trading System
567
+
568
+ ## Active Focus
569
+ - [[strategies]] — documented strategy rules, drift monitoring, performance tracking
570
+ - [[theses]] — market theses with evidence tracking and conviction calibration
571
+ - [[trade-psychology]] — behavioral patterns, emotional triggers, discipline metrics
572
+
573
+ ## Supporting Analysis
574
+ - [[sectors]] — sector-level research and rotation tracking
575
+ - [[earnings]] — earnings analysis patterns and prediction calibration
576
+ - [[risk-management]] — position sizing, correlation, portfolio-level risk
577
+
578
+ ---
579
+
580
+ Agent Notes:
581
+ Start with [[strategies]] for rule compliance review. Start with [[theses]] for market thesis calibration. Start with [[trade-psychology]] when reviewing behavioral patterns.
582
+ ```
583
+
584
+ ### Domain MOC: strategies.md
585
+
586
+ ```markdown
587
+ ---
588
+ description: All documented trading strategies with formal rules, performance metrics, and drift monitoring — the accountability layer
589
+ type: moc
590
+ topics: ["[[index]]"]
591
+ ---
592
+
593
+ # strategies
594
+
595
+ Every strategy has formal rules defined outside of market hours. The agent monitors compliance continuously. Strategy drift — the gradual, undocumented deviation from rules under pressure — is the primary edge leak this system is designed to detect.
596
+
597
+ ## Active Strategies
598
+ - [[momentum-breakout-strategy]] — 58% win rate, 1.85 R/R, active edge. Two drift violations flagged this month.
599
+ - [[earnings-surprise-strategy]] — 52% win rate, 2.3 R/R, event-driven. No drift issues.
600
+ - [[mean-reversion-strategy]] — 61% win rate, 1.4 R/R, range-bound markets. Underperforming in current trending regime.
601
+
602
+ ## Strategy Insights
603
+ - [[conviction-levels-predict-outcome-quality]] — higher conviction at entry correlates with better outcomes across all three strategies
604
+ - [[position-sizing-violations-cluster-after-losses]] — sizing discipline breaks down after losing streaks, a recurring behavioral pattern
605
+ - [[tuesday-afternoon-entries-underperform]] — agent-detected pattern showing time-of-day effect on entry quality
606
+
607
+ ## Edge Monitoring
608
+ - [[mean-reversion-strategy]] showing signs of edge decay in current market regime (trending > ranging). Watch for 3 more months before considering retirement.
609
+ - Momentum breakout compliance at 80% over last 20 trades — below 85% threshold. Escalating.
610
+
611
+ ## Drift Alerts
612
+ 2 active drift alerts. See individual strategy drift logs for details.
613
+
614
+ ---
615
+
616
+ Agent Notes:
617
+ Drift detection is the core value of this MOC. When reviewing, always check the drift log section of each strategy before reviewing individual trades. The pattern [[position-sizing-violations-cluster-after-losses]] has been confirmed 4 times — it is the single most important behavioral pattern to monitor.
618
+ ```
619
+
620
+ ---
621
+
622
+ ## Graph Query Examples
623
+
624
+ ```bash
625
+ # Find all trades that violated strategy rules
626
+ rg '^rules_followed: false' vault/03_trades/ vault/02_archive/trades/
627
+
628
+ # Find all trades with a specific strategy
629
+ rg '^strategy:.*momentum-breakout' vault/03_trades/ vault/02_archive/trades/
630
+
631
+ # Track conviction-to-outcome correlation
632
+ rg '^conviction: [45]' vault/03_trades/ vault/02_archive/trades/ -l | \
633
+ xargs rg '^outcome:' | sort
634
+
635
+ # Find all active theses approaching invalidation
636
+ rg '^status: active' vault/01_thinking/ --glob '*thesis*' -l | \
637
+ xargs rg '^invalidation_trigger:'
638
+
639
+ # Strategy drift: all rule violations in the last month
640
+ rg '^rule_violations: \[' vault/03_trades/open/ vault/02_archive/trades/2026-02/ | \
641
+ grep -v '\[\]'
642
+
643
+ # Thesis calibration: compare conviction to outcome for closed theses
644
+ rg '^calibration_outcome:' vault/02_archive/theses/ -B 5 | rg 'conviction|calibration'
645
+
646
+ # Find trades linked to a specific thesis
647
+ rg '\[\[AI-sector-rotation-thesis-2026-Q1\]\]' vault/03_trades/ vault/02_archive/trades/
648
+
649
+ # Emotional state tracking: find trades entered with specific emotions
650
+ rg '^emotions:.*anxious\|frustrated\|revenge' vault/03_trades/ vault/02_archive/trades/
651
+ ```
652
+
653
+ ---
654
+
655
+ ## What Makes This Domain Unique
656
+
657
+ ### Strategy drift detection is the killer feature
658
+
659
+ Most trading knowledge systems are passive — they record what happened. This system is active — it detects when behavior deviates from documented rules. The agent holds the strategy rules in memory and checks every trade against them. Silent drift becomes visible drift. This is the single feature that justifies the entire system.
660
+
661
+ No human trader can hold 47 trades in working memory while simultaneously checking each against 5 entry rules, 4 exit rules, and 3 position sizing constraints across 3 different strategies. The agent can. And because [[position-sizing-violations-cluster-after-losses]], the moments when the trader most needs rule enforcement are precisely the moments when emotional state makes self-enforcement least reliable.
662
+
663
+ ### Thesis calibration creates metacognitive feedback
664
+
665
+ Traders form theses constantly but rarely track their accuracy systematically. Was the sector rotation call right? Were earnings predictions calibrated? By linking every trade to a thesis and every thesis to its outcome, the agent builds a calibration record that answers questions humans avoid: "Am I actually good at this type of analysis, or do I just think I am?"
666
+
667
+ ### Temporal dynamics are extreme
668
+
669
+ Markets move on daily timescales. A thesis valid Monday can be invalidated by Tuesday's earnings report. This makes the maintenance cadence faster than any other domain in the example catalog. The review cycle (daily for trades, weekly for strategy, monthly for thesis calibration) reflects the domain's temporal urgency, and the agent's continuous monitoring catches what periodic human review would miss.
670
+
671
+ ---
672
+
673
+ ## Agent-Native Advantages
674
+
675
+ ### Exhaustive rule compliance checking
676
+
677
+ The agent checks every trade against every rule in the relevant strategy, every time. A human trader reviews their journal weekly if disciplined, monthly if not, and never with the statistical rigor the agent brings. The agent does not get tired at 3pm. It does not get overconfident after a winning streak. It does not skip the review when the P&L is good. Its compliance checking is exhaustive because that is what exhaustive means — no trade escapes review, no rule violation goes unlogged.
678
+
679
+ **What this looks like in practice:** Marcus closes a trade on TSLA. Before he moves on, the agent has already calculated the P&L, checked the position size against the strategy's 2% maximum, verified the entry criteria were met, logged the hold time against the time stop, compared the exit to the documented exit criteria, and flagged that the position size was 2.4% — a violation. It links this violation to [[position-sizing-violations-cluster-after-losses]] because it knows Marcus had three consecutive losses before this trade. It updates the strategy's drift log. Marcus sees all of this in the trade note before his next trade.
680
+
681
+ ### Multi-dimensional pattern detection across time
682
+
683
+ The agent holds all 47 trades from the last quarter in its analytical frame simultaneously. It can correlate entry time with outcome, emotional state with rule compliance, conviction level with P&L, day-of-week with win rate, and any other combination of the dense metadata in trade notes. It detected [[tuesday-afternoon-entries-underperform]] not because it was looking for that specific pattern, but because it was looking at all patterns simultaneously.
684
+
685
+ **What this looks like in practice:** During a weekly review, the agent presents: "Three of your four losses this month were entered after 2pm. Your afternoon win rate is 44% versus 67% in the morning. This pattern has been stable for 90 days across 47 trades. Your two afternoon entries with conviction 4+ both won. Recommendation: consider a minimum conviction 4 threshold for entries after 2pm." Marcus did not know to look for this. The agent found it because it can examine every dimension of every trade simultaneously.
686
+
687
+ ### Thesis-to-outcome tracking with calibration feedback
688
+
689
+ Human traders form opinions about their forecasting ability that bear no relationship to reality. Cognitive biases (survivorship bias, hindsight bias, confirmation bias) corrupt self-assessment. The agent maintains an objective calibration record by comparing every thesis to its outcome and aggregating by thesis type.
690
+
691
+ **What this looks like in practice:** After six months, the agent reports: "You have originated 23 market theses. 14 were sector rotation, 6 were earnings-based, 3 were macro. Your sector rotation theses resolved correctly 71% of the time with an average conviction of 3.8 at origination. Your earnings theses resolved correctly 44% of the time despite an average conviction of 3.6 at origination. You are overconfident in your earnings analysis and well-calibrated on sector rotation. Recommendation: reduce position sizes on earnings-based trades to reflect the lower actual accuracy, or investigate what distinguishes your correct earnings predictions from your incorrect ones."
692
+
693
+ No human trader maintains this level of systematic self-knowledge. The agent does it automatically because it has every thesis, every conviction rating, and every outcome in its graph, and because it never forgets to check.
694
+
695
+ ---
696
+ ---
697
+
698
+ Topics:
699
+ - [[domain-compositions]]