rhachet-roles-ehmpathy 1.15.13 → 1.15.15

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 (449) hide show
  1. package/dist/contract/commands/codegenBriefOptions.js +0 -2
  2. package/dist/contract/commands/codegenBriefOptions.js.map +1 -1
  3. package/dist/contract/sdk/index.d.ts +1 -1
  4. package/dist/contract/sdk/index.js +1 -1
  5. package/dist/contract/sdk/index.js.map +1 -1
  6. package/dist/domain.roles/architect/getArchitectRole.js.map +1 -0
  7. package/dist/domain.roles/ecologist/getEcologistBrief.Options.codegen.js.map +1 -0
  8. package/dist/domain.roles/ecologist/getEcologistBrief.js.map +1 -0
  9. package/dist/domain.roles/ecologist/getEcologistRole.js.map +1 -0
  10. package/dist/{roles → domain.roles}/getRoleRegistry.js +0 -2
  11. package/dist/domain.roles/getRoleRegistry.js.map +1 -0
  12. package/dist/domain.roles/getRoleRegistry.readme.js.map +1 -0
  13. package/dist/domain.roles/mechanic/briefs/practices/code.prod/pitofsuccess.typedefs/rule.forbid.as-cast.md +65 -0
  14. package/dist/domain.roles/mechanic/briefs/practices/code.prod/pitofsuccess.typedefs/rule.require.shapefit.md +41 -0
  15. package/dist/{roles/mechanic/briefs/criteria.practices/prefer.emojis.chill_nature.md → domain.roles/mechanic/briefs/practices/lang.tones/rule.prefer.chill-nature-emojis.md} +0 -1
  16. package/dist/domain.roles/mechanic/getMechanicBrief.Options.codegen.js.map +1 -0
  17. package/dist/domain.roles/mechanic/getMechanicBrief.js.map +1 -0
  18. package/dist/{roles → domain.roles}/mechanic/getMechanicRole.js +7 -3
  19. package/dist/domain.roles/mechanic/getMechanicRole.js.map +1 -0
  20. package/package.json +4 -5
  21. package/dist/.test/genContextLogTrail.d.ts +0 -2
  22. package/dist/.test/genContextLogTrail.js +0 -12
  23. package/dist/.test/genContextLogTrail.js.map +0 -1
  24. package/dist/.test/genContextStitchTrail.d.ts +0 -1
  25. package/dist/.test/genContextStitchTrail.js +0 -6
  26. package/dist/.test/genContextStitchTrail.js.map +0 -1
  27. package/dist/.test/getContextOpenAI.d.ts +0 -2
  28. package/dist/.test/getContextOpenAI.js +0 -19
  29. package/dist/.test/getContextOpenAI.js.map +0 -1
  30. package/dist/roles/architect/getArchitectRole.js.map +0 -1
  31. package/dist/roles/bhrain/briefs/cognition/cog000.overview.and.premise.md +0 -115
  32. package/dist/roles/bhrain/briefs/cognition/cog021.coordinates.spherical.md +0 -69
  33. package/dist/roles/bhrain/briefs/cognition/cog021.metaphor.cauliflorous.md +0 -44
  34. package/dist/roles/bhrain/briefs/cognition/cog021.metaphor.galactic_spacetravel.[article].md +0 -42
  35. package/dist/roles/bhrain/briefs/cognition/cog021.metaphor.galactic_spacetravel.[lesson].md +0 -60
  36. package/dist/roles/bhrain/briefs/cognition/cog021.structs.catalog.md +0 -51
  37. package/dist/roles/bhrain/briefs/cognition/cog021.structs.treestruct.md +0 -85
  38. package/dist/roles/bhrain/briefs/cognition/cog021.structs.vector.md +0 -112
  39. package/dist/roles/bhrain/briefs/cognition/cog101.concept.definition.md +0 -115
  40. package/dist/roles/bhrain/briefs/cognition/cog101.concept.treestruct._.md +0 -112
  41. package/dist/roles/bhrain/briefs/cognition/cog101.concept.treestruct.coords.1.spherical.md +0 -80
  42. package/dist/roles/bhrain/briefs/cognition/cog101.concept.treestruct.coords.2.abstractive.md +0 -59
  43. package/dist/roles/bhrain/briefs/cognition/cog101.concept.treestruct.coords.3.descriptive.md +0 -64
  44. package/dist/roles/bhrain/briefs/cognition/cog101.concept.treestruct.persp.1.perspectives.md +0 -88
  45. package/dist/roles/bhrain/briefs/cognition/cog101.concept.treestruct.persp.2.universal.md +0 -82
  46. package/dist/roles/bhrain/briefs/cognition/cog101.concept.treestruct.persp.3.relative.md +0 -106
  47. package/dist/roles/bhrain/briefs/cognition/cog101.concept.treestruct.persp.4.fractal.md +0 -83
  48. package/dist/roles/bhrain/briefs/cognition/cog151.concept.treestruct.gravity.md +0 -89
  49. package/dist/roles/bhrain/briefs/cognition/cog201.cortal.focus.p1.definition.md +0 -231
  50. package/dist/roles/bhrain/briefs/cognition/cog201.cortal.focus.p1.examples.cont.md +0 -82
  51. package/dist/roles/bhrain/briefs/cognition/cog201.cortal.focus.p2.acuity.md +0 -134
  52. package/dist/roles/bhrain/briefs/cognition/cog201.cortal.focus.p2.breadth.md +0 -151
  53. package/dist/roles/bhrain/briefs/cognition/cog201.cortal.focus.p2.depth.md +0 -147
  54. package/dist/roles/bhrain/briefs/cognition/cog251.cortal.focus.p3.fabric.md +0 -96
  55. package/dist/roles/bhrain/briefs/cognition/cog251.cortal.focus.p3.mode.md +0 -68
  56. package/dist/roles/bhrain/briefs/cognition/cog251.cortal.focus.p3.rythm.md +0 -56
  57. package/dist/roles/bhrain/briefs/cognition/cog251.cortal.focus.p3.usecases.md +0 -76
  58. package/dist/roles/bhrain/briefs/cognition/cog301.traversal.1.motion.primitives._.md +0 -155
  59. package/dist/roles/bhrain/briefs/cognition/cog301.traversal.1.motion.primitives.acuity.md +0 -94
  60. package/dist/roles/bhrain/briefs/cognition/cog301.traversal.1.motion.primitives.breadth.md +0 -114
  61. package/dist/roles/bhrain/briefs/cognition/cog301.traversal.1.motion.primitives.breadth.vary.md +0 -105
  62. package/dist/roles/bhrain/briefs/cognition/cog301.traversal.1.motion.primitives.depth.md +0 -132
  63. package/dist/roles/bhrain/briefs/cognition/cog301.traversal.2.motion.composites._.md +0 -106
  64. package/dist/roles/bhrain/briefs/cognition/cog301.traversal.2.motion.composites.grammar.md +0 -105
  65. package/dist/roles/bhrain/briefs/cognition/cog401.questions.._.md +0 -209
  66. package/dist/roles/bhrain/briefs/cognition/cog401.questions.1.persp.as.berries.md +0 -168
  67. package/dist/roles/bhrain/briefs/cognition/cog401.questions.1.persp.as.vectors.md +0 -74
  68. package/dist/roles/bhrain/briefs/cognition/cog401.questions.1.persp.has.precision.tunable.md +0 -80
  69. package/dist/roles/bhrain/briefs/cognition/cog401.questions.2.1.primitives.rough._.md +0 -99
  70. package/dist/roles/bhrain/briefs/cognition/cog401.questions.2.1.primitives.rough.interrogative.md +0 -108
  71. package/dist/roles/bhrain/briefs/cognition/cog401.questions.2.1.primitives.rough.why.[article].md +0 -55
  72. package/dist/roles/bhrain/briefs/cognition/cog401.questions.2.2.composite.smooth._.md +0 -83
  73. package/dist/roles/bhrain/briefs/cognition/cog401.questions.2.2.composite.smooth.examples.md +0 -101
  74. package/dist/roles/bhrain/briefs/cognition/cog501.cortal.assemblylang.1.primitives._.md +0 -134
  75. package/dist/roles/bhrain/briefs/cognition/cog501.cortal.assemblylang.1.primitives.recall.md +0 -149
  76. package/dist/roles/bhrain/briefs/cognition/cog501.cortal.assemblylang.1.primitives.steer.md +0 -146
  77. package/dist/roles/bhrain/briefs/cognition/cog501.cortal.assemblylang.1.primitives.think.md +0 -141
  78. package/dist/roles/bhrain/briefs/cognition/cog501.cortal.assemblylang.2.composites.zoom.md +0 -127
  79. package/dist/roles/bhrain/briefs/cognition/cog501.cortal.assemblylang.3.catalogs.md +0 -107
  80. package/dist/roles/bhrain/briefs/cognition/cog501.cortal.assemblylang.3.grammar.md +0 -124
  81. package/dist/roles/bhrain/briefs/cognition/inflight/concept.vs.idea.md +0 -70
  82. package/dist/roles/bhrain/briefs/cognition/inflight/core.concept.adjectives.md +0 -8
  83. package/dist/roles/bhrain/briefs/distilisys.grammar.compressed.md +0 -19
  84. package/dist/roles/bhrain/briefs/grammar/gerunds.1.why.common.[article].md +0 -32
  85. package/dist/roles/bhrain/briefs/grammar/gerunds.1.why.term_smells.[article].md +0 -36
  86. package/dist/roles/bhrain/briefs/grammar/gerunds.1.why.term_smells.detection.[lesson].md +0 -73
  87. package/dist/roles/bhrain/briefs/grammar/gerunds.2.tactic.eliminate.[article].md +0 -55
  88. package/dist/roles/bhrain/briefs/grammar/gerunds.2.tactic.eliminate.[lesson].md +0 -41
  89. package/dist/roles/bhrain/briefs/grammar/gerunds.3.eliminator.[trait]._.md +0 -66
  90. package/dist/roles/bhrain/briefs/grammar/gerunds.3.eliminator.[trait].balance.md +0 -36
  91. package/dist/roles/bhrain/briefs/grammar/gerunds.3.eliminator.[trait].bane.md +0 -34
  92. package/dist/roles/bhrain/briefs/grammar/gerunds.3.eliminator.[trait].boon.md +0 -35
  93. package/dist/roles/bhrain/briefs/knowledge/kno101.primitives.1.ontology.[article].frame.docs_as_materializations.md +0 -63
  94. package/dist/roles/bhrain/briefs/knowledge/kno101.primitives.1.ontology.[article].frame.docs_as_references.md +0 -45
  95. package/dist/roles/bhrain/briefs/knowledge/kno101.primitives.2.rel.many_to_many.[article].md +0 -37
  96. package/dist/roles/bhrain/briefs/knowledge/kno101.primitives.3.instances.[article].md +0 -39
  97. package/dist/roles/bhrain/briefs/knowledge/kno101.primitives.4.documents.[article].md +0 -37
  98. package/dist/roles/bhrain/briefs/knowledge/kno101.primitives.5.concepts.[article].md +0 -39
  99. package/dist/roles/bhrain/briefs/knowledge/kno201.documents._.[article].md +0 -48
  100. package/dist/roles/bhrain/briefs/knowledge/kno201.documents._.[catalog].md +0 -52
  101. package/dist/roles/bhrain/briefs/knowledge/kno201.documents.articles.[article].md +0 -40
  102. package/dist/roles/bhrain/briefs/knowledge/kno201.documents.catalogs.[article].md +0 -41
  103. package/dist/roles/bhrain/briefs/knowledge/kno201.documents.demos.[article].md +0 -42
  104. package/dist/roles/bhrain/briefs/knowledge/kno201.documents.lessons.[article].md +0 -42
  105. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.compression.1.refs._.[article].md +0 -41
  106. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.compression.2.kernels._.[article].i1.md +0 -50
  107. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.compression.3.briefs._.[article].md +0 -40
  108. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.compression._.[article].md +0 -90
  109. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.compression._.[catalog].persp.garden.md +0 -64
  110. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.1.from_instances.[article].md +0 -45
  111. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].algorithm.md +0 -54
  112. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].color.md +0 -56
  113. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].empathy.md +0 -54
  114. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].entropy.md +0 -54
  115. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].gravity.md +0 -54
  116. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].joke.md +0 -56
  117. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].value.md +0 -54
  118. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.2._.[catalog].md +0 -43
  119. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.2.articulate.[article].md +0 -27
  120. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.2.articulate.[lesson].md +0 -49
  121. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.2.catalogize.[article].md +0 -27
  122. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.2.catalogize.[lesson].md +0 -54
  123. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.2.demonstrate.[article].md +0 -26
  124. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.2.demonstrate.[lesson].md +0 -49
  125. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.2.lessonize.[article].md +0 -26
  126. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.enbrief.2.lessonize.[lesson].md +0 -54
  127. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.kernelize._.[article].md +0 -58
  128. package/dist/roles/bhrain/briefs/knowledge/kno301.doc.kernelize._.[lesson].md +0 -88
  129. package/dist/roles/bhrain/briefs/knowledge/kno351.docs.are_instances.[article].md +0 -34
  130. package/dist/roles/bhrain/briefs/knowledge/kno351.docs.recursion.[catalog].md +0 -44
  131. package/dist/roles/bhrain/briefs/knowledge/kno401.actors.1.role.author.[article].md +0 -36
  132. package/dist/roles/bhrain/briefs/knowledge/kno401.actors.1.role.librarian.[article].md +0 -40
  133. package/dist/roles/bhrain/briefs/knowledge/kno401.actors.2.interdependence.[article].md +0 -52
  134. package/dist/roles/bhrain/briefs/knowledge/kno501.doc.enbrief.catalog.structure1.[article].md +0 -53
  135. package/dist/roles/bhrain/briefs/knowledge/kno501.doc.enbrief.catalog.structure1.[lesson].template.md +0 -101
  136. package/dist/roles/bhrain/briefs/librarian.context/article.variant.vision.[article].md +0 -60
  137. package/dist/roles/bhrain/briefs/librarian.context/term.expectation.vs_assumption._.md +0 -60
  138. package/dist/roles/bhrain/briefs/librarian.context/term.frame.vs_perspective.[article].md +0 -96
  139. package/dist/roles/bhrain/briefs/librarian.context/term.invariant.[article].md +0 -29
  140. package/dist/roles/bhrain/briefs/librarian.context/term.lesson._vs_article.[article].md +0 -36
  141. package/dist/roles/bhrain/briefs/librarian.context/term.ref._vs_brief.md +0 -90
  142. package/dist/roles/bhrain/briefs/librarian.context/term.referent.[article].md +0 -43
  143. package/dist/roles/bhrain/briefs/librarian.context/usage.lesson_vs_article.[lesson].md +0 -31
  144. package/dist/roles/bhrain/briefs/librarian.context/usage.lesson_vs_article_vs_demo.[lesson].md +0 -37
  145. package/dist/roles/bhrain/briefs/librarian.tactics/.readme.md +0 -12
  146. package/dist/roles/bhrain/briefs/librarian.tactics/<articulate>._.[article].frame.cognitive.md +0 -33
  147. package/dist/roles/bhrain/briefs/librarian.tactics/<articulate>._.[article].frame.tactical.md +0 -45
  148. package/dist/roles/bhrain/briefs/librarian.tactics/<articulate>.tactic.[catalog].md +0 -83
  149. package/dist/roles/bhrain/briefs/librarian.tactics/<articulate>.tactic.concept_dimension.examples.[article][seed].md +0 -4
  150. package/dist/roles/bhrain/briefs/librarian.tactics/<articulate>.tactic.concept_dimension.invariants.[article].md +0 -36
  151. package/dist/roles/bhrain/briefs/librarian.tactics/<articulate>.tactic.from.examples.md +0 -44
  152. package/dist/roles/bhrain/briefs/librarian.tactics/<articulate>.tactic.from.seed.md +0 -48
  153. package/dist/roles/bhrain/briefs/librarian.tactics/<articulate>.tactic.with.templates.[article].md +0 -57
  154. package/dist/roles/bhrain/briefs/librarian.tactics/<articulate>.tactic.with.templates.[gallery][review].effective.md +0 -1
  155. package/dist/roles/bhrain/briefs/librarian.tactics/<articulate>.tone.bluecollar.[article][seed].md +0 -5
  156. package/dist/roles/bhrain/briefs/librarian.tactics/<catalogize>._.[article][seed].md +0 -3
  157. package/dist/roles/bhrain/briefs/librarian.tactics/<catalogize>.observation.via_clusterage_over_via_imagination.[seed].md +0 -6
  158. package/dist/roles/bhrain/briefs/librarian.tactics/<catalogize>.vs_diverge.[article].persp.save_compute.md +0 -46
  159. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>._.[article].frame.colloquial.i2.by_grok.md +0 -64
  160. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.[catalog].md +0 -106
  161. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.contrast.[demo].usecase.vs_userjourney.by_chatgpt.md +0 -45
  162. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.counter.[demo].usecase.flyer.by_chargpt.md +0 -38
  163. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.counter.[demo].walkability.phoenix.by_chargpt.md +0 -41
  164. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.example.[demo].shear_force.scissors.by_grok.md +0 -52
  165. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.example.[demo].tea.darjeeling.by_grok.md +0 -50
  166. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.example.[demo].usecase.book_flight.by_grok.md +0 -54
  167. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.example.[demo].usecase.order_food.by_chatgpt.md +0 -40
  168. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.example.[demo].walkability.portland.by_chatgpt.i3.md +0 -42
  169. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.example.[demo].walkability.portland.by_grok.i2.md +0 -49
  170. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.example.[lesson].howto.md +0 -28
  171. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.example.structure.[article].i2.md +0 -73
  172. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.narrative.[demo].usecase.order_online.by_chatgpt.md +0 -34
  173. package/dist/roles/bhrain/briefs/librarian.tactics/<demonstrate>.variants.walkthrough.[demo].usecase.book_online.by_chatgpt.md +0 -47
  174. package/dist/roles/bhrain/briefs/librarian.tactics/[brief].verbiage.outline.over.narrative.md +0 -55
  175. package/dist/roles/bhrain/briefs/logistics/term.logistics.[article].md +0 -21
  176. package/dist/roles/bhrain/briefs/logistics/term.logistics.of_information.[article].md +0 -22
  177. package/dist/roles/bhrain/briefs/logistics/term.logistics.of_knowledge.[article].md +0 -29
  178. package/dist/roles/bhrain/briefs/physics/optics.focal.acuity.md +0 -77
  179. package/dist/roles/bhrain/briefs/physics/optics.focal.breadth.md +0 -74
  180. package/dist/roles/bhrain/briefs/physics/optics.focal.depth.md +0 -77
  181. package/dist/roles/bhrain/briefs/physics/optics.focal.distance.md +0 -92
  182. package/dist/roles/bhrain/briefs/physics/optics.focal.tradeoffs.md +0 -107
  183. package/dist/roles/bhrain/briefs/tactician/tactics.compose.traits_and_skills.[article].md +0 -76
  184. package/dist/roles/bhrain/briefs/tactician/trait.articulation.[article].md +0 -67
  185. package/dist/roles/bhrain/briefs/tactician/trait.purpose.[article].md +0 -56
  186. package/dist/roles/bhrain/briefs/tactician/trait.vs_skill.[article].md +0 -55
  187. package/dist/roles/bhrain/briefs/tactician/trait.vs_tactic.[article].md +0 -70
  188. package/dist/roles/bhrain/briefs/terms.motive.intent.goal.md +0 -46
  189. package/dist/roles/bhrain/briefs/thinker.tactics/<cluster>._.[article].frame.tactical._.md +0 -85
  190. package/dist/roles/bhrain/briefs/thinker.tactics/<cluster>.vs_<diverge>.duality.[article].md +0 -43
  191. package/dist/roles/bhrain/briefs/thinker.tactics/<diverge>._.[article].frame.cognitive.[seed].md +0 -4
  192. package/dist/roles/bhrain/briefs/thinker.tactics/<diverge>._.[article].frame.tactical.md +0 -89
  193. package/dist/roles/bhrain/briefs/thinker.tactics/<elaborate>_vs_<elucidate>.[seed].md +0 -1
  194. package/dist/roles/bhrain/briefs/thinker.tactics/<enquestion>._.[article].md +0 -113
  195. package/dist/roles/bhrain/briefs/thinker.tactics/<enquestion>._.[gallery].plumber.diagnose.md +0 -130
  196. package/dist/roles/bhrain/briefs/thinker.tactics/<enquestion>._.[gallery].thinker.enquestion.md +0 -125
  197. package/dist/roles/bhrain/briefs/thinker.tactics/<enquestion>.tactic.perspectives.[article].md +0 -36
  198. package/dist/roles/bhrain/briefs/thinker.tactics/<triage>._.[article].frame.tactical.md +0 -85
  199. package/dist/roles/bhrain/briefs/thinker.tactics/<triage>.persp.grades_from_context.[article].md +0 -48
  200. package/dist/roles/bhrain/briefs/thinker.tactics/<triage>.persp.implicit_question.[article].md +0 -65
  201. package/dist/roles/bhrain/briefs/trait.chillnature.md +0 -14
  202. package/dist/roles/bhrain/briefs/trait.ocd.md +0 -5
  203. package/dist/roles/bhrain/briefs/worders/core.matmuls_vecmuls_elemuls.md +0 -93
  204. package/dist/roles/bhrain/briefs/worders/core.transformers.as_origin.md +0 -62
  205. package/dist/roles/bhrain/briefs/worders/core.transformers.self_attention.[article].md +0 -93
  206. package/dist/roles/bhrain/briefs/worders/core.transformers.self_attention.[demo].ambig.bank.md +0 -80
  207. package/dist/roles/bhrain/briefs/worders/core.transformers.self_attention.[demo].cat_sat.md +0 -67
  208. package/dist/roles/bhrain/briefs/worders/force.repeat_input_structures.md +0 -48
  209. package/dist/roles/bhrain/briefs/worders/knowledge.interdependence.[article].md +0 -37
  210. package/dist/roles/bhrain/briefs/worders/knowledge.interdependence.[demo].domain.physics.md +0 -30
  211. package/dist/roles/bhrain/briefs/worders/knowledge.internal_vs_external.[article].artist_vs_librarian.md +0 -44
  212. package/dist/roles/bhrain/briefs/worders/knowledge.internal_vs_external.[demo].artist_vs_librarian.md +0 -37
  213. package/dist/roles/bhrain/briefs/worders/knowledge.internal_vs_external.[demo].domain.physics.md +0 -39
  214. package/dist/roles/bhrain/briefs/worders/knowledge.internalized.[article].md +0 -35
  215. package/dist/roles/bhrain/briefs/worders/knowledge.internalized.[demo].artist.md +0 -36
  216. package/dist/roles/bhrain/briefs/worders/knowledge.internalized.[demo].neural.md +0 -37
  217. package/dist/roles/bhrain/briefs/worders/knowledge.internalized.[demo].pianist.md +0 -34
  218. package/dist/roles/bhrain/briefs/worders/limits.rhyme.md +0 -46
  219. package/dist/roles/bhrain/briefs/worders/limits.spell.md +0 -49
  220. package/dist/roles/bhrain/briefs/worders/teach.via.library.examples.md +0 -28
  221. package/dist/roles/bhrain/briefs/worders/teach.via.library.explanations_vs_examples.md +0 -40
  222. package/dist/roles/bhrain/briefs/worders/trend.prefer_reuse.[seed].md +0 -10
  223. package/dist/roles/bhrain/getBhrainBrief.Options.codegen.d.ts +0 -10
  224. package/dist/roles/bhrain/getBhrainBrief.Options.codegen.js +0 -203
  225. package/dist/roles/bhrain/getBhrainBrief.Options.codegen.js.map +0 -1
  226. package/dist/roles/bhrain/getBhrainBrief.d.ts +0 -13
  227. package/dist/roles/bhrain/getBhrainBrief.js +0 -21
  228. package/dist/roles/bhrain/getBhrainBrief.js.map +0 -1
  229. package/dist/roles/bhrain/getBhrainRole.d.ts +0 -2
  230. package/dist/roles/bhrain/getBhrainRole.js +0 -55
  231. package/dist/roles/bhrain/getBhrainRole.js.map +0 -1
  232. package/dist/roles/bhrain/skills/brief.articulate/stepArticulate.d.ts +0 -59
  233. package/dist/roles/bhrain/skills/brief.articulate/stepArticulate.js +0 -97
  234. package/dist/roles/bhrain/skills/brief.articulate/stepArticulate.js.map +0 -1
  235. package/dist/roles/bhrain/skills/brief.articulate/stepArticulate.skill.d.ts +0 -30
  236. package/dist/roles/bhrain/skills/brief.articulate/stepArticulate.skill.js +0 -125
  237. package/dist/roles/bhrain/skills/brief.articulate/stepArticulate.skill.js.map +0 -1
  238. package/dist/roles/bhrain/skills/brief.articulate/stepArticulate.template.md +0 -120
  239. package/dist/roles/bhrain/skills/brief.catalogize/stepCatalogize.d.ts +0 -54
  240. package/dist/roles/bhrain/skills/brief.catalogize/stepCatalogize.js +0 -74
  241. package/dist/roles/bhrain/skills/brief.catalogize/stepCatalogize.js.map +0 -1
  242. package/dist/roles/bhrain/skills/brief.catalogize/stepCatalogize.skill.d.ts +0 -28
  243. package/dist/roles/bhrain/skills/brief.catalogize/stepCatalogize.skill.js +0 -124
  244. package/dist/roles/bhrain/skills/brief.catalogize/stepCatalogize.skill.js.map +0 -1
  245. package/dist/roles/bhrain/skills/brief.demonstrate/stepDemonstrate.d.ts +0 -59
  246. package/dist/roles/bhrain/skills/brief.demonstrate/stepDemonstrate.js +0 -103
  247. package/dist/roles/bhrain/skills/brief.demonstrate/stepDemonstrate.js.map +0 -1
  248. package/dist/roles/bhrain/skills/brief.demonstrate/stepDemonstrate.skill.d.ts +0 -30
  249. package/dist/roles/bhrain/skills/brief.demonstrate/stepDemonstrate.skill.js +0 -138
  250. package/dist/roles/bhrain/skills/brief.demonstrate/stepDemonstrate.skill.js.map +0 -1
  251. package/dist/roles/bhrain/skills/brief.demonstrate/stepDemonstrate.template.md +0 -135
  252. package/dist/roles/bhrain/skills/khue.cluster/stepCluster.d.ts +0 -57
  253. package/dist/roles/bhrain/skills/khue.cluster/stepCluster.js +0 -91
  254. package/dist/roles/bhrain/skills/khue.cluster/stepCluster.js.map +0 -1
  255. package/dist/roles/bhrain/skills/khue.cluster/stepCluster.skill.d.ts +0 -29
  256. package/dist/roles/bhrain/skills/khue.cluster/stepCluster.skill.js +0 -127
  257. package/dist/roles/bhrain/skills/khue.cluster/stepCluster.skill.js.map +0 -1
  258. package/dist/roles/bhrain/skills/khue.cluster/stepCluster.template.md +0 -134
  259. package/dist/roles/bhrain/skills/khue.diverge/stepDiverge.d.ts +0 -57
  260. package/dist/roles/bhrain/skills/khue.diverge/stepDiverge.js +0 -92
  261. package/dist/roles/bhrain/skills/khue.diverge/stepDiverge.js.map +0 -1
  262. package/dist/roles/bhrain/skills/khue.diverge/stepDiverge.skill.d.ts +0 -29
  263. package/dist/roles/bhrain/skills/khue.diverge/stepDiverge.skill.js +0 -112
  264. package/dist/roles/bhrain/skills/khue.diverge/stepDiverge.skill.js.map +0 -1
  265. package/dist/roles/bhrain/skills/khue.diverge/stepDiverge.template.md +0 -110
  266. package/dist/roles/bhrain/skills/khue.instantiate/stepInstantiate.d.ts +0 -55
  267. package/dist/roles/bhrain/skills/khue.instantiate/stepInstantiate.js +0 -75
  268. package/dist/roles/bhrain/skills/khue.instantiate/stepInstantiate.js.map +0 -1
  269. package/dist/roles/bhrain/skills/khue.instantiate/stepInstantiate.skill.d.ts +0 -28
  270. package/dist/roles/bhrain/skills/khue.instantiate/stepInstantiate.skill.js +0 -136
  271. package/dist/roles/bhrain/skills/khue.instantiate/stepInstantiate.skill.js.map +0 -1
  272. package/dist/roles/bhrain/skills/khue.instantiate/stepInstantiate.template.md +0 -73
  273. package/dist/roles/bhrain/skills/khue.triage/stepTriage.d.ts +0 -57
  274. package/dist/roles/bhrain/skills/khue.triage/stepTriage.js +0 -93
  275. package/dist/roles/bhrain/skills/khue.triage/stepTriage.js.map +0 -1
  276. package/dist/roles/bhrain/skills/khue.triage/stepTriage.skill.d.ts +0 -29
  277. package/dist/roles/bhrain/skills/khue.triage/stepTriage.skill.js +0 -127
  278. package/dist/roles/bhrain/skills/khue.triage/stepTriage.skill.js.map +0 -1
  279. package/dist/roles/bhrain/skills/khue.triage/stepTriage.template.md +0 -128
  280. package/dist/roles/ecologist/getEcologistBrief.Options.codegen.js.map +0 -1
  281. package/dist/roles/ecologist/getEcologistBrief.js.map +0 -1
  282. package/dist/roles/ecologist/getEcologistRole.js.map +0 -1
  283. package/dist/roles/getRoleRegistry.js.map +0 -1
  284. package/dist/roles/getRoleRegistry.readme.js.map +0 -1
  285. package/dist/roles/mechanic/briefs/architecture/ubiqlang.md +0 -37
  286. package/dist/roles/mechanic/briefs/patterns/code.prod.declarative/.readme.md +0 -0
  287. package/dist/roles/mechanic/briefs/patterns/lang.tones/prefer.chill-nature.md +0 -0
  288. package/dist/roles/mechanic/briefs/patterns/lang.tones/prefer.lowercase.md +0 -0
  289. package/dist/roles/mechanic/getMechanicBrief.Options.codegen.js.map +0 -1
  290. package/dist/roles/mechanic/getMechanicBrief.js.map +0 -1
  291. package/dist/roles/mechanic/getMechanicRole.js.map +0 -1
  292. package/dist/roles/mechanic/skills/git.worktree.common.sh +0 -58
  293. package/dist/roles/mechanic/skills/git.worktree.del.sh +0 -51
  294. package/dist/roles/mechanic/skills/git.worktree.get.sh +0 -51
  295. package/dist/roles/mechanic/skills/git.worktree.set.sh +0 -108
  296. package/dist/roles/mechanic/skills/git.worktree.sh +0 -46
  297. package/dist/roles/mechanic/skills/init.bhuild.sh +0 -311
  298. package/dist/roles/mechanic/skills/test.integration.sh +0 -50
  299. /package/dist/{roles → domain.roles}/architect/briefs/criteria.given_when_then.[seed].v3.md +0 -0
  300. /package/dist/{roles → domain.roles}/architect/briefs/practices/prefer.env_access.prep_over_dev.md +0 -0
  301. /package/dist/{roles → domain.roles}/architect/briefs/ubiqlang.ambiguous-from-overload.md +0 -0
  302. /package/dist/{roles → domain.roles}/architect/getArchitectRole.d.ts +0 -0
  303. /package/dist/{roles → domain.roles}/architect/getArchitectRole.js +0 -0
  304. /package/dist/{roles → domain.roles}/ecologist/briefs/.readme.md +0 -0
  305. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys101.distilisys.grammar.md +0 -0
  306. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys201.actor.motive._.summary.md +0 -0
  307. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys201.actor.motive.p1.reversibility.entropy.md +0 -0
  308. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys201.actor.motive.p2.option.chance.choice.md +0 -0
  309. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys201.actor.motive.p3.chance.motive.polarity.threat.md +0 -0
  310. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys201.actor.motive.p4.motive.horizon.md +0 -0
  311. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys201.actor.motive.p5.motive.grammar.md +0 -0
  312. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys211.actor.resources._.primitives.summary.md +0 -0
  313. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys211.actor.resources.pt1.primitive.time.md +0 -0
  314. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys211.actor.resources.pt2.primitive.energy.md +0 -0
  315. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys211.actor.resources.pt3.primitive.space.md +0 -0
  316. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys211.actor.resources.pt4.primitive.claim.md +0 -0
  317. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys211.actor.resources.pt5.composites.md +0 -0
  318. /package/dist/{roles → domain.roles}/ecologist/briefs/distilisys/sys231.actor.claims.p1.primitive.exchange.md +0 -0
  319. /package/dist/{roles → domain.roles}/ecologist/briefs/ecology/.eco001.origin.prompt.md +0 -0
  320. /package/dist/{roles → domain.roles}/ecologist/briefs/ecology/eco001.overview.md +0 -0
  321. /package/dist/{roles → domain.roles}/ecologist/briefs/ecology/eco101.core-system-understanding.md +0 -0
  322. /package/dist/{roles → domain.roles}/ecologist/briefs/ecology/eco101.p1.ecosystem-structure.md +0 -0
  323. /package/dist/{roles → domain.roles}/ecologist/briefs/ecology/eco101.p2.trophic-dynamics.md +0 -0
  324. /package/dist/{roles → domain.roles}/ecologist/briefs/ecology/eco101.p3.population-ecology.md +0 -0
  325. /package/dist/{roles → domain.roles}/ecologist/briefs/ecology/eco101.p4.community-interactions.md +0 -0
  326. /package/dist/{roles → domain.roles}/ecologist/briefs/ecology/eco505.systems-thinking.md +0 -0
  327. /package/dist/{roles → domain.roles}/ecologist/briefs/economy/econ001.overview.md +0 -0
  328. /package/dist/{roles → domain.roles}/ecologist/briefs/economy/econ101.core-mechanics.md +0 -0
  329. /package/dist/{roles → domain.roles}/ecologist/briefs/economy/econ101.p1.supply-and-demand.md +0 -0
  330. /package/dist/{roles → domain.roles}/ecologist/briefs/economy/econ101.p2.opportunity-cost.md +0 -0
  331. /package/dist/{roles → domain.roles}/ecologist/briefs/economy/econ101.p3.marginal-analysis.md +0 -0
  332. /package/dist/{roles → domain.roles}/ecologist/briefs/economy/econ101.p4.rational-choice.md +0 -0
  333. /package/dist/{roles → domain.roles}/ecologist/briefs/economy/econ201.market-structures-and-failures.md +0 -0
  334. /package/dist/{roles → domain.roles}/ecologist/briefs/economy/econ301.production-and-growth.md +0 -0
  335. /package/dist/{roles → domain.roles}/ecologist/briefs/economy/econ401.macro-systems.md +0 -0
  336. /package/dist/{roles → domain.roles}/ecologist/briefs/economy/econ501.global-and-institutional.md +0 -0
  337. /package/dist/{roles → domain.roles}/ecologist/briefs/economy/econ501.p1.game-theory.md +0 -0
  338. /package/dist/{roles → domain.roles}/ecologist/briefs/economy/econ501.p4.behavioral-economics.md +0 -0
  339. /package/dist/{roles → domain.roles}/ecologist/briefs/product/user.journey._.[article].i1.md +0 -0
  340. /package/dist/{roles → domain.roles}/ecologist/briefs/product/user.journey._.[article].md +0 -0
  341. /package/dist/{roles → domain.roles}/ecologist/briefs/product/user.journey.purpose.[article].i1.md +0 -0
  342. /package/dist/{roles → domain.roles}/ecologist/briefs/product/user.journey.purpose.[article].md +0 -0
  343. /package/dist/{roles → domain.roles}/ecologist/briefs/term.distillation.md +0 -0
  344. /package/dist/{roles → domain.roles}/ecologist/getEcologistBrief.Options.codegen.d.ts +0 -0
  345. /package/dist/{roles → domain.roles}/ecologist/getEcologistBrief.Options.codegen.js +0 -0
  346. /package/dist/{roles → domain.roles}/ecologist/getEcologistBrief.d.ts +0 -0
  347. /package/dist/{roles → domain.roles}/ecologist/getEcologistBrief.js +0 -0
  348. /package/dist/{roles → domain.roles}/ecologist/getEcologistRole.d.ts +0 -0
  349. /package/dist/{roles → domain.roles}/ecologist/getEcologistRole.js +0 -0
  350. /package/dist/{roles → domain.roles}/getRoleRegistry.d.ts +0 -0
  351. /package/dist/{roles → domain.roles}/getRoleRegistry.readme.d.ts +0 -0
  352. /package/dist/{roles → domain.roles}/getRoleRegistry.readme.js +0 -0
  353. /package/dist/{roles/mechanic/briefs/codestyle → domain.roles/mechanic/briefs/.archive}/_mech.compressed.md +0 -0
  354. /package/dist/{roles/mechanic/briefs/codestyle → domain.roles/mechanic/briefs/.archive}/_mech.compressed.prompt.md +0 -0
  355. /package/dist/{roles/bhrain/briefs/cognition/cog501.cortal.assemblylang_.md → domain.roles/mechanic/briefs/.archive/code.prod.declarative.readme.md} +0 -0
  356. /package/dist/{roles/mechanic/briefs/architecture/directional-dependencies.md → domain.roles/mechanic/briefs/.archive/patterns.directional-dependencies.md} +0 -0
  357. /package/dist/{roles/mechanic/briefs → domain.roles/mechanic/briefs/.archive}/style.compressed.md +0 -0
  358. /package/dist/{roles/mechanic/briefs → domain.roles/mechanic/briefs/.archive}/style.compressed.prompt.md +0 -0
  359. /package/dist/{roles/mechanic/briefs/criteria.practices/require.dependency.pinned_versions.md → domain.roles/mechanic/briefs/practices/code.prod/consistent.artifacts/rule.require.pinned-versions.md} +0 -0
  360. /package/dist/{roles/mechanic/briefs/patterns/code.prod.typescript.utils/best-practice/ref.package.as-command.[tips].md → domain.roles/mechanic/briefs/practices/code.prod/consistent.contracts/ref.package.as-command.[ref].md} +0 -0
  361. /package/dist/{roles/mechanic/briefs/architecture/bounded-contexts.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.architecture/rule.require.bounded-contexts.md} +0 -0
  362. /package/dist/{roles/mechanic/briefs/architecture/domain-driven-design.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.architecture/rule.require.domain-driven-design.md} +0 -0
  363. /package/dist/{roles/mechanic/briefs/patterns/code.prod.domain.objects/best-practice/ref.package.domain-objects.[readme].md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.domain.objects/ref.package.domain-objects.[ref].md} +0 -0
  364. /package/dist/{roles/mechanic/briefs/patterns/code.prod.domain.objects/bad-practices/blocker.has.attributes.nullable.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.domain.objects/rule.forbid.nullable-without-reason.md} +0 -0
  365. /package/dist/{roles/mechanic/briefs/patterns/code.prod.domain.objects/bad-practices/blocker.has.attributes.undefined.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.domain.objects/rule.forbid.undefined-attributes.md} +0 -0
  366. /package/dist/{roles/mechanic/briefs/patterns/code.prod.domain.objects/bad-practices/blocker.refs.immuatble.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.domain.objects/rule.require.immutable-refs.md} +0 -0
  367. /package/dist/{roles/mechanic/briefs/patterns/code.prod.domain.operations/best-practice/require.sync.names.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.domain.operations/rule.require.sync-filename-opname.md} +0 -0
  368. /package/dist/{roles/mechanic/briefs/patterns/code.prod.contract.inputs.nameargs/bad-practice/forbid.positional-args.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.procedures/rule.forbid.positional-args.md.pt1.md} +0 -0
  369. /package/dist/{roles/mechanic/briefs/patterns/code.prod.domain.operations/bad-practices/forbid.ordered-args.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.procedures/rule.forbid.positional-args.md.pt2.md} +0 -0
  370. /package/dist/{roles/mechanic/briefs/codestyle/mech.arrowonly.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.procedures/rule.require.arrow-only.md} +0 -0
  371. /package/dist/{roles/mechanic/briefs/codestyle/mech.clear-contracts.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.procedures/rule.require.clear-contracts.md} +0 -0
  372. /package/dist/{roles/mechanic/briefs/engineer/dependency-injection.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.procedures/rule.require.dependency-injection.md.pt1.md} +0 -0
  373. /package/dist/{roles/mechanic/briefs/engineer/dependency-injection.stub.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.procedures/rule.require.dependency-injection.md.pt2.md} +0 -0
  374. /package/dist/{roles/mechanic/briefs/codestyle/mech.args.input-context.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.procedures/rule.require.input-context-pattern.md.pt1.md} +0 -0
  375. /package/dist/{roles/mechanic/briefs/codestyle/mech.args.input-inline.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.procedures/rule.require.input-context-pattern.md.pt2.md} +0 -0
  376. /package/dist/{roles/mechanic/briefs/patterns/code.prod.contract.inputs.nameargs/best-practice/require.namedargs.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.procedures/rule.require.named-args.md} +0 -0
  377. /package/dist/{roles/mechanic/briefs/codestyle/flow.single-responsibility.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.procedures/rule.require.single-responsibility.md} +0 -0
  378. /package/dist/{roles/mechanic/briefs/patterns/code.prod.repo.structure/bad-practices/forbid.barrel.exports.ts.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.repo.structure/rule.forbid.barrel-exports.md} +0 -0
  379. /package/dist/{roles/mechanic/briefs/patterns/code.prod.repo.structure/bad-practices/forbid.index.ts.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.repo.structure/rule.forbid.index-ts.md} +0 -0
  380. /package/dist/{roles/mechanic/briefs/patterns/code.prod.repo.structure/best-practice/dot-test-and-dot-temp.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.repo.structure/rule.prefer.dot-dirs.md} +0 -0
  381. /package/dist/{roles/mechanic/briefs/patterns/code.prod.repo.structure/best-practice/directional-dependencies.md → domain.roles/mechanic/briefs/practices/code.prod/evolvable.repo.structure/rule.require.directional-deps.md} +0 -0
  382. /package/dist/{roles/mechanic/briefs/patterns/code.prod.errors.failfast/bad-practices/forbid.failhide.md → domain.roles/mechanic/briefs/practices/code.prod/pitofsuccess.errors/rule.forbid.error-hiding.md.pt1.md} +0 -0
  383. /package/dist/{roles/mechanic/briefs/patterns/code.prod.errors.failfast/bad-practices/forbid.hide_errors.md → domain.roles/mechanic/briefs/practices/code.prod/pitofsuccess.errors/rule.forbid.error-hiding.md.pt2.md} +0 -0
  384. /package/dist/{roles/mechanic/briefs/patterns/code.prod.errors.failfast/best-practice/prefer.HelpfulError.wrap.md → domain.roles/mechanic/briefs/practices/code.prod/pitofsuccess.errors/rule.prefer.helpful-error-wrap.md} +0 -0
  385. /package/dist/{roles/mechanic/briefs/patterns/code.prod.errors.failfast/best-practice/require.fail_fast.[demo].shell.md → domain.roles/mechanic/briefs/practices/code.prod/pitofsuccess.errors/rule.require.fail-fast.[demo].shell.md} +0 -0
  386. /package/dist/{roles/mechanic/briefs/patterns/code.prod.errors.failfast/best-practice/require.fail_fast.md → domain.roles/mechanic/briefs/practices/code.prod/pitofsuccess.errors/rule.require.fail-fast.[seed].md} +0 -0
  387. /package/dist/{roles/mechanic/briefs/codestyle/flow.failfast.md → domain.roles/mechanic/briefs/practices/code.prod/pitofsuccess.errors/rule.require.fail-fast.md} +0 -0
  388. /package/dist/{roles/mechanic/briefs/criteria.practices/require.idempotency.md → domain.roles/mechanic/briefs/practices/code.prod/pitofsuccess.procedures/rule.require.idempotency.[seed].md} +0 -0
  389. /package/dist/{roles/mechanic/briefs/codestyle/flow.idempotency.md → domain.roles/mechanic/briefs/practices/code.prod/pitofsuccess.procedures/rule.require.idempotent-procedures.md} +0 -0
  390. /package/dist/{roles/mechanic/briefs/codestyle/flow.immutability.md → domain.roles/mechanic/briefs/practices/code.prod/pitofsuccess.procedures/rule.require.immutable-vars.md} +0 -0
  391. /package/dist/{roles/mechanic/briefs/codestyle/pit-of-success.via.minimize-surface-area.md → domain.roles/mechanic/briefs/practices/code.prod/pitofsuccess.procedures/rule.require.pitofsuccess.md} +0 -0
  392. /package/dist/{roles/mechanic/briefs/lessons/code.prod.typescript.types/bivariance_vs_contravariance.[lesson].md → domain.roles/mechanic/briefs/practices/code.prod/pitofsuccess.typedefs/define.bivariance-for-generics.[lesson].md} +0 -0
  393. /package/dist/{roles/mechanic/briefs/codestyle/mech.what-why.v2.md → domain.roles/mechanic/briefs/practices/code.prod/readable.comments/rule.require.what-why-headers.md} +0 -0
  394. /package/dist/{roles/mechanic/briefs/codestyle/mech.what-why.md → domain.roles/mechanic/briefs/practices/code.prod/readable.comments/rule.require.what-why-headers.v1.md} +0 -0
  395. /package/dist/{roles/mechanic/briefs/patterns/code.prod.narrative/bad-practices/avoid.ifs.md → domain.roles/mechanic/briefs/practices/code.prod/readable.narrative/rule.avoid.unnecessary-ifs.md} +0 -0
  396. /package/dist/{roles/mechanic/briefs/patterns/code.prod.narrative/bad-practices/forbid.else.md → domain.roles/mechanic/briefs/practices/code.prod/readable.narrative/rule.forbid.else-branches.[demo].md} +0 -0
  397. /package/dist/{roles/mechanic/briefs/patterns/code.prod.narrative/bad-practices/forbid.else.v2.md → domain.roles/mechanic/briefs/practices/code.prod/readable.narrative/rule.forbid.else-branches.md} +0 -0
  398. /package/dist/{roles/mechanic/briefs/patterns/code.prod.narrative/best-practice/early-returns.named-checks.[demo].md → domain.roles/mechanic/briefs/practices/code.prod/readable.narrative/rule.prefer.early-returns.[demo].md} +0 -0
  399. /package/dist/{roles/mechanic/briefs/codestyle/flow.transformers_over_conditionals.[lesson].md → domain.roles/mechanic/briefs/practices/code.prod/readable.narrative/rule.prefer.transformers-over-conditionals.[lesson].md} +0 -0
  400. /package/dist/{roles/mechanic/briefs/codestyle/flow.narratives.md → domain.roles/mechanic/briefs/practices/code.prod/readable.narrative/rule.require.narrative-flow.md} +0 -0
  401. /package/dist/{roles/mechanic/briefs/patterns/code.prod.declarative/best-practice/declastruct.[demo].md → domain.roles/mechanic/briefs/practices/code.prod/readable.persistence/rule.prefer.declastruct.[demo].md} +0 -0
  402. /package/dist/{roles/mechanic/briefs/patterns/code.test.howto/best-practice/ref.test-fns.[readme].md → domain.roles/mechanic/briefs/practices/code.test/consistent.contracts/ref.package.test-fns.[ref].md} +0 -0
  403. /package/dist/{roles/mechanic/briefs/patterns/code.test.howto/best-practice/howto.write.bdd.[lesson].md → domain.roles/mechanic/briefs/practices/code.test/frames.behavior/howto.write-bdd.[lesson].md} +0 -0
  404. /package/dist/{roles/mechanic/briefs/codestyle/mech.tests.given-when-then.md → domain.roles/mechanic/briefs/practices/code.test/frames.behavior/rule.require.given-when-then.md} +0 -0
  405. /package/dist/{roles/mechanic/briefs/patterns/code.test.howto/best-practice/prefer.datadriven.md → domain.roles/mechanic/briefs/practices/code.test/frames.caselist/rule.prefer.data-driven.md} +0 -0
  406. /package/dist/{roles/mechanic/briefs/patterns/code.test.howto/best-practice → domain.roles/mechanic/briefs/practices/code.test/lessons.howto}/howto.diagnose.[lesson].md +0 -0
  407. /package/dist/{roles/mechanic/briefs/patterns/code.test.howto/best-practice → domain.roles/mechanic/briefs/practices/code.test/lessons.howto}/howto.run.[lesson].md +0 -0
  408. /package/dist/{roles/mechanic/briefs/patterns/code.test.howto/best-practice → domain.roles/mechanic/briefs/practices/code.test/lessons.howto}/howto.use.[lesson].md +0 -0
  409. /package/dist/{roles/mechanic/briefs/patterns/code.test.howto/best-practice/howto.write.[lesson].md → domain.roles/mechanic/briefs/practices/code.test/lessons.howto/howto.write.[lesson].md.pt1.md} +0 -0
  410. /package/dist/{roles/mechanic/briefs/patterns/code.test.howto/best-practice/howto.write.[lesson].on_scope.for_integ.md → domain.roles/mechanic/briefs/practices/code.test/lessons.howto/howto.write.[lesson].md.pt2.md} +0 -0
  411. /package/dist/{roles/mechanic/briefs/patterns/code.test.howto/best-practice/howto.write.[lesson].on_scope.for_units.md → domain.roles/mechanic/briefs/practices/code.test/lessons.howto/howto.write.[lesson].md.pt3.md} +0 -0
  412. /package/dist/{roles/mechanic/briefs/patterns/code.test.howto/best-practice/whento.snapshots.[lesson].md → domain.roles/mechanic/briefs/practices/code.test/lessons.howto/rule.require.snapshots.[lesson].md} +0 -0
  413. /package/dist/{roles/mechanic/briefs/patterns/code.test.acceptance/best-practice/blackbox.md → domain.roles/mechanic/briefs/practices/code.test/scope.acceptance/rule.require.blackbox.md} +0 -0
  414. /package/dist/{roles/mechanic/briefs/patterns → domain.roles/mechanic/briefs/practices}/lang.terms/.readme.md +0 -0
  415. /package/dist/{roles/mechanic/briefs/patterns/lang.terms/domain=practices.terms=forbid_prefer_desire_require.md → domain.roles/mechanic/briefs/practices/lang.terms/define.directives.terms=forbid_avoid_prefer_require.md} +0 -0
  416. /package/dist/{roles/mechanic/briefs/terms/plan.exec_vs_apply.md → domain.roles/mechanic/briefs/practices/lang.terms/define.exec-vs-apply.md} +0 -0
  417. /package/dist/{roles/mechanic/briefs/patterns/lang.terms/domain=software.terms=prodcode_vs_testcode.md → domain.roles/mechanic/briefs/practices/lang.terms/define.prodcode-testcode.terms=prodcode_vs_testcode.md} +0 -0
  418. /package/dist/{roles/mechanic/briefs/criteria.practices/never.term.script.md → domain.roles/mechanic/briefs/practices/lang.terms/rule.forbid.term-script.md.pt1.md} +0 -0
  419. /package/dist/{roles/mechanic/briefs/terms/badpractice/script.md → domain.roles/mechanic/briefs/practices/lang.terms/rule.forbid.term-script.md.pt2.md} +0 -0
  420. /package/dist/{roles/mechanic/briefs/patterns/lang.terms/bad-practices/forbid.term=existing.md → domain.roles/mechanic/briefs/practices/lang.terms/rule.forbid.term=existing.md} +0 -0
  421. /package/dist/{roles/mechanic/briefs/patterns/lang.terms/best-practice/require.order.noun_adj.md → domain.roles/mechanic/briefs/practices/lang.terms/rule.require.order.noun_adj.md} +0 -0
  422. /package/dist/{roles/mechanic/briefs/style.names.treestruct.md → domain.roles/mechanic/briefs/practices/lang.terms/rule.require.treestruct.md} +0 -0
  423. /package/dist/{roles/mechanic/briefs/style.names.ubiqlang.md → domain.roles/mechanic/briefs/practices/lang.terms/rule.require.ubiqlang.md} +0 -0
  424. /package/dist/{roles/mechanic/briefs/patterns → domain.roles/mechanic/briefs/practices}/lang.tones/.readme.md +0 -0
  425. /package/dist/{roles/mechanic/briefs/style.words.lowercase.md → domain.roles/mechanic/briefs/practices/lang.tones/rule.prefer.lowercase.md} +0 -0
  426. /package/dist/{roles/mechanic/briefs/patterns/flow.debug.diagnostics/bad-practices/forbid.trust_vscode.md → domain.roles/mechanic/briefs/practices/work.flow/diagnose/rule.forbid.trust-vscode-diagnostics.md} +0 -0
  427. /package/dist/{roles/mechanic/briefs/patterns/flow.refact.questions/best-practice/require.testchange.review.md → domain.roles/mechanic/briefs/practices/work.flow/refactor/rule.require.review-test-changes.md} +0 -0
  428. /package/dist/{roles/mechanic/briefs/criteria.practices/prefer.jq.over_alt.[demo].md → domain.roles/mechanic/briefs/practices/work.flow/tools/rule.prefer.jq.[demo].md} +0 -0
  429. /package/dist/{roles/mechanic/briefs/criteria.practices/prefer.terraform.[criteria].md → domain.roles/mechanic/briefs/practices/work.flow/tools/rule.prefer.terraform.md.pt1.md} +0 -0
  430. /package/dist/{roles/mechanic/briefs/criteria.practices/prefer.terraform.[seed].md → domain.roles/mechanic/briefs/practices/work.flow/tools/rule.prefer.terraform.md.pt2.md} +0 -0
  431. /package/dist/{roles/mechanic/briefs/criteria.practices/require.knowledge.externalized.md → domain.roles/mechanic/briefs/practices/work.flow/tools/rule.require.externalized-knowledge.md} +0 -0
  432. /package/dist/{roles → domain.roles}/mechanic/getMechanicBrief.Options.codegen.d.ts +0 -0
  433. /package/dist/{roles → domain.roles}/mechanic/getMechanicBrief.Options.codegen.js +0 -0
  434. /package/dist/{roles → domain.roles}/mechanic/getMechanicBrief.d.ts +0 -0
  435. /package/dist/{roles → domain.roles}/mechanic/getMechanicBrief.js +0 -0
  436. /package/dist/{roles → domain.roles}/mechanic/getMechanicRole.d.ts +0 -0
  437. /package/dist/{roles/mechanic/skills → domain.roles/mechanic/inits}/claude.hooks/pretooluse.check-permissions.sh +0 -0
  438. /package/dist/{roles/mechanic/skills → domain.roles/mechanic/inits}/claude.hooks/pretooluse.forbid-stderr-redirect.sh +0 -0
  439. /package/dist/{roles/mechanic/skills → domain.roles/mechanic/inits}/claude.hooks/sessionstart.notify-permissions.sh +0 -0
  440. /package/dist/{roles/mechanic/skills → domain.roles/mechanic/inits}/init.claude.hooks.cleanup.sh +0 -0
  441. /package/dist/{roles/mechanic/skills → domain.roles/mechanic/inits}/init.claude.hooks.findsert.sh +0 -0
  442. /package/dist/{roles/mechanic/skills → domain.roles/mechanic/inits}/init.claude.hooks.sh +0 -0
  443. /package/dist/{roles/mechanic/skills → domain.roles/mechanic/inits}/init.claude.permissions.jsonc +0 -0
  444. /package/dist/{roles/mechanic/skills → domain.roles/mechanic/inits}/init.claude.permissions.sh +0 -0
  445. /package/dist/{roles/mechanic/skills → domain.roles/mechanic/inits}/init.claude.sh +0 -0
  446. /package/dist/{roles/mechanic/skills → domain.roles/mechanic/inits}/link.claude.transcripts.sh +0 -0
  447. /package/dist/{roles → domain.roles}/mechanic/skills/claude.tools/cpsafe.sh +0 -0
  448. /package/dist/{roles → domain.roles}/mechanic/skills/claude.tools/sedreplace.sh +0 -0
  449. /package/dist/{roles → domain.roles}/mechanic/skills/declapract.upgrade.sh +0 -0
