rhachet-roles-ehmpathy 1.13.0 → 1.13.2

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 (547) hide show
  1. package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus.d.ts +2 -2
  2. package/dist/contract/sdk/index.d.ts +1 -1
  3. package/dist/contract/sdk/index.js +3 -3
  4. package/dist/contract/sdk/index.js.map +1 -1
  5. package/dist/data/sdk/sdkOpenAi.d.ts +2 -2
  6. package/dist/domain/constants.d.ts +3 -0
  7. package/dist/domain/constants.js +5 -0
  8. package/dist/domain/constants.js.map +1 -0
  9. package/dist/logic/artifact/genLoopFeedback.d.ts +3 -3
  10. package/dist/logic/artifact/genStepArtDel.d.ts +4 -4
  11. package/dist/logic/artifact/genStepArtDel.js.map +1 -1
  12. package/dist/logic/artifact/genStepArtSet.d.ts +4 -4
  13. package/dist/logic/artifact/genStepArtSet.js.map +1 -1
  14. package/dist/logic/artifact/genStepGrabCallerFeedbackToArtifact.d.ts +4 -4
  15. package/dist/logic/artifact/genStepResetFeedback.d.ts +4 -4
  16. package/dist/logic/artifact/genStepResetFeedback.js.map +1 -1
  17. package/dist/logic/artifact/genStepSwapArtifact.d.ts +3 -3
  18. package/dist/logic/artifact/setSkillOutputSrc.d.ts +1 -1
  19. package/dist/logic/context/genStitchStreamToDisk.d.ts +1 -1
  20. package/dist/logic/context/genStitchStreamToDisk.js +1 -0
  21. package/dist/logic/context/genStitchStreamToDisk.js.map +1 -1
  22. package/dist/logic/hooks/execTranslateDocOutputPath.d.ts +2 -2
  23. package/dist/logic/hooks/getInvokeHooks.d.ts +1 -1
  24. package/dist/logic/roles/architect/getArchitectRole.d.ts +1 -1
  25. package/dist/logic/roles/architect/getArchitectRole.js.map +1 -1
  26. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.d.ts +6 -6
  27. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.js.map +1 -1
  28. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.skill.d.ts +1 -1
  29. package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.d.ts +6 -6
  30. package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.skill.d.ts +1 -1
  31. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.d.ts +6 -6
  32. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.js.map +1 -1
  33. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.skill.d.ts +1 -1
  34. package/dist/logic/roles/bhrain/getBhrainBrief.Options.codegen.d.ts +1 -1
  35. package/dist/logic/roles/bhrain/getBhrainBrief.d.ts +3 -3
  36. package/dist/logic/roles/bhrain/getBhrainBrief.js.map +1 -1
  37. package/dist/logic/roles/bhrain/getBhrainRole.d.ts +1 -1
  38. package/dist/logic/roles/bhrain/getBhrainRole.js.map +1 -1
  39. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.d.ts +6 -6
  40. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.js.map +1 -1
  41. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.skill.d.ts +1 -1
  42. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.d.ts +6 -6
  43. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.js.map +1 -1
  44. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.skill.d.ts +1 -1
  45. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.d.ts +6 -6
  46. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.js.map +1 -1
  47. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.skill.d.ts +1 -1
  48. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.skill.js.map +1 -1
  49. package/dist/logic/roles/bhrain/khue.triage/stepTriage.d.ts +6 -6
  50. package/dist/logic/roles/bhrain/khue.triage/stepTriage.js.map +1 -1
  51. package/dist/logic/roles/bhrain/khue.triage/stepTriage.skill.d.ts +1 -1
  52. package/dist/logic/roles/designer/getDesignerBrief.Options.codegen.d.ts +1 -1
  53. package/dist/logic/roles/designer/getDesignerBrief.d.ts +3 -3
  54. package/dist/logic/roles/designer/getDesignerBrief.js.map +1 -1
  55. package/dist/logic/roles/designer/outlineDistilisys/loopOutlineDistilisys.d.ts +4 -4
  56. package/dist/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.d.ts +4 -4
  57. package/dist/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.js.map +1 -1
  58. package/dist/logic/roles/designer/outlineRoadmap/loopOutlineRoadmap.d.ts +4 -4
  59. package/dist/logic/roles/designer/outlineRoadmap/stepOutlineRoadmap.d.ts +4 -4
  60. package/dist/logic/roles/designer/outlineRoadmap/stepOutlineRoadmap.js.map +1 -1
  61. package/dist/logic/roles/ecologist/getEcologistBrief.Options.codegen.d.ts +1 -1
  62. package/dist/logic/roles/ecologist/getEcologistBrief.d.ts +3 -3
  63. package/dist/logic/roles/ecologist/getEcologistBrief.js.map +1 -1
  64. package/dist/logic/roles/ecologist/getEcologistRole.d.ts +1 -1
  65. package/dist/logic/roles/ecologist/getEcologistRole.js.map +1 -1
  66. package/dist/logic/roles/mechanic/codediff/getRefOrgPatterns.d.ts +2 -2
  67. package/dist/logic/roles/mechanic/codediff/routeArtistCodeDiff.d.ts +4 -4
  68. package/dist/logic/roles/mechanic/codediff/routeArtistCodeDiff.js.map +1 -1
  69. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReview.d.ts +4 -4
  70. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewArchitecture.d.ts +4 -4
  71. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewArchitecture.js.map +1 -1
  72. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewBehavior.d.ts +4 -4
  73. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewBehavior.js.map +1 -1
  74. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewCodestyle.d.ts +4 -4
  75. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewCodestyle.js.map +1 -1
  76. package/dist/logic/roles/mechanic/codediff/routeJudgeReleasable.d.ts +4 -4
  77. package/dist/logic/roles/mechanic/codediff/routeJudgeReleasable.js.map +1 -1
  78. package/dist/logic/roles/mechanic/codediff/routeMechanicCodeIterate.d.ts +4 -4
  79. package/dist/logic/roles/mechanic/codediff/routeMechanicCodePropose.d.ts +5 -5
  80. package/dist/logic/roles/mechanic/getMechanicBrief.Options.codegen.d.ts +1 -1
  81. package/dist/logic/roles/mechanic/getMechanicBrief.d.ts +3 -3
  82. package/dist/logic/roles/mechanic/getMechanicBrief.js.map +1 -1
  83. package/dist/logic/roles/mechanic/getMechanicRole.d.ts +1 -1
  84. package/dist/logic/roles/mechanic/getMechanicRole.js.map +1 -1
  85. package/dist/logic/roles/mechanic/skills/getSkillCodePropose.d.ts +3 -2
  86. package/dist/logic/roles/mechanic/skills/getSkillCodePropose.js.map +1 -1
  87. package/dist/logic/roles/mechanic/study/routeStudyAsk.d.ts +4 -4
  88. package/dist/logic/roles/mechanic/study/routeStudyAsk.js.map +1 -1
  89. package/dist/logic/roles/mechanic/write/loopWrite.d.ts +1 -1
  90. package/dist/logic/roles/mechanic/write/loopWrite.skill.d.ts +1 -1
  91. package/dist/logic/roles/mechanic/write/loopWrite.skill.js.map +1 -1
  92. package/dist/logic/roles/mechanic/write/stepWrite.d.ts +4 -4
  93. package/dist/logic/roles/mechanic/write/stepWrite.js.map +1 -1
  94. package/dist/logic/roles/terminal.commander/command.exec/stepExecCommand.d.ts +4 -4
  95. package/dist/logic/roles/terminal.commander/command.exec/stepExecCommand.js.map +1 -1
  96. package/dist/logic/roles/terminal.commander/command.exec/stepExecCommand.skill.d.ts +1 -1
  97. package/dist/logic/roles/terminal.commander/command.plan/stepPlanCommand.d.ts +6 -6
  98. package/dist/logic/roles/terminal.commander/command.plan/stepPlanCommand.skill.d.ts +1 -1
  99. package/dist/logic/roles/terminal.commander/getCommanderRole.d.ts +1 -1
  100. package/dist/logic/roles/terminal.commander/getCommanderRole.js.map +1 -1
  101. package/license.md +21 -0
  102. package/package.json +38 -38
  103. package/dist/contract/cases/mechanicGoalStubout.integration.test.d.ts +0 -0
  104. package/dist/contract/cases/mechanicGoalStubout.integration.test.js +0 -2
  105. package/dist/contract/cases/mechanicGoalStubout.integration.test.js.map +0 -1
  106. package/dist/contract/cases/mechanicStubFillout.integration.test.d.ts +0 -0
  107. package/dist/contract/cases/mechanicStubFillout.integration.test.js +0 -2
  108. package/dist/contract/cases/mechanicStubFillout.integration.test.js.map +0 -1
  109. package/dist/logic/artifact/genStepArtSet.integration.test.d.ts +0 -1
  110. package/dist/logic/artifact/genStepArtSet.integration.test.js +0 -142
  111. package/dist/logic/artifact/genStepArtSet.integration.test.js.map +0 -1
  112. package/dist/logic/artifact/genStepGrabCallerFeedbackToArtifact.integration.test.d.ts +0 -1
  113. package/dist/logic/artifact/genStepGrabCallerFeedbackToArtifact.integration.test.js +0 -97
  114. package/dist/logic/artifact/genStepGrabCallerFeedbackToArtifact.integration.test.js.map +0 -1
  115. package/dist/logic/artifact/genStepSwapArtifact.test.d.ts +0 -1
  116. package/dist/logic/artifact/genStepSwapArtifact.test.js +0 -131
  117. package/dist/logic/artifact/genStepSwapArtifact.test.js.map +0 -1
  118. package/dist/logic/hooks/decodeDocOutputPath.test.d.ts +0 -1
  119. package/dist/logic/hooks/decodeDocOutputPath.test.js +0 -146
  120. package/dist/logic/hooks/decodeDocOutputPath.test.js.map +0 -1
  121. package/dist/logic/hooks/execTranslateDocOutputPath.test.d.ts +0 -1
  122. package/dist/logic/hooks/execTranslateDocOutputPath.test.js +0 -528
  123. package/dist/logic/hooks/execTranslateDocOutputPath.test.js.map +0 -1
  124. package/dist/logic/hooks/relateDocOutputPath.test.d.ts +0 -1
  125. package/dist/logic/hooks/relateDocOutputPath.test.js +0 -111
  126. package/dist/logic/hooks/relateDocOutputPath.test.js.map +0 -1
  127. package/dist/logic/roles/architect/.briefs/criteria.given_when_then.[seed].v3.md +0 -87
  128. package/dist/logic/roles/architect/.briefs/practices/prefer.env_access.prep_over_dev.md +0 -12
  129. package/dist/logic/roles/architect/.briefs/ubiqlang.ambiguous-from-overload.md +0 -1
  130. package/dist/logic/roles/bhrain/.briefs/cognition/cog000.overview.and.premise.md +0 -115
  131. package/dist/logic/roles/bhrain/.briefs/cognition/cog021.coordinates.spherical.md +0 -69
  132. package/dist/logic/roles/bhrain/.briefs/cognition/cog021.metaphor.cauliflorous.md +0 -44
  133. package/dist/logic/roles/bhrain/.briefs/cognition/cog021.metaphor.galactic_spacetravel.[article].md +0 -42
  134. package/dist/logic/roles/bhrain/.briefs/cognition/cog021.metaphor.galactic_spacetravel.[lesson].md +0 -60
  135. package/dist/logic/roles/bhrain/.briefs/cognition/cog021.structs.catalog.md +0 -51
  136. package/dist/logic/roles/bhrain/.briefs/cognition/cog021.structs.treestruct.md +0 -85
  137. package/dist/logic/roles/bhrain/.briefs/cognition/cog021.structs.vector.md +0 -112
  138. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.definition.md +0 -115
  139. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct._.md +0 -112
  140. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.coords.1.spherical.md +0 -80
  141. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.coords.2.abstractive.md +0 -59
  142. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.coords.3.descriptive.md +0 -64
  143. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.persp.1.perspectives.md +0 -88
  144. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.persp.2.universal.md +0 -82
  145. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.persp.3.relative.md +0 -106
  146. package/dist/logic/roles/bhrain/.briefs/cognition/cog101.concept.treestruct.persp.4.fractal.md +0 -83
  147. package/dist/logic/roles/bhrain/.briefs/cognition/cog151.concept.treestruct.gravity.md +0 -89
  148. package/dist/logic/roles/bhrain/.briefs/cognition/cog201.cortal.focus.p1.definition.md +0 -231
  149. package/dist/logic/roles/bhrain/.briefs/cognition/cog201.cortal.focus.p1.examples.cont.md +0 -82
  150. package/dist/logic/roles/bhrain/.briefs/cognition/cog201.cortal.focus.p2.acuity.md +0 -134
  151. package/dist/logic/roles/bhrain/.briefs/cognition/cog201.cortal.focus.p2.breadth.md +0 -151
  152. package/dist/logic/roles/bhrain/.briefs/cognition/cog201.cortal.focus.p2.depth.md +0 -147
  153. package/dist/logic/roles/bhrain/.briefs/cognition/cog251.cortal.focus.p3.fabric.md +0 -96
  154. package/dist/logic/roles/bhrain/.briefs/cognition/cog251.cortal.focus.p3.mode.md +0 -68
  155. package/dist/logic/roles/bhrain/.briefs/cognition/cog251.cortal.focus.p3.rythm.md +0 -56
  156. package/dist/logic/roles/bhrain/.briefs/cognition/cog251.cortal.focus.p3.usecases.md +0 -76
  157. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.1.motion.primitives._.md +0 -155
  158. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.1.motion.primitives.acuity.md +0 -94
  159. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.1.motion.primitives.breadth.md +0 -114
  160. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.1.motion.primitives.breadth.vary.md +0 -105
  161. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.1.motion.primitives.depth.md +0 -132
  162. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.2.motion.composites._.md +0 -106
  163. package/dist/logic/roles/bhrain/.briefs/cognition/cog301.traversal.2.motion.composites.grammar.md +0 -105
  164. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.._.md +0 -209
  165. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.1.persp.as.berries.md +0 -168
  166. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.1.persp.as.vectors.md +0 -74
  167. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.1.persp.has.precision.tunable.md +0 -80
  168. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.1.primitives.rough._.md +0 -99
  169. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.1.primitives.rough.interrogative.md +0 -108
  170. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.1.primitives.rough.why.[article].md +0 -55
  171. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.2.composite.smooth._.md +0 -83
  172. package/dist/logic/roles/bhrain/.briefs/cognition/cog401.questions.2.2.composite.smooth.examples.md +0 -101
  173. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.1.primitives._.md +0 -134
  174. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.1.primitives.recall.md +0 -149
  175. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.1.primitives.steer.md +0 -146
  176. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.1.primitives.think.md +0 -141
  177. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.2.composites.zoom.md +0 -127
  178. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.3.catalogs.md +0 -107
  179. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang.3.grammar.md +0 -124
  180. package/dist/logic/roles/bhrain/.briefs/cognition/cog501.cortal.assemblylang_.md +0 -0
  181. package/dist/logic/roles/bhrain/.briefs/cognition/inflight/concept.vs.idea.md +0 -70
  182. package/dist/logic/roles/bhrain/.briefs/cognition/inflight/core.concept.adjectives.md +0 -8
  183. package/dist/logic/roles/bhrain/.briefs/distilisys.grammar.compressed.md +0 -19
  184. package/dist/logic/roles/bhrain/.briefs/grammar/gerunds.1.why.common.[article].md +0 -32
  185. package/dist/logic/roles/bhrain/.briefs/grammar/gerunds.1.why.term_smells.[article].md +0 -36
  186. package/dist/logic/roles/bhrain/.briefs/grammar/gerunds.1.why.term_smells.detection.[lesson].md +0 -73
  187. package/dist/logic/roles/bhrain/.briefs/grammar/gerunds.2.tactic.eliminate.[article].md +0 -55
  188. package/dist/logic/roles/bhrain/.briefs/grammar/gerunds.2.tactic.eliminate.[lesson].md +0 -41
  189. package/dist/logic/roles/bhrain/.briefs/grammar/gerunds.3.eliminator.[trait]._.md +0 -66
  190. package/dist/logic/roles/bhrain/.briefs/grammar/gerunds.3.eliminator.[trait].balance.md +0 -36
  191. package/dist/logic/roles/bhrain/.briefs/grammar/gerunds.3.eliminator.[trait].bane.md +0 -34
  192. package/dist/logic/roles/bhrain/.briefs/grammar/gerunds.3.eliminator.[trait].boon.md +0 -35
  193. package/dist/logic/roles/bhrain/.briefs/knowledge/kno101.primitives.1.ontology.[article].frame.docs_as_materializations.md +0 -63
  194. package/dist/logic/roles/bhrain/.briefs/knowledge/kno101.primitives.1.ontology.[article].frame.docs_as_references.md +0 -45
  195. package/dist/logic/roles/bhrain/.briefs/knowledge/kno101.primitives.2.rel.many_to_many.[article].md +0 -37
  196. package/dist/logic/roles/bhrain/.briefs/knowledge/kno101.primitives.3.instances.[article].md +0 -39
  197. package/dist/logic/roles/bhrain/.briefs/knowledge/kno101.primitives.4.documents.[article].md +0 -37
  198. package/dist/logic/roles/bhrain/.briefs/knowledge/kno101.primitives.5.concepts.[article].md +0 -39
  199. package/dist/logic/roles/bhrain/.briefs/knowledge/kno201.documents._.[article].md +0 -48
  200. package/dist/logic/roles/bhrain/.briefs/knowledge/kno201.documents._.[catalog].md +0 -52
  201. package/dist/logic/roles/bhrain/.briefs/knowledge/kno201.documents.articles.[article].md +0 -40
  202. package/dist/logic/roles/bhrain/.briefs/knowledge/kno201.documents.catalogs.[article].md +0 -41
  203. package/dist/logic/roles/bhrain/.briefs/knowledge/kno201.documents.demos.[article].md +0 -42
  204. package/dist/logic/roles/bhrain/.briefs/knowledge/kno201.documents.lessons.[article].md +0 -42
  205. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.compression.1.refs._.[article].md +0 -41
  206. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.compression.2.kernels._.[article].i1.md +0 -50
  207. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.compression.3.briefs._.[article].md +0 -40
  208. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.compression._.[article].md +0 -90
  209. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.compression._.[catalog].persp.garden.md +0 -64
  210. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[article].md +0 -45
  211. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].algorithm.md +0 -54
  212. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].color.md +0 -56
  213. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].empathy.md +0 -54
  214. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].entropy.md +0 -54
  215. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].gravity.md +0 -54
  216. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].joke.md +0 -56
  217. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.1.from_instances.[demo].value.md +0 -54
  218. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2._.[catalog].md +0 -43
  219. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.articulate.[article].md +0 -27
  220. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.articulate.[lesson].md +0 -49
  221. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.catalogize.[article].md +0 -27
  222. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.catalogize.[lesson].md +0 -54
  223. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.demonstrate.[article].md +0 -26
  224. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.demonstrate.[lesson].md +0 -49
  225. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.lessonize.[article].md +0 -26
  226. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.enbrief.2.lessonize.[lesson].md +0 -54
  227. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.kernelize._.[article].md +0 -58
  228. package/dist/logic/roles/bhrain/.briefs/knowledge/kno301.doc.kernelize._.[lesson].md +0 -88
  229. package/dist/logic/roles/bhrain/.briefs/knowledge/kno351.docs.are_instances.[article].md +0 -34
  230. package/dist/logic/roles/bhrain/.briefs/knowledge/kno351.docs.recursion.[catalog].md +0 -44
  231. package/dist/logic/roles/bhrain/.briefs/knowledge/kno401.actors.1.role.author.[article].md +0 -36
  232. package/dist/logic/roles/bhrain/.briefs/knowledge/kno401.actors.1.role.librarian.[article].md +0 -40
  233. package/dist/logic/roles/bhrain/.briefs/knowledge/kno401.actors.2.interdependence.[article].md +0 -52
  234. package/dist/logic/roles/bhrain/.briefs/knowledge/kno501.doc.enbrief.catalog.structure1.[article].md +0 -53
  235. package/dist/logic/roles/bhrain/.briefs/knowledge/kno501.doc.enbrief.catalog.structure1.[lesson].template.md +0 -101
  236. package/dist/logic/roles/bhrain/.briefs/librarian.context/article.variant.vision.[article].md +0 -60
  237. package/dist/logic/roles/bhrain/.briefs/librarian.context/term.expectation.vs_assumption._.md +0 -60
  238. package/dist/logic/roles/bhrain/.briefs/librarian.context/term.frame.vs_perspective.[article].md +0 -96
  239. package/dist/logic/roles/bhrain/.briefs/librarian.context/term.invariant.[article].md +0 -29
  240. package/dist/logic/roles/bhrain/.briefs/librarian.context/term.lesson._vs_article.[article].md +0 -36
  241. package/dist/logic/roles/bhrain/.briefs/librarian.context/term.ref._vs_brief.md +0 -90
  242. package/dist/logic/roles/bhrain/.briefs/librarian.context/term.referent.[article].md +0 -43
  243. package/dist/logic/roles/bhrain/.briefs/librarian.context/usage.lesson_vs_article.[lesson].md +0 -31
  244. package/dist/logic/roles/bhrain/.briefs/librarian.context/usage.lesson_vs_article_vs_demo.[lesson].md +0 -37
  245. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/.readme.md +0 -12
  246. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>._.[article].frame.cognitive.md +0 -33
  247. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>._.[article].frame.tactical.md +0 -45
  248. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.[catalog].md +0 -83
  249. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.concept_dimension.examples.[article][seed].md +0 -4
  250. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.concept_dimension.invariants.[article].md +0 -36
  251. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.from.examples.md +0 -44
  252. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.from.seed.md +0 -48
  253. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.with.templates.[article].md +0 -57
  254. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tactic.with.templates.[gallery][review].effective.md +0 -1
  255. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<articulate>.tone.bluecollar.[article][seed].md +0 -5
  256. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<catalogize>._.[article][seed].md +0 -3
  257. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<catalogize>.observation.via_clusterage_over_via_imagination.[seed].md +0 -6
  258. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<catalogize>.vs_diverge.[article].persp.save_compute.md +0 -46
  259. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>._.[article].frame.colloquial.i2.by_grok.md +0 -64
  260. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.[catalog].md +0 -106
  261. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.contrast.[demo].usecase.vs_userjourney.by_chatgpt.md +0 -45
  262. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.counter.[demo].usecase.flyer.by_chargpt.md +0 -38
  263. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.counter.[demo].walkability.phoenix.by_chargpt.md +0 -41
  264. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[demo].shear_force.scissors.by_grok.md +0 -52
  265. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[demo].tea.darjeeling.by_grok.md +0 -50
  266. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[demo].usecase.book_flight.by_grok.md +0 -54
  267. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[demo].usecase.order_food.by_chatgpt.md +0 -40
  268. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[demo].walkability.portland.by_chatgpt.i3.md +0 -42
  269. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[demo].walkability.portland.by_grok.i2.md +0 -49
  270. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.[lesson].howto.md +0 -28
  271. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.example.structure.[article].i2.md +0 -73
  272. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.narrative.[demo].usecase.order_online.by_chatgpt.md +0 -34
  273. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/<demonstrate>.variants.walkthrough.[demo].usecase.book_online.by_chatgpt.md +0 -47
  274. package/dist/logic/roles/bhrain/.briefs/librarian.tactics/[brief].verbiage.outline.over.narrative.md +0 -55
  275. package/dist/logic/roles/bhrain/.briefs/logistics/term.logistics.[article].md +0 -21
  276. package/dist/logic/roles/bhrain/.briefs/logistics/term.logistics.of_information.[article].md +0 -22
  277. package/dist/logic/roles/bhrain/.briefs/logistics/term.logistics.of_knowledge.[article].md +0 -29
  278. package/dist/logic/roles/bhrain/.briefs/physics/optics.focal.acuity.md +0 -77
  279. package/dist/logic/roles/bhrain/.briefs/physics/optics.focal.breadth.md +0 -74
  280. package/dist/logic/roles/bhrain/.briefs/physics/optics.focal.depth.md +0 -77
  281. package/dist/logic/roles/bhrain/.briefs/physics/optics.focal.distance.md +0 -92
  282. package/dist/logic/roles/bhrain/.briefs/physics/optics.focal.tradeoffs.md +0 -107
  283. package/dist/logic/roles/bhrain/.briefs/tactician/tactics.compose.traits_and_skills.[article].md +0 -76
  284. package/dist/logic/roles/bhrain/.briefs/tactician/trait.articulation.[article].md +0 -67
  285. package/dist/logic/roles/bhrain/.briefs/tactician/trait.purpose.[article].md +0 -56
  286. package/dist/logic/roles/bhrain/.briefs/tactician/trait.vs_skill.[article].md +0 -55
  287. package/dist/logic/roles/bhrain/.briefs/tactician/trait.vs_tactic.[article].md +0 -70
  288. package/dist/logic/roles/bhrain/.briefs/terms.motive.intent.goal.md +0 -46
  289. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<cluster>._.[article].frame.tactical._.md +0 -85
  290. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<cluster>.vs_<diverge>.duality.[article].md +0 -43
  291. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<diverge>._.[article].frame.cognitive.[seed].md +0 -4
  292. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<diverge>._.[article].frame.tactical.md +0 -89
  293. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<elaborate>_vs_<elucidate>.[seed].md +0 -1
  294. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<enquestion>._.[article].md +0 -113
  295. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<enquestion>._.[gallery].plumber.diagnose.md +0 -130
  296. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<enquestion>._.[gallery].thinker.enquestion.md +0 -125
  297. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<enquestion>.tactic.perspectives.[article].md +0 -36
  298. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<triage>._.[article].frame.tactical.md +0 -85
  299. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<triage>.persp.grades_from_context.[article].md +0 -48
  300. package/dist/logic/roles/bhrain/.briefs/thinker.tactics/<triage>.persp.implicit_question.[article].md +0 -65
  301. package/dist/logic/roles/bhrain/.briefs/trait.chillnature.md +0 -14
  302. package/dist/logic/roles/bhrain/.briefs/trait.ocd.md +0 -5
  303. package/dist/logic/roles/bhrain/.briefs/worders/core.matmuls_vecmuls_elemuls.md +0 -93
  304. package/dist/logic/roles/bhrain/.briefs/worders/core.transformers.as_origin.md +0 -62
  305. package/dist/logic/roles/bhrain/.briefs/worders/core.transformers.self_attention.[article].md +0 -93
  306. package/dist/logic/roles/bhrain/.briefs/worders/core.transformers.self_attention.[demo].ambig.bank.md +0 -80
  307. package/dist/logic/roles/bhrain/.briefs/worders/core.transformers.self_attention.[demo].cat_sat.md +0 -67
  308. package/dist/logic/roles/bhrain/.briefs/worders/force.repeat_input_structures.md +0 -48
  309. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.interdependence.[article].md +0 -37
  310. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.interdependence.[demo].domain.physics.md +0 -30
  311. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internal_vs_external.[article].artist_vs_librarian.md +0 -44
  312. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internal_vs_external.[demo].artist_vs_librarian.md +0 -37
  313. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internal_vs_external.[demo].domain.physics.md +0 -39
  314. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internalized.[article].md +0 -35
  315. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internalized.[demo].artist.md +0 -36
  316. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internalized.[demo].neural.md +0 -37
  317. package/dist/logic/roles/bhrain/.briefs/worders/knowledge.internalized.[demo].pianist.md +0 -34
  318. package/dist/logic/roles/bhrain/.briefs/worders/limits.rhyme.md +0 -46
  319. package/dist/logic/roles/bhrain/.briefs/worders/limits.spell.md +0 -49
  320. package/dist/logic/roles/bhrain/.briefs/worders/teach.via.library.examples.md +0 -28
  321. package/dist/logic/roles/bhrain/.briefs/worders/teach.via.library.explanations_vs_examples.md +0 -40
  322. package/dist/logic/roles/bhrain/.briefs/worders/trend.prefer_reuse.[seed].md +0 -10
  323. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.integration.test.d.ts +0 -1
  324. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.integration.test.js +0 -92
  325. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.integration.test.js.map +0 -1
  326. package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.template.md +0 -120
  327. package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.integration.test.d.ts +0 -1
  328. package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.integration.test.js +0 -118
  329. package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.integration.test.js.map +0 -1
  330. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.integration.test.d.ts +0 -1
  331. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.integration.test.js +0 -119
  332. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.integration.test.js.map +0 -1
  333. package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.template.md +0 -135
  334. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.integration.test.d.ts +0 -1
  335. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.integration.test.js +0 -140
  336. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.integration.test.js.map +0 -1
  337. package/dist/logic/roles/bhrain/khue.cluster/stepCluster.template.md +0 -134
  338. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.integration.test.d.ts +0 -1
  339. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.integration.test.js +0 -115
  340. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.integration.test.js.map +0 -1
  341. package/dist/logic/roles/bhrain/khue.diverge/stepDiverge.template.md +0 -110
  342. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.integration.test.d.ts +0 -1
  343. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.integration.test.js +0 -119
  344. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.integration.test.js.map +0 -1
  345. package/dist/logic/roles/bhrain/khue.instantiate/stepInstantiate.template.md +0 -73
  346. package/dist/logic/roles/bhrain/khue.triage/stepTriage.integration.test.d.ts +0 -1
  347. package/dist/logic/roles/bhrain/khue.triage/stepTriage.integration.test.js +0 -143
  348. package/dist/logic/roles/bhrain/khue.triage/stepTriage.integration.test.js.map +0 -1
  349. package/dist/logic/roles/bhrain/khue.triage/stepTriage.template.md +0 -128
  350. package/dist/logic/roles/coach/.briefs/claude.context-caching.md +0 -76
  351. package/dist/logic/roles/designer/.briefs/declarative-over-imperative.md +0 -79
  352. package/dist/logic/roles/designer/.briefs/declarative-over-imperative.stub.md +0 -14
  353. package/dist/logic/roles/designer/.briefs/pit-of-success.md +0 -70
  354. package/dist/logic/roles/designer/.briefs/pit-of-success.stub.md +0 -3
  355. package/dist/logic/roles/designer/outlineDistilisys/loopOutlineDistilisys.integration.test.d.ts +0 -1
  356. package/dist/logic/roles/designer/outlineDistilisys/loopOutlineDistilisys.integration.test.js +0 -77
  357. package/dist/logic/roles/designer/outlineDistilisys/loopOutlineDistilisys.integration.test.js.map +0 -1
  358. package/dist/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.integration.test.d.ts +0 -1
  359. package/dist/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.integration.test.js +0 -142
  360. package/dist/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.integration.test.js.map +0 -1
  361. package/dist/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.template.md +0 -173
  362. package/dist/logic/roles/designer/outlineRoadmap/loopOutlineRoadmap.integration.test.d.ts +0 -1
  363. package/dist/logic/roles/designer/outlineRoadmap/loopOutlineRoadmap.integration.test.js +0 -71
  364. package/dist/logic/roles/designer/outlineRoadmap/loopOutlineRoadmap.integration.test.js.map +0 -1
  365. package/dist/logic/roles/designer/outlineRoadmap/stepOutlineRoadmap.integration.test.d.ts +0 -1
  366. package/dist/logic/roles/designer/outlineRoadmap/stepOutlineRoadmap.integration.test.js +0 -130
  367. package/dist/logic/roles/designer/outlineRoadmap/stepOutlineRoadmap.integration.test.js.map +0 -1
  368. package/dist/logic/roles/designer/outlineRoadmap/stepOutlineRoadmap.template.md +0 -88
  369. package/dist/logic/roles/designer/outlineVision/stepOutlineVision.template.md +0 -47
  370. package/dist/logic/roles/ecologist/.briefs/.readme.md +0 -17
  371. package/dist/logic/roles/ecologist/.briefs/distilisys/sys101.distilisys.grammar.md +0 -221
  372. package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive._.summary.md +0 -82
  373. package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p1.reversibility.entropy.md +0 -39
  374. package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p2.option.chance.choice.md +0 -140
  375. package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p3.chance.motive.polarity.threat.md +0 -72
  376. package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p4.motive.horizon.md +0 -101
  377. package/dist/logic/roles/ecologist/.briefs/distilisys/sys201.actor.motive.p5.motive.grammar.md +0 -131
  378. package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources._.primitives.summary.md +0 -108
  379. package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt1.primitive.time.md +0 -56
  380. package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt2.primitive.energy.md +0 -69
  381. package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt3.primitive.space.md +0 -85
  382. package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt4.primitive.claim.md +0 -113
  383. package/dist/logic/roles/ecologist/.briefs/distilisys/sys211.actor.resources.pt5.composites.md +0 -146
  384. package/dist/logic/roles/ecologist/.briefs/distilisys/sys231.actor.claims.p1.primitive.exchange.md +0 -130
  385. package/dist/logic/roles/ecologist/.briefs/ecology/.eco001.origin.prompt.md +0 -11
  386. package/dist/logic/roles/ecologist/.briefs/ecology/eco001.overview.md +0 -44
  387. package/dist/logic/roles/ecologist/.briefs/ecology/eco101.core-system-understanding.md +0 -70
  388. package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p1.ecosystem-structure.md +0 -62
  389. package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p2.trophic-dynamics.md +0 -59
  390. package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p3.population-ecology.md +0 -71
  391. package/dist/logic/roles/ecologist/.briefs/ecology/eco101.p4.community-interactions.md +0 -78
  392. package/dist/logic/roles/ecologist/.briefs/ecology/eco505.systems-thinking.md +0 -62
  393. package/dist/logic/roles/ecologist/.briefs/economy/econ001.overview.md +0 -65
  394. package/dist/logic/roles/ecologist/.briefs/economy/econ101.core-mechanics.md +0 -65
  395. package/dist/logic/roles/ecologist/.briefs/economy/econ101.p1.supply-and-demand.md +0 -76
  396. package/dist/logic/roles/ecologist/.briefs/economy/econ101.p2.opportunity-cost.md +0 -106
  397. package/dist/logic/roles/ecologist/.briefs/economy/econ101.p3.marginal-analysis.md +0 -79
  398. package/dist/logic/roles/ecologist/.briefs/economy/econ101.p4.rational-choice.md +0 -81
  399. package/dist/logic/roles/ecologist/.briefs/economy/econ201.market-structures-and-failures.md +0 -81
  400. package/dist/logic/roles/ecologist/.briefs/economy/econ301.production-and-growth.md +0 -71
  401. package/dist/logic/roles/ecologist/.briefs/economy/econ401.macro-systems.md +0 -92
  402. package/dist/logic/roles/ecologist/.briefs/economy/econ501.global-and-institutional.md +0 -85
  403. package/dist/logic/roles/ecologist/.briefs/economy/econ501.p1.game-theory.md +0 -142
  404. package/dist/logic/roles/ecologist/.briefs/economy/econ501.p4.behavioral-economics.md +0 -146
  405. package/dist/logic/roles/ecologist/.briefs/product/user.journey._.[article].i1.md +0 -68
  406. package/dist/logic/roles/ecologist/.briefs/product/user.journey._.[article].md +0 -0
  407. package/dist/logic/roles/ecologist/.briefs/product/user.journey.purpose.[article].i1.md +0 -52
  408. package/dist/logic/roles/ecologist/.briefs/product/user.journey.purpose.[article].md +0 -52
  409. package/dist/logic/roles/ecologist/.briefs/term.distillation.md +0 -93
  410. package/dist/logic/roles/mechanic/.briefs/architecture/bounded-contexts.md +0 -61
  411. package/dist/logic/roles/mechanic/.briefs/architecture/directional-dependencies.md +0 -82
  412. package/dist/logic/roles/mechanic/.briefs/architecture/domain-driven-design.md +0 -61
  413. package/dist/logic/roles/mechanic/.briefs/architecture/ubiqlang.md +0 -37
  414. package/dist/logic/roles/mechanic/.briefs/codestyle/_mech.compressed.md +0 -57
  415. package/dist/logic/roles/mechanic/.briefs/codestyle/_mech.compressed.prompt.md +0 -5
  416. package/dist/logic/roles/mechanic/.briefs/codestyle/flow.failfast.md +0 -37
  417. package/dist/logic/roles/mechanic/.briefs/codestyle/flow.idempotency.md +0 -63
  418. package/dist/logic/roles/mechanic/.briefs/codestyle/flow.immutability.md +0 -48
  419. package/dist/logic/roles/mechanic/.briefs/codestyle/flow.narratives.md +0 -74
  420. package/dist/logic/roles/mechanic/.briefs/codestyle/flow.single-responsibility.md +0 -67
  421. package/dist/logic/roles/mechanic/.briefs/codestyle/flow.transformers_over_conditionals.[lesson].md +0 -97
  422. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.args.input-context.md +0 -61
  423. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.args.input-inline.md +0 -63
  424. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.arrowonly.md +0 -47
  425. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.clear-contracts.md +0 -53
  426. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.tests.given-when-then.md +0 -62
  427. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.what-why.md +0 -88
  428. package/dist/logic/roles/mechanic/.briefs/codestyle/mech.what-why.v2.md +0 -98
  429. package/dist/logic/roles/mechanic/.briefs/codestyle/pit-of-success.via.minimize-surface-area.md +0 -58
  430. package/dist/logic/roles/mechanic/.briefs/criteria.practices/never.term.script.md +0 -7
  431. package/dist/logic/roles/mechanic/.briefs/criteria.practices/prefer.emojis.chill_nature.md +0 -24
  432. package/dist/logic/roles/mechanic/.briefs/criteria.practices/prefer.jq.over_alt.[demo].md +0 -29
  433. package/dist/logic/roles/mechanic/.briefs/criteria.practices/prefer.terraform.[criteria].md +0 -4
  434. package/dist/logic/roles/mechanic/.briefs/criteria.practices/prefer.terraform.[seed].md +0 -17
  435. package/dist/logic/roles/mechanic/.briefs/criteria.practices/require.dependency.pinned_versions.md +0 -3
  436. package/dist/logic/roles/mechanic/.briefs/criteria.practices/require.idempotency.md +0 -33
  437. package/dist/logic/roles/mechanic/.briefs/criteria.practices/require.knowledge.externalized.md +0 -17
  438. package/dist/logic/roles/mechanic/.briefs/engineer/dependency-injection.md +0 -118
  439. package/dist/logic/roles/mechanic/.briefs/engineer/dependency-injection.stub.md +0 -11
  440. package/dist/logic/roles/mechanic/.briefs/lessons/code.prod.typescript.types/bivariance_vs_contravariance.[lesson].md +0 -95
  441. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.contract.inputs.nameargs/bad-practice/forbid.positional-args.md +0 -43
  442. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.contract.inputs.nameargs/best-practice/require.namedargs.md +0 -6
  443. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.declarative/.readme.md +0 -0
  444. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.declarative/best-practice/declastruct.[demo].md +0 -485
  445. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.domain.objects/bad-practices/blocker.has.attributes.nullable.md +0 -13
  446. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.domain.objects/bad-practices/blocker.has.attributes.undefined.md +0 -15
  447. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.domain.objects/bad-practices/blocker.refs.immuatble.md +0 -9
  448. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.domain.objects/best-practice/ref.package.domain-objects.[readme].md +0 -585
  449. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.domain.operations/best-practice/require.sync.names.md +0 -14
  450. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.errors.failfast/bad-practices/forbid.failhide.md +0 -19
  451. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.errors.failfast/bad-practices/forbid.hide_errors.md +0 -13
  452. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.errors.failfast/best-practice/prefer.HelpfulError.wrap.md +0 -54
  453. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.errors.failfast/best-practice/require.fail_fast.[demo].shell.md +0 -17
  454. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.errors.failfast/best-practice/require.fail_fast.md +0 -28
  455. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.narrative/bad-practices/forbid.else.md +0 -54
  456. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.narrative/best-practice/early-returns.named-checks.[demo].md +0 -181
  457. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.repo.structure/bad-practices/forbid.barrel.exports.ts.md +0 -41
  458. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.repo.structure/bad-practices/forbid.index.ts.md +0 -3
  459. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.repo.structure/best-practice/directional-dependencies.md +0 -82
  460. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.repo.structure/best-practice/dot-test-and-dot-temp.md +0 -20
  461. package/dist/logic/roles/mechanic/.briefs/patterns/code.prod.typescript.utils/best-practice/ref.package.as-command.[tips].md +0 -7
  462. package/dist/logic/roles/mechanic/.briefs/patterns/code.test.acceptance/best-practice/blackbox.md +0 -5
  463. package/dist/logic/roles/mechanic/.briefs/patterns/code.test.howto/best-practice/howto.diagnose.[lesson].md +0 -14
  464. package/dist/logic/roles/mechanic/.briefs/patterns/code.test.howto/best-practice/howto.run.[lesson].md +0 -18
  465. package/dist/logic/roles/mechanic/.briefs/patterns/code.test.howto/best-practice/howto.use.[lesson].md +0 -20
  466. package/dist/logic/roles/mechanic/.briefs/patterns/code.test.howto/best-practice/howto.write.[lesson].md +0 -3
  467. package/dist/logic/roles/mechanic/.briefs/patterns/code.test.howto/best-practice/howto.write.[lesson].on_scope.for_integ.md +0 -8
  468. package/dist/logic/roles/mechanic/.briefs/patterns/code.test.howto/best-practice/howto.write.[lesson].on_scope.for_units.md +0 -9
  469. package/dist/logic/roles/mechanic/.briefs/patterns/code.test.howto/best-practice/howto.write.bdd.[lesson].md +0 -280
  470. package/dist/logic/roles/mechanic/.briefs/patterns/code.test.howto/best-practice/prefer.datadriven.md +0 -41
  471. package/dist/logic/roles/mechanic/.briefs/patterns/code.test.howto/best-practice/ref.test-fns.[readme].md +0 -185
  472. package/dist/logic/roles/mechanic/.briefs/patterns/code.test.howto/best-practice/whento.snapshots.[lesson].md +0 -23
  473. package/dist/logic/roles/mechanic/.briefs/patterns/lang.terms/.readme.md +0 -1
  474. package/dist/logic/roles/mechanic/.briefs/patterns/lang.terms/bad-practices/forbid.term=existing.md +0 -10
  475. package/dist/logic/roles/mechanic/.briefs/patterns/lang.terms/best-practice/require.order.noun_adj.md +0 -39
  476. package/dist/logic/roles/mechanic/.briefs/patterns/lang.terms/domain=practices.terms=forbid_prefer_desire_require.md +0 -13
  477. package/dist/logic/roles/mechanic/.briefs/patterns/lang.terms/domain=software.terms=prodcode_vs_testcode.md +0 -7
  478. package/dist/logic/roles/mechanic/.briefs/patterns/lang.tones/.readme.md +0 -3
  479. package/dist/logic/roles/mechanic/.briefs/patterns/lang.tones/prefer.chill-nature.md +0 -0
  480. package/dist/logic/roles/mechanic/.briefs/patterns/lang.tones/prefer.lowercase.md +0 -0
  481. package/dist/logic/roles/mechanic/.briefs/style.compressed.md +0 -29
  482. package/dist/logic/roles/mechanic/.briefs/style.compressed.prompt.md +0 -5
  483. package/dist/logic/roles/mechanic/.briefs/style.names.treestruct.md +0 -48
  484. package/dist/logic/roles/mechanic/.briefs/style.names.ubiqlang.md +0 -37
  485. package/dist/logic/roles/mechanic/.briefs/style.words.lowercase.md +0 -36
  486. package/dist/logic/roles/mechanic/.briefs/terms/badpractice/script.md +0 -9
  487. package/dist/logic/roles/mechanic/.briefs/terms/plan.exec_vs_apply.md +0 -45
  488. package/dist/logic/roles/mechanic/.skills/claude.hooks/check.pretooluse.permissions.sh +0 -235
  489. package/dist/logic/roles/mechanic/.skills/claude.hooks/forbid.stderr.redirect.sh +0 -57
  490. package/dist/logic/roles/mechanic/.skills/declapract.upgrade.sh +0 -50
  491. package/dist/logic/roles/mechanic/.skills/git.worktree.common.sh +0 -58
  492. package/dist/logic/roles/mechanic/.skills/git.worktree.del.sh +0 -51
  493. package/dist/logic/roles/mechanic/.skills/git.worktree.get.sh +0 -51
  494. package/dist/logic/roles/mechanic/.skills/git.worktree.set.sh +0 -108
  495. package/dist/logic/roles/mechanic/.skills/git.worktree.sh +0 -46
  496. package/dist/logic/roles/mechanic/.skills/init.bhuild.sh +0 -260
  497. package/dist/logic/roles/mechanic/.skills/init.claude.hooks.forbid.stderr.redirect.sh +0 -116
  498. package/dist/logic/roles/mechanic/.skills/init.claude.hooks.pretooluse.sh +0 -118
  499. package/dist/logic/roles/mechanic/.skills/init.claude.hooks.sessionstart.sh +0 -113
  500. package/dist/logic/roles/mechanic/.skills/init.claude.hooks.sh +0 -25
  501. package/dist/logic/roles/mechanic/.skills/init.claude.permissions.sh +0 -155
  502. package/dist/logic/roles/mechanic/.skills/init.claude.sh +0 -47
  503. package/dist/logic/roles/mechanic/.skills/link.claude.transcripts.sh +0 -43
  504. package/dist/logic/roles/mechanic/.skills/test.integration.sh +0 -50
  505. package/dist/logic/roles/mechanic/codediff/routeArtistCodeDiff.integration.test.d.ts +0 -1
  506. package/dist/logic/roles/mechanic/codediff/routeArtistCodeDiff.integration.test.js +0 -246
  507. package/dist/logic/roles/mechanic/codediff/routeArtistCodeDiff.integration.test.js.map +0 -1
  508. package/dist/logic/roles/mechanic/codediff/routeArtistCodeDiff.template.md +0 -46
  509. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReview.integration.test.d.ts +0 -1
  510. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReview.integration.test.js +0 -144
  511. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReview.integration.test.js.map +0 -1
  512. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewArchitecture.integration.test.d.ts +0 -1
  513. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewArchitecture.integration.test.js +0 -138
  514. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewArchitecture.integration.test.js.map +0 -1
  515. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewArchitecture.template.md +0 -78
  516. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewCodestyle.integration.test.d.ts +0 -1
  517. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewCodestyle.integration.test.js +0 -294
  518. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewCodestyle.integration.test.js.map +0 -1
  519. package/dist/logic/roles/mechanic/codediff/routeCriticCodeReviewCodestyle.template.md +0 -75
  520. package/dist/logic/roles/mechanic/codediff/routeJudgeReleasable.integration.test.d.ts +0 -1
  521. package/dist/logic/roles/mechanic/codediff/routeJudgeReleasable.integration.test.js +0 -162
  522. package/dist/logic/roles/mechanic/codediff/routeJudgeReleasable.integration.test.js.map +0 -1
  523. package/dist/logic/roles/mechanic/codediff/routeJudgeReleasable.template.md +0 -67
  524. package/dist/logic/roles/mechanic/codediff/routeMechanicCodeIterate.integration.test.d.ts +0 -1
  525. package/dist/logic/roles/mechanic/codediff/routeMechanicCodeIterate.integration.test.js +0 -169
  526. package/dist/logic/roles/mechanic/codediff/routeMechanicCodeIterate.integration.test.js.map +0 -1
  527. package/dist/logic/roles/mechanic/codediff/routeMechanicCodePropose.integration.test.d.ts +0 -1
  528. package/dist/logic/roles/mechanic/codediff/routeMechanicCodePropose.integration.test.js +0 -203
  529. package/dist/logic/roles/mechanic/codediff/routeMechanicCodePropose.integration.test.js.map +0 -1
  530. package/dist/logic/roles/mechanic/study/routeStudyAsk.integration.test.d.ts +0 -1
  531. package/dist/logic/roles/mechanic/study/routeStudyAsk.integration.test.js +0 -98
  532. package/dist/logic/roles/mechanic/study/routeStudyAsk.integration.test.js.map +0 -1
  533. package/dist/logic/roles/mechanic/study/routeStudyAsk.template.md +0 -73
  534. package/dist/logic/roles/mechanic/write/.test/prior.template.md +0 -21
  535. package/dist/logic/roles/mechanic/write/loopWrite.integration.test.d.ts +0 -1
  536. package/dist/logic/roles/mechanic/write/loopWrite.integration.test.js +0 -57
  537. package/dist/logic/roles/mechanic/write/loopWrite.integration.test.js.map +0 -1
  538. package/dist/logic/roles/mechanic/write/stepWrite.integration.test.d.ts +0 -1
  539. package/dist/logic/roles/mechanic/write/stepWrite.integration.test.js +0 -189
  540. package/dist/logic/roles/mechanic/write/stepWrite.integration.test.js.map +0 -1
  541. package/dist/logic/roles/mechanic/write/stepWrite.template.md +0 -38
  542. package/dist/logic/roles/terminal.commander/command.exec/stepExecCommand.integration.test.d.ts +0 -1
  543. package/dist/logic/roles/terminal.commander/command.exec/stepExecCommand.integration.test.js +0 -76
  544. package/dist/logic/roles/terminal.commander/command.exec/stepExecCommand.integration.test.js.map +0 -1
  545. package/dist/logic/roles/terminal.commander/command.plan/stepPlanCommand.integration.test.d.ts +0 -1
  546. package/dist/logic/roles/terminal.commander/command.plan/stepPlanCommand.integration.test.js +0 -97
  547. package/dist/logic/roles/terminal.commander/command.plan/stepPlanCommand.integration.test.js.map +0 -1