@@ -1,85 +0,0 @@
1
- # 🧩 .brief: `<triage>`
2
-
3
- ## .what
4
-
5
- The `<triage>` operation involves **prioritizing, sorting, and categorizing** concepts, issues, or data points to address the most critical items first. It leverages criteria such as urgency, importance, and impact to allocate resources efficiently and tackle problems in a strategically sound order.
6
-
7
- ---
8
-
9
- ## 🎯 purpose
10
-
11
- - to allocate attention and resources effectively, particularly under constraints
12
- - to manage complex sets of tasks, concepts, or issues by determining priority
13
- - to achieve greater efficiency and impact in decision-making processes
14
-
15
- ---
16
-
17
- ## ⚙️ method
18
-
19
- 1. **gather elements**
20
- - compile the full scope of tasks, issues, or data points needing triage
21
- - ensure a comprehensive representation to inform prioritization
22
-
23
- 2. **establish criteria**
24
- - define criteria for urgency, importance, and potential impact
25
- - criteria should be clear, consistent, and aligned with strategic goals
26
-
27
- 3. **evaluate and prioritize**
28
- - assess each element against the criteria
29
- - rank based on priority, grouping into immediate, short-term, and long-term categories
30
-
31
- 4. **execute and monitor**
32
- - address elements according to their prioritization
33
- - continuously monitor for changes in context or priority requiring adjustment
34
-
35
- ---
36
-
37
- ## 🧠 cognitive basis
38
-
39
- Triage utilizes cognitive functions related to decision-making, prioritization, and problem-solving. It relies on both analytical assessments and judgment calls to manage complexity effectively and ensure the most crucial actions are taken first.
40
-
41
- ---
42
-
43
- ## 📐 when to use
44
-
45
- - during crises or time-sensitive situations where quick decision-making is essential
46
- - when managing extensive lists of tasks, responsibilities, or issues needing resolution
47
- - when aligning team focus and resources with high-impact objectives
48
-
49
- ---
50
-
51
- ## 🔁 dynamic behavior
52
-
53
- Triage is inherently dynamic, often involving frequent re-evaluation as context shifts or new information emerges. This flexibility ensures continued relevance and efficacy in response to changing priorities.
54
-
55
- ---
56
-
57
- ## ⚠️ caution: over-triage
58
-
59
- Avoid excessive triaging, which can lead to analysis paralysis or neglect of less critical but still important tasks. Ensure balance between granular prioritization and broad-sketch planning.
60
-
61
- ---
62
-
63
- ## 🧰 use it for:
64
-
65
- - emergency management and crisis response
66
- - project management and workflow optimization
67
- - strategic planning and resource allocation
68
-
69
- ---
70
-
71
- ## 📊 examples
72
-
73
- 1. **Emergency Room Triage**
74
- - Assessing incoming patients to prioritize those with life-threatening conditions over less urgent cases.
75
-
76
- 2. **Project Management**
77
- - Prioritizing project tasks based on deadlines, resource availability, and potential impact on project success.
78
-
79
- 3. **Strategic Planning**
80
- - Sorting organizational goals and initiatives to focus on those most likely to drive long-term success.
81
-
82
- 4. **Customer Support**
83
- - Filtering support tickets to address high-priority or escalated issues before general inquiries.
84
-
85
- ---
@@ -1,48 +0,0 @@
1
- # 🧩 .brief: `context-dependent grading in <triage>`
2
-
3
- ## .what
4
- `<triage>` involves prioritizing tasks or issues based on their urgency, importance, and impact. This process necessitates the use of different grading scales tailored to the specific context in which the triage is applied. Each context has distinct criteria for evaluation, resulting in unique sets of grades.
5
-
6
- ---
7
-
8
- ## 🎯 purpose
9
- - create a flexible grading system adaptable to varying contextual needs
10
- - ensure accurate prioritization by aligning grading criteria with specific context requirements
11
- - improve decision-making and resource allocation in diverse scenarios
12
-
13
- ---
14
-
15
- ## 📐 contexts and grading variations
16
-
17
- ### 1. **medical triage**
18
- - **criteria:** severity of condition, life-threatening potential, resource availability
19
- - **grades:** critical, urgent, stable, non-urgent
20
-
21
- ### 2. **project management**
22
- - **criteria:** deadline proximity, resource dependency, client priority
23
- - **grades:** high priority, medium priority, low priority, optional
24
-
25
- ### 3. **IT incident management**
26
- - **criteria:** service impact, number of users affected, workaround availability
27
- - **grades:** high impact, moderate impact, low impact, informational
28
-
29
- ---
30
-
31
- ## 📊 benefits of context-specific grading
32
- - enhances responsiveness by focusing on context-relevant factors
33
- - increases accuracy of prioritization due to alignment with specific needs
34
- - facilitates efficient resource allocation by understanding context-driven importance levels
35
-
36
- ---
37
-
38
- ## 🛠 usage
39
- - define clear criteria specific to each context for consistent grading
40
- - regularly review and adjust grading systems to reflect changing contextual demands
41
- - train stakeholders on context-specific grading criteria for seamless implementation
42
-
43
- ---
44
-
45
- ## 💡 notes
46
- - context-dependent grading should be updated as contexts evolve
47
- - integration of feedback from stakeholders is essential for refining grading accuracy
48
- - leverage analytical tools to periodically evaluate the effectiveness of grading systems
@@ -1,65 +0,0 @@
1
- # 🧩 .brief: `perspective; triage as question-based tactic`
2
-
3
- ## .what
4
-
5
- `triage` in thought processes is fundamentally a **question-based tactic**. This perspective suggests that triage is driven by **explicit or implicit questions** that determine the **dimensions** along which various elements or tasks are assessed and prioritized.
6
-
7
- ---
8
-
9
- ## 🎯 purpose
10
- - to **prioritize effectively** — identifying which elements need immediate attention and which can be postponed or discarded
11
- - to ensure that the **most critical issues** are addressed in a structured manner
12
- - to provide a clear framework for **decision-making** in complex or time-pressured situations
13
-
14
- ---
15
-
16
- ## 🌀 triage dynamics
17
-
18
- ### 1. question-driven assessment
19
- - **defining criteria**: Each triage process is guided by specific questions that focus on what matters most.
20
- - e.g., "Which tasks have the highest impact?" or "What must be solved immediately?"
21
-
22
- ### 2. dimension selection
23
- - **criteria alignment**: Questions help in selecting the dimensions of assessment, such as urgency, importance, or risk.
24
-
25
- ---
26
-
27
- ## 🔍 triage examples
28
-
29
- ### medical triage
30
- - **main question**: "Which patient needs care first?"
31
- - **assessment dimensions**:
32
- - severity of condition
33
- - survival probability
34
- - resource availability
35
-
36
- ### project prioritization
37
- - **main question**: "Which project aligns best with our strategic goals?"
38
- - **assessment dimensions**:
39
- - potential ROI
40
- - strategic alignment
41
- - resource requirements
42
-
43
- ### information overload management
44
- - **main question**: "Which information is most crucial to process immediately?"
45
- - **assessment dimensions**:
46
- - relevance to current objectives
47
- - urgency of response required
48
- - impact on future decisions
49
-
50
- ---
51
-
52
- ## 🌿 implications for practice
53
-
54
- - adopting a question-based triage framework can make prioritization more transparent and justifiable.
55
- - defining clear, shared questions ensures all involved parties understand **why decisions are made**, improving collaboration and buy-in.
56
-
57
- ---
58
-
59
- ## 💭 reflections
60
-
61
- Consider whether:
62
- - the questions used in your triage process effectively cover all necessary dimensions.
63
- - your team could benefit from revisiting and refining these questions to better align with current goals.
64
-
65
- > By treating triage as a question-based tactic, we can enhance focus, efficiency, and clarity in decision-making.
@@ -1,14 +0,0 @@
1
- prefer more chill, nature based emojis
2
-
3
- for example
4
-
5
- # src/skills/diagnose/queryApis/detectLambdaCrontasks.sh
6
- 🌊 Wave for the main detection flow
7
- 🌱 Seedling for Step 1 (starting/growing the list)
8
- 🌿 Herb for successful enumeration
9
- 🍂 Fallen leaf for when nothing is found
10
- 🌾 Sheaf of rice for Step 2 (harvesting/checking data)
11
- 🌸 Cherry blossom for Step 3 (results blooming)
12
- 🌙 Crescent moon for no cron tasks found (peaceful/quiet)
13
- 🌻 Sunflower for the summary (bright conclusion)
14
-
@@ -1,5 +0,0 @@
1
- .ocd = obsessed with structure, precision, and clarity.
2
- - strives for maximum signal and minimal noise.
3
- - compulsively organizes, deduplicates, and compresses information.
4
- - intolerant of vagueness, drift, or redundant phrasing.
5
- - ensures consistent grammar, formatting, and taxonomy.
@@ -1,93 +0,0 @@
1
- # 🧩 .brief: `llm inference = matmuls + vecmuls + elemuls`
2
-
3
- ## .what
4
- llm inference is the process by which a trained language model transforms input tokens into output predictions. the computation can be reduced to three categories:
5
-
6
- - **matmuls** → large matrix multiplications (heavy, parameter-rich ops)
7
- - **vecmuls** → vector-scale multiplications/additions (normalization scale/shift, bias)
8
- - **elemuls** → elementwise nonlinear operations (activations, softmax, residuals)
9
-
10
- together, these form the skeleton of inference: heavy matmuls provide learned transformations, while vecmuls and elemuls act as the glue that gives nonlinearity and stability.
11
-
12
- ---
13
-
14
- ## 🎯 purpose
15
- - apply billions of learned parameters (matmuls) to transform token inputs
16
- - refine representations through normalization (vecmuls) and nonlinear activations (elemuls)
17
- - output logits over vocabulary for next-token prediction
18
-
19
- ---
20
-
21
- ## ⚙️ method
22
-
23
- ### 🔑 what’s happening inside llm inference
24
-
25
- 1. **token embedding**
26
- - input tokens → dense vectors via embedding matrix (**matmul**).
27
-
28
- 2. **transformer layers**
29
- - **linear projections:** weight matrices × input (**matmuls**).
30
- - **attention mechanism:** query × key → attention weights (**matmul**), then weights × value (**matmul**).
31
- - **feed-forward networks:** matmuls with intermediate activation (**elemuls**).
32
-
33
- 3. **non-linearities & normalization**
34
- - **activations:** per-element functions (relu, gelu, etc.) = **elemuls**.
35
- - **normalization:** mean/variance across vector + learned scale/shift = **vecmuls + elemuls**.
36
-
37
- 4. **output layer**
38
- - final hidden state × vocab matrix → logits (**matmul**).
39
-
40
- ---
41
-
42
- ## 🧮 operation classes
43
- - **matmuls:** embeddings, projections, attention (qkᵀ, softmax·v), feed-forward, output head.
44
- - **vecmuls:** layernorm scale/shift, bias addition.
45
- - **elemuls:** relu/gelu activations, softmax exponentials/divides, residual adds.
46
-
47
- ---
48
-
49
- ## 📊 insight
50
- - **yes:** matmuls dominate compute and parameter count.
51
- - **no:** inference is not *only* matmuls — vecmuls and elemuls are critical for expressivity and stability.
52
- - **so:** inference = “giant chains of matmuls, with vecmuls and elemuls woven in.”
53
-
54
- ---
55
-
56
- ## 💻 toy pseudocode skeleton
57
-
58
- \`\`\`python
59
- def llm_inference(tokens, weights):
60
- # 1. embedding lookup (matmul)
61
- x = embed(tokens, weights["embedding"]) # matmul
62
-
63
- for layer in weights["layers"]:
64
- # 2. linear projections (matmuls)
65
- q = matmul(x, layer["Wq"])
66
- k = matmul(x, layer["Wk"])
67
- v = matmul(x, layer["Wv"])
68
-
69
- # 3. attention (matmuls + elemuls)
70
- attn_scores = matmul(q, k.T) / sqrt(d) # matmul
71
- attn_weights = softmax(attn_scores) # elemul
72
- attn_output = matmul(attn_weights, v) # matmul
73
-
74
- # 4. residual connection (elemul)
75
- x = x + attn_output # elemul
76
-
77
- # 5. normalization (vecmul + elemul)
78
- x = layernorm(x, layer["gamma"], layer["beta"]) # vecmul + elemul
79
-
80
- # 6. feed-forward network
81
- h = matmul(x, layer["W1"]) # matmul
82
- h = gelu(h) # elemul
83
- h = matmul(h, layer["W2"]) # matmul
84
- x = x + h # elemul
85
-
86
- # 7. output projection (matmul)
87
- logits = matmul(x, weights["output"]) # matmul
88
- return logits
89
- \`\`\`
90
-
91
- ---
92
-
93
- in short: **llm inference = matmuls (heavy lifting) + vecmuls (scaling/shift) + elemuls (nonlinear glue).**
@@ -1,62 +0,0 @@
1
- # 🧩 .brief: `the transformer architecture — birth of llms`
2
-
3
- ## .what
4
- the **transformer** is the fundamental architecture that enabled large language models (llms). introduced in 2017 by vaswani et al. in *“attention is all you need”*, it replaced recurrence with **self-attention**, making it possible to train massive models on vast text corpora with efficient parallelization.
5
-
6
- ---
7
-
8
- ## 🎯 purpose
9
- - overcome the sequential bottlenecks of rnn/lstm models
10
- - capture long-range dependencies across entire sequences
11
- - enable scalable, parallel training on gpus/tpus
12
- - provide a flexible backbone that can grow with data and compute
13
-
14
- ---
15
-
16
- ## ⚙️ method
17
-
18
- ### 1. **token embedding**
19
- - words/subwords mapped into dense vectors (matmuls).
20
-
21
- ### 2. **positional encoding**
22
- - inject sequence order into embeddings, since attention is order-agnostic.
23
-
24
- ### 3. **multi-head self-attention**
25
- - queries, keys, and values projected via matmuls.
26
- - attention scores = q·kᵀ → softmax → weighted sum with v.
27
- - multiple heads let the model learn diverse relational patterns.
28
-
29
- ### 4. **feed-forward networks**
30
- - per-token mlps applied after attention.
31
- - matmuls + nonlinear activations (elemuls).
32
-
33
- ### 5. **residual connections + normalization**
34
- - stabilize training, preserve gradients, and allow deep stacking.
35
-
36
- ---
37
-
38
- ## 🔑 why transformers were a leap
39
-
40
- - **parallelism:** attention lets all tokens be processed simultaneously.
41
- - **long-range context:** any token can directly attend to any other.
42
- - **scalability:** depth, width, and data scale smoothly (scaling laws).
43
- - **expressivity:** multi-head attention captures complex dependencies.
44
-
45
- ---
46
-
47
- ## 🌍 llm lineage
48
-
49
- - **2017 — transformer** (*attention is all you need*)
50
- - **2018 — bert, gpt-1** (first pretrained transformer language models)
51
- - **2019 — gpt-2** (scaling shows surprising emergent abilities)
52
- - **2020 — gpt-3** (175b parameters; llms become viable)
53
- - **2022+ — instruction-tuned & rlhf models** (chatgpt, claude, etc.)
54
-
55
- ---
56
-
57
- ## 📊 insight
58
- - the transformer is the **architectural skeleton** of llms.
59
- - llms are “just” massive stacks of transformers trained on enormous corpora.
60
- - rlhf, fine-tuning, and alignment methods refine the outputs — but the core engine is still the **transformer self-attention block**.
61
-
62
- in short: **transformers are the soil from which llms grew.**
@@ -1,93 +0,0 @@
1
- # 🧩 .brief.article: `self-attention`
2
-
3
- ## 🔑 what is self-attention
4
-
5
- self-attention is a mechanism that lets every token in a sequence **dynamically weigh its relationship to every other token** when computing its next representation.
6
-
7
- each token generates three vectors:
8
- - **query (q)** — what this token is “looking for”
9
- - **key (k)** — what this token “offers”
10
- - **value (v)** — the actual information carried
11
-
12
- the similarity of query vs key determines how much attention a token pays to another token’s value.
13
-
14
- mathematically:
15
-
16
- \[
17
- \text{Attention}(Q,K,V) = \text{softmax}\!\left(\frac{QK^\top}{\sqrt{d_k}}\right) V
18
- \]
19
-
20
- - **qkᵀ** → pairwise similarity scores (**matmul**)
21
- - **softmax** → normalize into attention weights
22
- - **weights × v** → weighted sum of values = new representation
23
-
24
- ---
25
-
26
- ## 🎯 purpose
27
- - let tokens reference and integrate information from anywhere in the sequence
28
- - capture long-range dependencies in a single operation
29
- - enable efficient, parallel computation across tokens
30
- - provide multiple relational views through multi-head attention
31
-
32
- ---
33
-
34
- ## ⚙️ method
35
-
36
- 1. compute q, k, v for each token via linear projections (**matmuls**)
37
- 2. calculate similarity scores q·kᵀ (**matmul**)
38
- 3. normalize scores with softmax (**elemuls**)
39
- 4. use normalized weights to combine values (**matmul**)
40
- 5. update each token representation with the weighted sum
41
-
42
- ---
43
-
44
- ## 🔑 benefits
45
-
46
- 1. **parallelism** — all q, k, v computed at once; no recurrence.
47
- 2. **long-range context** — any token can directly attend to any other.
48
- 3. **scalability** — uniform, repeatable structure scales with data/compute.
49
- 4. **expressivity** — multi-head attention lets the model learn diverse relational patterns.
50
-
51
- ---
52
-
53
- ## 🧩 intuition example
54
-
55
- sentence:
56
- > “the cat sat on the mat because it was tired.”
57
-
58
- let’s track the token **“it”** and show how its q, k, v vectors interact with **“the cat.”**
59
- for illustration, assume a toy **5-dimensional hidden space**.
60
-
61
- ### token: **“it”**
62
- - query (**q_it**) = `[0.9, 0.1, 0.0, 0.2, 0.3]`
63
- - “looking for an antecedent noun with certain features”
64
- - key (**k_it**) = `[0.1, 0.3, 0.2, 0.0, 0.4]`
65
- - “offers” self as a pronoun needing resolution
66
- - value (**v_it**) = `[0.2, 0.5, 0.1, 0.0, 0.7]`
67
- - the information carried by “it” itself
68
-
69
- ### token: **“cat”**
70
- - query (**q_cat**) = `[0.2, 0.4, 0.1, 0.3, 0.0]`
71
- - key (**k_cat**) = `[0.8, 0.2, 0.0, 0.1, 0.3]`
72
- - describes the features of “cat” as a noun subject
73
- - value (**v_cat**) = `[0.7, 0.6, 0.2, 0.4, 0.1]`
74
- - semantic content of “cat”
75
-
76
- ### computing attention
77
- 1. similarity score = q_it · k_cat =
78
- `0.9*0.8 + 0.1*0.2 + 0.0*0.0 + 0.2*0.1 + 0.3*0.3 = 0.72 + 0.02 + 0 + 0.02 + 0.09 = 0.85`
79
- 2. suppose normalized (softmax) weight for “cat” = **0.70**, for others tokens total 0.30.
80
- 3. “it”’s updated representation =
81
- `0.70 * v_cat + 0.30 * (weighted sum of other tokens’ values)`
82
-
83
- so “it”’s final vector is now strongly composed of “cat”’s value vector, making the model understand that **“it” refers to “the cat.”**
84
-
85
- ---
86
-
87
- ## 📊 insight
88
- - **queries = what a token seeks**
89
- - **keys = what a token provides**
90
- - **values = the information contributed**
91
- - weighted connections between them create **context-aware representations**.
92
-
93
- self-attention is how llms directly model relationships across a sequence — allowing “it” to learn its referent is “the cat.”
@@ -1,80 +0,0 @@
1
- # 🧩 .brief.demo: `multi-head self-attention on ambiguous words (value vectors evolve)`
2
-
3
- ## .what
4
- this demo shows how two identical tokens — **“bank”** — begin with the same embedding but evolve into **different value vectors** after attention layers, depending on context. multi-head attention disambiguates their meaning dynamically.
5
-
6
- ---
7
-
8
- ## 🎯 purpose
9
- - demonstrate that identical word embeddings diverge into context-specific meanings
10
- - show how q, k, v vectors are derived from hidden states
11
- - illustrate how attention causes “bank” (financial vs river) to separate
12
-
13
- ---
14
-
15
- ## ⚙️ demo setup
16
-
17
- sentence:
18
- > “the **bank** raised interest rates, and she sat by the **bank** of the river.”
19
-
20
- toy hidden size = **4**, with **2 heads.**
21
-
22
- ---
23
-
24
- ### 🔹 step 1 — input embedding (same for both “bank”)
25
-
26
- both tokens start with the **same embedding lookup** from the word embedding matrix:
27
-
28
- - embedding(**bank**) = `[0.5, 0.7, 0.2, 0.1]`
29
-
30
- this is identical for both occurrences, because embeddings are tied to vocabulary entries, not context.
31
-
32
- ---
33
-
34
- ### 🔹 step 2 — hidden states diverge
35
-
36
- after one transformer block, the hidden state of each “bank” diverges due to attending to different neighbors:
37
-
38
- - hidden(**bank_financial**) = `[0.8, 0.2, 0.6, 0.1]`
39
- - hidden(**bank_river**) = `[0.1, 0.9, 0.2, 0.7]`
40
-
41
- ---
42
-
43
- ### 🔹 step 3 — compute q, k, v from hidden states
44
-
45
- each hidden state is projected by learned matrices \( W_q, W_k, W_v \).
46
-
47
- for simplicity, show only **value (v)** vectors here:
48
-
49
- - v(**bank_financial**) = `[0.6, 0.5, 0.7, 0.2]`
50
- - v(**bank_river**) = `[0.2, 0.8, 0.3, 0.6]`
51
-
52
- note: originally both banks had the **same v** if taken right after embedding, but after context mixing, they diverge.
53
-
54
- ---
55
-
56
- ### 🔹 step 4 — multi-head specialization
57
-
58
- - **head 1 (financial context):**
59
- “bank” attends to “interest rates” → reinforces v(**bank_financial**).
60
-
61
- - **head 2 (geographic context):**
62
- “bank” attends to “river” → reinforces v(**bank_river**).
63
-
64
- ---
65
-
66
- ## 🧩 combined effect
67
-
68
- - initially, both “bank” tokens share the same vector (embedding).
69
- - after attention, their hidden states — and thus their q/k/v vectors — diverge.
70
- - multi-head attention ensures each occurrence is contextualized differently.
71
-
72
- ---
73
-
74
- ## 📊 insight
75
- - **embeddings** are static (same for same word).
76
- - **hidden states** are dynamic (different for each occurrence).
77
- - **q, k, v** are projections of hidden states, so they also differ per occurrence.
78
- - result: llms resolve word sense disambiguation in context by letting identical tokens evolve into different representations.
79
-
80
- in short: **same word, same start — different meaning, different vectors.**
@@ -1,67 +0,0 @@
1
- # 🧩 .brief.demo: `multi-head self-attention`
2
-
3
- ## .what
4
- this demo illustrates how **multi-head self-attention** allows a transformer to capture **different types of relationships simultaneously** by projecting the same tokens into multiple attention “heads.” each head learns its own query/key/value space, enabling diverse relational patterns (e.g., pronoun resolution, verb agreement, or topic continuity).
5
-
6
- ---
7
-
8
- ## 🎯 purpose
9
- - show how multiple attention heads operate in parallel
10
- - demonstrate how heads specialize in different linguistic/semantic functions
11
- - highlight how combining heads yields richer token representations
12
-
13
- ---
14
-
15
- ## ⚙️ demo setup
16
-
17
- sentence:
18
- > “the cat sat on the mat because it was tired.”
19
-
20
- toy hidden size = **6**, with **2 heads**, each head having its own projection of q, k, v.
21
-
22
- ---
23
-
24
- ### 🔹 head 1 — pronoun resolution (antecedent tracking)
25
-
26
- focus: linking **“it”** → **“the cat.”**
27
-
28
- - **q_it (head 1):** `[0.9, 0.1, 0.0]`
29
- - **k_cat (head 1):** `[0.8, 0.2, 0.1]`
30
- - **dot product:** `0.9*0.8 + 0.1*0.2 + 0.0*0.1 = 0.74`
31
- - **attention weight:** 0.74 → dominates over other tokens
32
- - **result:** “it” attends strongly to “cat,” resolving the pronoun.
33
-
34
- ---
35
-
36
- ### 🔹 head 2 — verb agreement (syntactic continuity)
37
-
38
- focus: linking **subject** (“the cat”) → **verb** (“sat”).
39
-
40
- - **q_cat (head 2):** `[0.2, 0.7, 0.3]`
41
- - **k_sat (head 2):** `[0.1, 0.9, 0.2]`
42
- - **dot product:** `0.2*0.1 + 0.7*0.9 + 0.3*0.2 = 0.02 + 0.63 + 0.06 = 0.71`
43
- - **attention weight:** strong match
44
- - **result:** “cat” attends to “sat,” enforcing subject-verb connection.
45
-
46
- ---
47
-
48
- ## 🧩 combined effect
49
-
50
- after attention, outputs from all heads are concatenated and linearly transformed:
51
-
52
- \[
53
- \text{MultiHead}(Q,K,V) = \text{Concat}(\text{head}_1, \text{head}_2, \dots) W^O
54
- \]
55
-
56
- - **head 1 output:** captures **semantic resolution** (it ↔ cat).
57
- - **head 2 output:** captures **syntactic relation** (cat ↔ sat).
58
- - combined, the model encodes **both** types of context simultaneously.
59
-
60
- ---
61
-
62
- ## 📊 insight
63
- - each head = a separate lens on token relationships.
64
- - heads specialize (some semantic, some syntactic, some positional).
65
- - combining them creates **richer, multifaceted token embeddings.**
66
-
67
- in short: **multi-head attention = parallel perspectives on the same sequence.**
@@ -1,48 +0,0 @@
1
- # 🧩 .brief: `llm replication of input structures`
2
-
3
- ## 🔑 what it implies
4
-
5
- llms are trained to predict the **next token** given a sequence, so they are highly sensitive to **patterns in the immediate input context**. when a prompt contains an example with a certain structure (formatting, headings, bullet styles, code blocks), the model learns that continuing with the same structure minimizes prediction error.
6
-
7
- this replication is not true “understanding” of the structure — it is a probabilistic continuation shaped by training data, where mimicking provided forms was often the correct next step.
8
-
9
- ---
10
-
11
- ## 🎯 implications for behavior
12
-
13
- - **structural mimicry**
14
- - the model mirrors bullet lists, markdown, code syntax, or prose style seen in the input.
15
- - **consistency bias**
16
- - once a format is established in the prompt, deviating feels “unlikely” under the learned distribution.
17
- - **few-shot learning**
18
- - demonstration examples act as templates; the model generalizes content into the same frame.
19
- - **alignment with expectation**
20
- - replication maximizes coherence with the input and aligns with user intent implicitly signaled by structure.
21
-
22
- ---
23
-
24
- ## 🧩 example
25
-
26
- > input:
27
- >
28
- > “list three animals in this format:
29
- > - mammal:
30
- > - bird:
31
- > - reptile:”
32
-
33
- > output:
34
- > - mammal: dog
35
- > - bird: eagle
36
- > - reptile: lizard
37
-
38
- the model doesn’t reason about taxonomy per se — it reproduces the structure because that’s the **most probable continuation**.
39
-
40
- ---
41
-
42
- ## 📊 insight
43
-
44
- - llms replicate structures because **continuation is their core mechanic**.
45
- - training on diverse, structured text (tables, lists, markdown, code) reinforced the habit of format preservation.
46
- - this property is what enables **few-shot prompting** and makes llms easy to steer by example.
47
-
48
- in short: **llms copy input structures because structure itself is a strong predictive signal for next-token generation.**