@@ -1,64 +0,0 @@
1
- # 🧩 .brief.article: `demonstrate`
2
-
3
- ## .what
4
- **demonstrate** refers to the act of clearly showing or explaining a concept’s essence, structure, or functionality through a tangible instance, often producing a `.brief.demo` artifact to make abstract or complex ideas accessible. In the context of `.brief.demo`, it involves instantiating a concept in a structured Markdown format to reveal its interconnected components, like a tree-like hierarchy, for clear understanding.
5
-
6
- ---
7
-
8
- ## 🎯 purpose
9
- - **clarify** the concept’s core traits, structure, or application by presenting a concrete instance.
10
- - **showcase** how the concept functions through a specific, relatable example in a `.brief.demo`.
11
- - **educate** audiences by organizing the concept’s elements into a clear, hierarchical structure.
12
- - **persuade** readers of the concept’s value by demonstrating its practical or theoretical significance.
13
-
14
- ---
15
-
16
- ## 📏 methods of demonstration
17
- 1. **Instantiation in .brief.demo**
18
- - Present a concept through a specific instance (e.g., a use case template, a physical scenario) within a `.brief.demo` artifact.
19
- - Effective for making abstract or technical concepts tangible, like quantum entanglement via a Bell test.
20
-
21
- 2. **Structured Explanation**
22
- - Use a detailed outline in the `.brief.demo` to explain how the instance embodies the concept’s traits.
23
- - Suitable for breaking down complex ideas into clear, interconnected components.
24
-
25
- 3. **Example-Driven Presentation**
26
- - Highlight a single, relatable example to anchor the demonstration, ensuring accessibility.
27
- - Ideal for engaging diverse audiences, from novices to experts, with familiar instances.
28
-
29
- 4. **Hierarchical Organization**
30
- - Arrange the demonstration to reflect the concept’s tree-like structure, connecting its elements logically.
31
- - Helps reveal the concept’s internal relationships, like branches in a tree, for deeper understanding.
32
-
33
- ---
34
-
35
- ## 🔄 when to use
36
- - When introducing a new concept, such as a technical term or abstract idea, to make it concrete.
37
- - During educational efforts to clarify complex topics through structured `.brief.demo` artifacts.
38
- - To communicate system requirements or functionalities, as in software development use cases.
39
- - When explaining updates or innovations to stakeholders, using clear, instantiated examples.
40
-
41
- ---
42
-
43
- ## 📐 examples
44
- - **Software Development**: Demonstrating a “use case” by presenting a `.brief.demo` for “Booking a Flight on a Travel Website,” using a structured template to show user-system interactions.
45
- - **Physics Education**: Demonstrating “shear force” with a `.brief.demo` for “Scissors Cutting Paper,” highlighting parallel forces and material deformation.
46
- - **Cultural Studies**: Demonstrating “tea” via a `.brief.demo` on “Darjeeling Tea,” detailing its production and cultural role.
47
- - **Scientific Research**: Demonstrating “quantum entanglement” through a `.brief.demo` on a Bell test experiment, showing non-local correlations.
48
-
49
- ---
50
-
51
- ## 📚 benefits
52
- - Enhances understanding by grounding abstract concepts in tangible, relatable instances.
53
- - Builds credibility through structured, clear `.brief.demo` artifacts that showcase expertise.
54
- - Encourages engagement by using familiar examples to connect with diverse audiences.
55
- - Facilitates exploration of a concept’s tree-like structure, revealing its interconnected components.
56
-
57
- ---
58
-
59
- ## ⚠️ potential pitfalls
60
- - Choosing an overly complex instance that obscures the concept instead of clarifying it.
61
- - Failing to tailor the `.brief.demo` structure to the concept’s nature, reducing its effectiveness.
62
- - Overloading the artifact with excessive detail, leading to confusion or disengagement.
63
-
64
- > A well-executed demonstration via a `.brief.demo` transforms abstract concepts into clear, structured, and engaging insights, bridging theory and application through instantiation.
@@ -1,106 +0,0 @@
1
- # .brief.catalog: `demonstrate variants`
2
-
3
-
4
- \`\`\`
5
- concept demonstration (demo, genus)
6
-
7
- ├── instance
8
- │ ├── example
9
- │ │ ↳ question: "what counts as it?"
10
- │ │ ↳ example: "downtown portland is highly walkable —
11
- │ │ groceries, schools, and cafes within 10 minutes."
12
- │ │
13
- │ ├── counter
14
- │ │ ↳ question: "what is it not?"
15
- │ │ ↳ example: "los angeles suburbs where every errand
16
- │ │ requires a car — this is not walkability."
17
- │ │
18
- │ ├── contrast
19
- │ │ ↳ question: "how is this different from that?"
20
- │ │ ↳ example: "compare downtown portland (walkable) to
21
- │ │ houston sprawl (car-dependent)."
22
- │ │
23
- │ └── gradation
24
- │ ↳ question: "how does it vary along a spectrum?"
25
- │ ↳ example: "low → medium → high walkability across three block patterns."
26
-
27
- ├── medium
28
- │ ├── visual
29
- │ │ ↳ question: "what does it look like?"
30
- │ │ ↳ example: "map sketch with a house at the center,
31
- │ │ icons for grocery, school, café,
32
- │ │ all within a shaded 10-minute radius."
33
- │ │
34
- │ └── emotional
35
- │ ↳ question: "what does it feel like?"
36
- │ ↳ example: "the calm of strolling to a café vs the stress of sitting in traffic."
37
-
38
- ├── transfer
39
- │ ├── analogy
40
- │ │ ↳ question: "what is it like, in structure?"
41
- │ │ ↳ example: "walkability is like a circulatory system:
42
- │ │ sidewalks are arteries, intersections are valves,
43
- │ │ parks are lungs, stores are nutrients."
44
- │ │
45
- │ ├── metaphor
46
- │ │ ↳ question: "what is it, figuratively?"
47
- │ │ ↳ example: "walkability is oxygen for a city."
48
- │ │
49
- │ ├── simile
50
- │ │ ↳ question: "what is it like, figuratively?"
51
- │ │ ↳ example: "a walkable neighborhood feels like a living room —
52
- │ │ everything close, familiar, and reachable."
53
- │ │
54
- │ └── allegory
55
- │ ↳ question: "what story-world can stand in for it?"
56
- │ ↳ example: "a city without walkability is a kingdom without paths:
57
- │ villages isolated, markets starved, citizens trapped.
58
- │ when paths connect, culture and trade flow."
59
-
60
- ├── sequence
61
- │ ├── walkthrough
62
- │ │ ↳ question: "how does it proceed?"
63
- │ │ ↳ example: "walk from this apartment to the grocery store,
64
- │ │ noting the sidewalks, crosswalks, and distances."
65
- │ │
66
- │ ├── narrative
67
- │ │ ↳ question: "how does it unfold as lived experience?"
68
- │ │ ↳ example: "maria leaves her home, strolling past the bakery smells,
69
- │ │ greeting a neighbor, and reaching the grocery in five minutes."
70
- │ │
71
- │ ├── causal
72
- │ │ ↳ question: "how do inputs lead to outcomes?"
73
- │ │ ↳ example: "short blocks → more walking → health + economy + climate gains."
74
- │ │
75
- │ └── temporal
76
- │ ↳ question: "how does it change across time?"
77
- │ ↳ example: "1950 streetcar suburb → 1980 arterial strip → 2025 main street retrofit."
78
-
79
- └── model
80
- ├── simulation
81
- │ ↳ question: "how would it behave if modeled?"
82
- │ ↳ example: "urban planning software shows how
83
- │ adding sidewalks shifts daily trips from cars to walking."
84
-
85
- ├── prototype
86
- │ ↳ question: "what form could it take?"
87
- │ ↳ example: "build a model block with wide sidewalks,
88
- │ corner cafés, and bike racks to embody walkability."
89
-
90
- └── factorization
91
- ↳ question: "what are its components?"
92
- ↳ example: "proximity, safety, comfort, interest, connectivity as factors of walkability."
93
- \`\`\`
94
-
95
-
96
- ---
97
-
98
- ## 🎯 notes
99
- - **five clusters** organize the space of concept-demos:
100
- 1. **instance** → cases & boundaries
101
- 2. **medium** → change of representation
102
- 3. **transfer** → meaning carried across concepts
103
- 4. **sequence** → unfolding over time
104
- 5. **model** → embodiment in models/artifacts
105
-
106
- - each subtype has a **walkability demo** attached for clarity.
@@ -1,45 +0,0 @@
1
- # .brief.demo: `use case` via `contrast` = `use case vs user journey`
2
-
3
- ## 💡 concept
4
- a use case describes how a user interacts with a system to achieve a specific goal, while a user journey maps the broader, often emotional, experience of a user across multiple touchpoints with a product or service.
5
-
6
- ## ❓ question
7
- > how does a use case contrast with a user journey?
8
-
9
- ## 📌 contrast: use case vs user journey
10
-
11
- ### 📌.📖 what
12
-
13
- > what are use cases and user journeys?
14
-
15
- - **use case**
16
- - focuses on *functional interaction* between user and system.
17
- - defines *actors, steps, and system responses* leading to a specific outcome.
18
- - *example:* “a customer books a flight on an airline’s website.”
19
-
20
- - **user journey**
21
- - focuses on *holistic experience* across touchpoints.
22
- - includes *motivations, emotions, and pain points* before, during, and after interaction.
23
- - *example:* “a traveler researches destinations, compares prices, books a flight, receives updates, travels, and later reviews the airline.”
24
-
25
- ### 📌.🔍 how
26
-
27
- > how does this contrast demonstrate the concept of use case?
28
-
29
- - **scope**
30
- - a use case is **narrow**, zooming into a single functional interaction.
31
- - a user journey is **broad**, mapping multiple interactions across a timeline.
32
-
33
- - **focus**
34
- - a use case emphasizes **system behavior**: “what happens when the user does X?”
35
- - a user journey emphasizes **user experience**: “how does the user feel at each stage?”
36
-
37
- - **artifact**
38
- - use case outputs are structured step-by-step flows of user + system actions.
39
- - user journey outputs are visual maps, storyboards, or timelines showing phases and emotions.
40
-
41
- - **example contrast**
42
- - **use case:** “customer selects flight → enters details → system confirms booking.”
43
- - **user journey:** “customer dreams of vacation → compares airlines → struggles with hidden fees → books → feels reassured by confirmation → experiences anxiety waiting for boarding.”
44
-
45
- this contrast clarifies that a **use case is about functionality**, while a **user journey is about experience**. together, they complement each other, but they are not the same.
@@ -1,38 +0,0 @@
1
- # .brief.demo: `usecase` via `counter` = `restaurant menu flyer`
2
-
3
- ## 💡 concept
4
- a use case describes how a user interacts with a system to achieve a specific goal, detailing the steps, actors, and system responses involved in the interaction.
5
-
6
- ## ❓ question
7
- > what is a counter-example of a use case?
8
-
9
- ## 📌 counter-example: restaurant menu flyer
10
-
11
- ### 📌.📖 what
12
-
13
- > what is the restaurant menu flyer?
14
-
15
- a printed restaurant menu flyer is a static list of food items and prices distributed for advertising purposes. it provides information but does not describe any user interactions, system responses, or step-by-step goals.
16
-
17
- - **static content**
18
- - lists meals, prices, and phone number
19
- - *example:* a pizza shop flyer with daily specials
20
- - **no interactive process**
21
- - customer may see the flyer, but the flyer itself does not facilitate ordering
22
- - **no system responses**
23
- - the flyer cannot process actions or provide feedback
24
- - **actors missing**
25
- - does not define the roles of customer, staff, or delivery process
26
-
27
- ### 📌.🔍 how
28
-
29
- > how is a restaurant menu flyer a counter-example of a use case?
30
-
31
- the menu flyer illustrates what a use case is *not*, because it lacks:
32
-
33
- - **interaction**: there is no dynamic exchange between user and system—only one-way information.
34
- - **steps**: no sequence of actions leading to a goal is described.
35
- - **actors and responses**: the flyer does not specify participants or their roles, nor does it capture how a system responds to user input.
36
- - **goal structure**: while the flyer hints at a potential outcome (ordering food), it does not map the process of achieving that outcome.
37
-
38
- this counter-example shows that a use case requires **structured interaction** and **defined roles**, not just information or content.
@@ -1,41 +0,0 @@
1
- # .brief.demo: `walkability` via `counter` = `phoenix suburbs`
2
-
3
- ## 💡 concept
4
- walkability is the measure of how friendly an area is to walking, determined by the proximity of daily needs, the quality of pedestrian infrastructure, and the safety and comfort of the walking environment.
5
-
6
- ## ❓ question
7
- > what is a counter-example of walkability?
8
-
9
- ## 📌 counter-example: phoenix suburbs
10
-
11
- ### 📌.📖 what
12
-
13
- > what are the phoenix suburbs?
14
-
15
- the sprawling suburbs around phoenix, arizona, are characterized by low-density housing, wide arterial roads, and zoning that separates residential areas from commercial and institutional uses. daily needs are typically spread out across miles, accessible primarily by car.
16
-
17
- - **long distances to daily needs**
18
- - grocery stores, schools, and cafes located far from most homes
19
- - *example:* a typical subdivision may require a 15–20 minute drive to reach basic shopping
20
- - **disconnected infrastructure**
21
- - large blocks, wide intersections, and missing sidewalks
22
- - *example:* six-lane arterial roads without pedestrian crossings for half a mile
23
- - **unsafe crossings**
24
- - intersections designed for vehicle throughput, not pedestrians
25
- - *example:* high-speed right-turn lanes with no pedestrian refuge
26
- - **weak transit integration**
27
- - bus routes are sparse and stops often lack safe walking access
28
- - *example:* bus stops located on roads without sidewalks or shelters
29
-
30
- ### 📌.🔍 how
31
-
32
- > how is the phoenix suburban pattern a counter-example of walkability?
33
-
34
- phoenix suburbs highlight the absence of walkability through **distance**, **design**, and **dependence**:
35
-
36
- - **distance**: residential and commercial areas are so spread out that walking is impractical for daily errands.
37
- - **design**: streets prioritize car speed and capacity, making walking unpleasant and often dangerous.
38
- - **dependence**: car ownership becomes a necessity, as walking and transit provide no viable alternative.
39
- - **comfort and safety**: the harsh desert climate, combined with limited shade and long stretches without sidewalks, further discourages walking.
40
-
41
- this counter-example shows that when urban planning prioritizes cars over people, walkability disappears—underscoring why compact, mixed-use, and pedestrian-first design is essential for creating walkable places.
@@ -1,52 +0,0 @@
1
- # 🧩 .brief.demo: `mechanical shear force` via `example` = `scissors`
2
-
3
- ## 💡 Concept
4
-
5
- Mechanical shear force is a type of force that acts parallel to a material’s surface, causing one portion to slide past another, often leading to cutting, deformation, or fracture of the material.
6
-
7
- ## ❓ Question
8
-
9
- > What is an example of mechanical shear force?
10
-
11
- ## 📌 Example: Scissors Cutting Paper
12
-
13
- ### 📌.📖 What
14
-
15
- > What is scissors cutting paper?
16
-
17
- Scissors cutting paper is a common action where two sharp blades slide past each other to slice through a sheet of paper, applying a mechanical force that separates the material. This everyday process, used in households and offices, relies on the precise interaction of blades to achieve a clean cut.
18
-
19
- - **Historical Context**
20
- - **Invention of Scissors**: Originated around 1500 BCE in ancient Egypt, with modern pivoted scissors refined in the 18th century for precision tasks.
21
- - **Evolution of Design**: Advanced from simple metal blades to ergonomic handles and specialized types, like crafting or industrial scissors.
22
- - **Physical Components**
23
- - **Blade Structure**: Consists of two sharp, metal blades pivoted at a central point, allowing them to slide against each other.
24
- - **Handle Mechanism**: Ergonomic handles enable the user to apply force, controlling the blades’ movement and pressure.
25
- - **Material Interaction**: The blades contact the paper at a small, localized area, focusing the applied force for effective cutting.
26
- - **Common Applications**
27
- - **Household Use**: Employed for tasks like cutting paper for crafts, wrapping, or office work, accessible to all ages.
28
- - **Industrial Variants**: Used in larger forms, like shears, for cutting tougher materials in manufacturing or textiles.
29
- - **Educational Role**: Taught in schools for art projects, demonstrating basic mechanical principles in action.
30
-
31
- ### 📌.🔍 How
32
-
33
- > How is it an example of mechanical shear force?
34
-
35
- Scissors cutting paper exemplifies mechanical shear force by applying parallel forces through sliding blades to sever the paper, demonstrating the concept’s role in material deformation and separation. The process highlights shear force’s characteristics of localized stress, sliding motion, and structural impact in a practical, observable way.
36
-
37
- - **Application of Parallel Forces**
38
- - **Blade Sliding**: The blades move parallel to each other, exerting opposing forces on the paper’s surface, creating shear stress.
39
- - **Localized Contact**: The force concentrates at the point where the blades meet, maximizing shear effect on a small area.
40
- - **Force Transmission**: User pressure on the handles transfers directly to the blades, amplifying the shear force applied.
41
- - **Material Deformation**
42
- - **Paper Shearing**: The paper’s fibers are pushed apart as the blades slide, causing the material to split cleanly.
43
- - **No Compression**: Unlike crushing, the blades’ action avoids compressing the paper, focusing solely on shear-induced separation.
44
- - **Clean Cut**: The result is a smooth edge, showing shear force’s ability to precisely fracture materials.
45
- - **Mechanical Advantage**
46
- - **Lever Action**: The pivot acts as a fulcrum, multiplying the user’s hand force into greater shear force at the blades.
47
- - **Blade Angle**: The sharp, angled edges reduce the contact area, increasing shear stress for efficient cutting.
48
- - **Design Efficiency**: Ergonomic scissors optimize force transfer, making shear force application intuitive and effective.
49
- - **Observable Outcomes**
50
- - **Visible Separation**: The paper splits visibly as the blades close, directly illustrating shear force’s cutting effect.
51
- - **Material Response**: Thin materials like paper yield easily, while thicker ones resist, showing shear force’s dependence on material strength.
52
- - **Practical Impact**: The clean cut enables precise tasks, connecting shear force to everyday utility and engineering principles.
@@ -1,50 +0,0 @@
1
- # 🧩 .brief.demo: `tea` via `example` = `darjeeling`
2
-
3
- ## 💡 Concept
4
-
5
- Tea is a beverage made by steeping processed leaves, buds, or twigs of the Camellia sinensis plant in hot water, valued for its diverse flavors, cultural significance, and health benefits.
6
-
7
- ## ❓ Question
8
-
9
- > What is an example of tea?
10
-
11
- ## 📌 Example: Darjeeling Tea
12
-
13
- ### 📌.📖 What
14
-
15
- > What is Darjeeling tea?
16
-
17
- Darjeeling tea is a premium black tea grown in the Darjeeling region of West Bengal, India, renowned for its delicate, muscatel flavor and floral aroma. Often called the “Champagne of teas,” it’s cultivated in high-altitude estates and celebrated for its unique terroir-driven qualities.
18
-
19
- - **Historical Context**
20
- - **Origins in India**: Introduced in the 19th century by British colonial planters, inspired by Chinese tea cultivation techniques.
21
- - **Global Recognition**: Gained international fame for its distinct taste, earning a Geographical Indication (GI) status to protect its authenticity.
22
- - **Production Characteristics**
23
- - **High-Altitude Cultivation**: Grown at elevations of 2,000–7,000 feet in the Himalayan foothills, contributing to its unique flavor profile.
24
- - **Seasonal Flushes**: Harvested in distinct seasons (first flush in spring, second flush in summer), each offering different taste notes, from light and floral to robust and fruity.
25
- - **Cultural Significance**
26
- - **Local Tradition**: A cornerstone of Darjeeling’s economy and culture, with tea estates employing thousands and shaping regional identity.
27
- - **Global Appeal**: Prized by tea connoisseurs worldwide, often served in high-end tea houses and ceremonies.
28
-
29
- ### 📌.🔍 How
30
-
31
- > How is it an example of tea?
32
-
33
- Darjeeling tea exemplifies the concept of tea through its meticulous cultivation and processing from Camellia sinensis, its diverse flavor profiles, and its deep cultural and health-related significance. Its global reputation and versatility in preparation highlight the essence of tea as a beverage and cultural staple.
34
-
35
- - **Camellia Sinensis Base**
36
- - **Plant Source**: Made from the leaves of the Camellia sinensis plant, aligning with the core definition of true tea.
37
- - **Processing Techniques**: Undergoes withering, rolling, oxidation, and drying, typical of black tea production, to develop its signature flavor.
38
- - **Varietal Specificity**: Uses the Chinese varietal of Camellia sinensis, adapted to Darjeeling’s unique climate and soil.
39
- - **Flavor and Aroma Diversity**
40
- - **Muscatel Notes**: Known for a distinctive grape-like flavor, especially in second flush teas, showcasing tea’s range of taste profiles.
41
- - **Floral Undertones**: First flush teas offer light, floral aromas, appealing to those seeking delicate tea experiences.
42
- - **Seasonal Variation**: Different harvests (flushes) provide varied flavors, illustrating tea’s versatility within a single origin.
43
- - **Cultural Role**
44
- - **Social Rituals**: Consumed in afternoon tea settings globally, from British high tea to casual sipping in India, reflecting tea’s social importance.
45
- - **Economic Impact**: Supports Darjeeling’s tea estates, employing local communities and reinforcing tea’s role in cultural heritage.
46
- - **Ceremonial Use**: Featured in tea tastings and pairings, highlighting tea’s place in refined cultural practices.
47
- - **Health and Wellness Benefits**
48
- - **Antioxidant Properties**: Contains polyphenols, linked to reducing oxidative stress and supporting heart health.
49
- - **Caffeine Content**: Provides a mild stimulant effect, offering an energy boost without coffee’s intensity.
50
- - **Mental Clarity**: L-theanine promotes relaxation and focus, exemplifying tea’s calming yet invigorating qualities.
@@ -1,54 +0,0 @@
1
- # 🧩 .brief.demo: `use case` via `example` = `booking flight`
2
-
3
- ## 💡 Concept
4
-
5
- A use case describes how a user interacts with a system to achieve a specific goal, detailing actors, steps, and system responses to define functional requirements in software development.
6
-
7
- ## ❓ Question
8
-
9
- > What is an example of a use case?
10
-
11
- ## 📌 Example: Booking a Flight on a Travel Website
12
-
13
- ### 📌.📖 What
14
-
15
- > What is the use case "booking a flight on a travel website"?
16
-
17
- The use case "booking a flight on a travel website" is a structured description of how a traveler uses an online platform like Expedia or Kayak to purchase an airline ticket.
18
-
19
- - **Actor**: Traveler (the user seeking to book a flight).
20
- - **Goal**: To purchase an airline ticket for a chosen destination and date.
21
- - **Preconditions**: The user has access to the travel website via a web browser or mobile app and a valid payment method.
22
- - **Main Flow**:
23
- 1. **User**: Navigates to the website’s homepage and enters departure city, destination, travel dates, and passenger details, then clicks “Search.”
24
- 2. **System**: Displays a list of available flights with details (airlines, times, prices).
25
- 3. **User**: Selects a preferred flight and optional extras (e.g., seat selection, baggage).
26
- 4. **System**: Prompts for passenger details (name, contact info) and payment information.
27
- 5. **User**: Enters payment details and confirms the booking.
28
- 6. **System**: Processes payment, books the ticket, and sends a confirmation email with the ticket.
29
- - **Exceptions**:
30
- - **No Flights Available**: If no flights match the criteria, the system displays an error and suggests alternative dates or destinations.
31
- - **Payment Failure**: If payment fails, the system notifies the user and prompts re-entry or an alternative payment method.
32
-
33
- ### 📌.🔍 How
34
-
35
- > How is it an example of a use case?
36
-
37
- The use case "booking a flight on a travel website" exemplifies a use case by providing a structured description of a traveler’s interaction with a system to achieve a specific goal, capturing user actions, system responses, and edge cases. It serves as a clear blueprint for developers, illustrating how use cases define functional requirements and ensure user-centric system design.
38
-
39
- - **Defined Actor and Goal**
40
- - **Traveler as Actor**: Specifies the user (traveler) as the primary actor, aligning with the use case’s focus on who interacts with the system.
41
- - **Clear Objective**: The goal of purchasing a ticket drives the interaction, a core element of any use case.
42
- - **System Role**: The travel website facilitates the goal, acting as the system under consideration.
43
- - **Structured Interaction Flow**
44
- - **Sequential Steps**: Details a clear sequence (search, select, pay), mirroring the step-by-step flow typical of use case descriptions.
45
- - **User-System Dialogue**: Alternates between user actions (e.g., entering details) and system responses (e.g., displaying flights), reflecting use case dynamics.
46
- - **Preconditions Included**: Specifies requirements like internet access and payment method, setting the stage for the interaction.
47
- - **Exception Handling**
48
- - **Error Scenarios**: Addresses cases like no flights or payment failure, showing how use cases account for alternate paths.
49
- - **User Guidance**: System responses (e.g., error messages, prompts) ensure users can navigate issues, a key use case feature.
50
- - **Robustness**: Captures edge cases, ensuring the system is designed to handle real-world challenges.
51
- - **Requirements Specification**
52
- - **Functional Needs**: Outlines needs like search functionality and payment processing, guiding developers on system features.
53
- - **Security Focus**: Highlights secure payment handling, a critical requirement derived from the use case.
54
- - **Stakeholder Clarity**: Provides a clear reference for developers, testers, and designers to align on user needs and system behavior.
@@ -1,40 +0,0 @@
1
- # .brief.demo: `use case` via `example` = `online food delivery`
2
-
3
- ## 💡 concept
4
- a use case describes how a user interacts with a system to achieve a specific goal, detailing the steps, actors, and system responses involved in the interaction.
5
-
6
- ## ❓ question
7
- > what is an example of a use case?
8
-
9
- ## 📌 example: online food delivery
10
-
11
- ### 📌.📖 what
12
-
13
- > what is the online food delivery use case?
14
-
15
- the online food delivery use case outlines how a customer orders food through a delivery platform (like doordash or uber eats), and how the system responds at each stage to fulfill the request. it represents a common digital interaction where multiple actors (customer, restaurant, courier, system) collaborate to achieve the user’s goal: receiving a meal at home.
16
-
17
- - **actors involved**
18
- - customer places an order
19
- - restaurant receives and prepares food
20
- - courier picks up and delivers the order
21
- - system coordinates communication and payments
22
- - **goal**
23
- - customer receives desired food at their location in a timely manner
24
- - **context**
25
- - mobile app or website interface, integrated with payment and logistics
26
-
27
- ### 📌.🔍 how
28
-
29
- > how is online food delivery an example of a use case?
30
-
31
- it demonstrates a use case by showing the **sequence of interactions**:
32
-
33
- 1. **customer action**: browses menu, selects food, and confirms order.
34
- 2. **system response**: sends order details to the restaurant, processes payment, provides confirmation to customer.
35
- 3. **restaurant action**: prepares the food and marks it ready.
36
- 4. **system response**: dispatches courier notification and tracks delivery.
37
- 5. **courier action**: picks up order and delivers to customer’s address.
38
- 6. **system response**: updates tracking, confirms delivery, and collects feedback.
39
-
40
- this example embodies the concept of a use case by mapping out actors, steps, and goals in a structured way, showing how user intent translates into system-supported outcomes.
@@ -1,42 +0,0 @@
1
- # .brief.demo: `walkability` via `example` = `downtown portland`
2
-
3
- ## 💡 concept
4
- walkability is the measure of how friendly an area is to walking, determined by the proximity of daily needs, the quality of pedestrian infrastructure, and the safety and comfort of the walking environment.
5
-
6
- ## ❓ question
7
- > what is an example of walkability?
8
-
9
- ## 📌 example: downtown portland
10
-
11
- ### 📌.📖 what
12
-
13
- > what is downtown portland?
14
-
15
- downtown portland is a central neighborhood in portland, oregon, known for its compact urban grid, accessible public transit, and pedestrian-friendly design. the area integrates commercial, residential, and cultural spaces within short walking distances.
16
-
17
- - **daily needs within reach**
18
- - groceries, cafes, and schools located within 5–10 minutes by foot
19
- - *example:* whole foods and local corner markets
20
- - *example:* elementary schools and daycare facilities
21
- - **continuous walking network**
22
- - sidewalks, curb ramps, and bike lanes that form a safe, connected grid
23
- - *example:* protected bike lanes on broadway
24
- - **pedestrian-priority crossings**
25
- - crosswalks, countdown signals, and curb extensions
26
- - *example:* marked intersections with pedestrian-first light cycles
27
- - **transit integration**
28
- - max light rail, bus, and streetcar stops accessible directly from sidewalks
29
- - *example:* pioneer courthouse square transit hub
30
-
31
- ### 📌.🔍 how
32
-
33
- > how is downtown portland an example of walkability?
34
-
35
- downtown portland exemplifies walkability because it combines **proximity**, **infrastructure**, and **integration**:
36
-
37
- - **proximity**: mixed-use zoning keeps housing, workplaces, shops, and cultural venues close together, reducing reliance on cars.
38
- - **infrastructure**: the city grid ensures short blocks, frequent intersections, and pedestrian-scale street design that prioritize people on foot.
39
- - **integration**: public transit connects seamlessly with sidewalks, allowing trips to extend beyond walking range without breaking the pedestrian experience.
40
- - **safety and comfort**: traffic calming, green streets, and shaded sidewalks create a walking environment that is both secure and inviting.
41
-
42
- together, these factors transform downtown portland into a living demonstration of how urban design can encourage walking as the default mode of daily life.
@@ -1,49 +0,0 @@
1
- # 🧩 .brief.demo: `walkability` via `example` = `portland`
2
-
3
- ## 💡 Concept
4
-
5
- Walkability refers to how friendly an area is to walking, characterized by safe, accessible, and pleasant environments that encourage pedestrian activity, reduce car dependency, and promote community interaction.
6
-
7
- ## ❓ Question
8
- *What is an example of walkability?*
9
-
10
- ## 📌 Example: Portland’s Pearl District
11
-
12
- ### 📌.📖 What
13
-
14
- What is Portland’s Pearl District?
15
-
16
- The Pearl District is a vibrant, urban neighborhood in Portland, Oregon, known for its transformation from an industrial area into a cultural hub with art galleries, lofts, and lively public spaces. Once home to warehouses and rail yards, it’s now a model of modern urban living with a focus on community and accessibility.
17
-
18
- - **Historical Context**
19
- - **Industrial Origins**: Began as a late 19th-century warehouse and rail yard district, redeveloped in the 1990s into a residential and commercial area.
20
- - **Urban Renewal**: Old industrial buildings were converted into lofts, galleries, and shops, revitalizing the area into a bustling neighborhood.
21
- - **Neighborhood Character**
22
- - **Cultural Hub**: Features prominent art galleries, boutique shops, and restaurants, drawing artists, residents, and tourists.
23
- - **Modern Design**: Combines historic brick buildings with sleek, contemporary architecture in a compact grid layout.
24
- - **Community Features**
25
- - **Public Parks**: Includes Jamison Square and Tanner Springs Park, offering green spaces for recreation and community events.
26
- - **Diverse Housing**: Provides high-rise condos, converted lofts, and some affordable housing, fostering a varied resident base.
27
-
28
- ### 📌.🔍 How
29
-
30
- How is it an example of walkability?
31
-
32
- The Pearl District exemplifies walkability through its compact, mixed-use design, robust pedestrian infrastructure, and vibrant community spaces that make walking safe, convenient, and enjoyable. Its integration with transit and focus on sustainability further enhance its pedestrian-friendly environment.
33
-
34
- - **Mixed-Use Accessibility**
35
- - **Proximity of Amenities**: Shops, cafes, galleries, and offices are within a 10–15 minute walk, enabling car-free daily routines.
36
- - **Street-Level Engagement**: Ground-floor businesses with outdoor seating create lively, walkable destinations.
37
- - **Compact Layout**: Short blocks and a grid pattern minimize walking distances, encouraging pedestrian travel.
38
- - **Pedestrian-Friendly Infrastructure**
39
- - **Safe Sidewalks**: Wide, ADA-compliant sidewalks and frequent crosswalks with countdown timers ensure accessibility and safety.
40
- - **Traffic Calming**: Speed bumps and narrowed streets reduce vehicle speeds, prioritizing pedestrian movement.
41
- - **Aesthetic Appeal**: Tree-lined streets and public art enhance the walking experience, making it pleasant and inviting.
42
- - **Transit Integration**
43
- - **Streetcar Access**: The Portland Streetcar connects the district to downtown and other areas, supporting car-free mobility.
44
- - **Light Rail Proximity**: Nearby MAX light rail stations provide regional access, complementing walking routes.
45
- - **Bike Synergy**: Dedicated bike lanes and racks integrate cycling with walking, enhancing multimodal options.
46
- - **Community and Environmental Benefits**
47
- - **Social Connectivity**: Plazas and events like farmers’ markets foster interactions, making walking a community-building activity.
48
- - **Sustainability**: Reduced car use lowers emissions, aligning with Portland’s eco-friendly ethos.
49
- - **Health Promotion**: Walkable access to amenities encourages physical activity, supporting resident well-being.
@@ -1,28 +0,0 @@
1
- # 🧩 .brief.lesson: howto create a .brief.demo via example
2
-
3
- ## 🎯 Objective
4
-
5
- Learn how to create a `.brief.demo`, a concise document that demonstrates a concept through a specific example, with a focus on instantiating the concept in a dedicated “What” section to make it clear and tangible.
6
-
7
- ## 📋 Steps
8
-
9
- 1. **Define the Concept Clearly**
10
- - Write a brief, one-sentence definition of the concept to set the context for the demonstration.
11
- - **Example**: For the concept of a use case, define it as “A use case describes how a user interacts with a system to achieve a goal, detailing actors, steps, and system responses.”
12
- 2. **Choose a Representative Example**
13
- - Select a single, concrete example that directly embodies the concept and is relatable to the audience.
14
- - **Example**: For shear force, choose “scissors cutting paper” to show parallel forces causing material deformation, a clear and familiar instance.
15
- 3. **Instantiate the Concept in the “What” Section**
16
- - Present the example as a direct instance of the concept, using a structure that mirrors its natural form (e.g., a use case template for “Booking a Flight,” a scenario for shear force).
17
- - Avoid general descriptions; focus on showing the concept in action.
18
- - **Example**: For a use case, present a structured description with Actor (Traveler), Goal (purchase a ticket), Main Flow (search, select, pay), and Exceptions (no flights, payment failure).
19
- 4. **Explain the Connection in a “How” Section**
20
- - Detail how the example embodies the concept’s key characteristics, using a structured format like a bulleted list to ensure clarity and depth.
21
- - **Example**: For “Booking a Flight,” explain how its structured flow and exception handling align with a use case’s role in defining system requirements.
22
-
23
- ## 🔑 Key Considerations
24
-
25
- - **Instantiation is Key**: The “What” section should always present the example as an instance of the concept (e.g., a use case template, not just a booking process) to directly demonstrate its essence, making the concept tangible.
26
- - **Keep It Concise**: Avoid verbose outlines or excessive sub-bullets; focus on the example’s core elements to maintain clarity, as seen in the streamlined “Booking a Flight” use case.
27
- - **Adapt to Concept Type**: Tailor the instantiation to the concept’s nature—use templates for meta-concepts (e.g., use case), scenarios for physical concepts (e.g., shear force), or specific items for tangible concepts (e.g., Darjeeling tea).
28
- - **Ensure Relatability**: Choose examples that resonate with the audience (e.g., scissors for shear force, a familiar website for booking), ensuring accessibility across technical or abstract concepts.