minimal-vibe-coding-kit 0.5.0 → 0.5.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 (378) hide show
  1. package/.agents/skills/agentshield-security-review/SKILL.md +16 -8
  2. package/.agents/skills/agentshield-security-review/references/native-install.md +2 -2
  3. package/.agents/skills/agentshield-security-review/scripts/agentshield_repo_probe.py +19 -1
  4. package/.agents/skills/mermaid/SKILL.md +141 -0
  5. package/.agents/skills/mermaid/UPSTREAM-NOTICE.md +52 -0
  6. package/.agents/skills/mermaid/references/architecture.md +433 -0
  7. package/.agents/skills/mermaid/references/block.md +752 -0
  8. package/.agents/skills/mermaid/references/c4.md +618 -0
  9. package/.agents/skills/mermaid/references/classDiagram.md +1191 -0
  10. package/.agents/skills/mermaid/references/coding-level-charts.md +27 -0
  11. package/.agents/skills/mermaid/references/config-configuration.md +71 -0
  12. package/.agents/skills/mermaid/references/config-directives.md +341 -0
  13. package/.agents/skills/mermaid/references/config-layouts.md +39 -0
  14. package/.agents/skills/mermaid/references/config-math.md +95 -0
  15. package/.agents/skills/mermaid/references/config-theming.md +245 -0
  16. package/.agents/skills/mermaid/references/config-tidy-tree.md +88 -0
  17. package/.agents/skills/mermaid/references/cynefin.md +278 -0
  18. package/.agents/skills/mermaid/references/debug-heatmap.md +68 -0
  19. package/.agents/skills/mermaid/references/entityRelationshipDiagram.md +902 -0
  20. package/.agents/skills/mermaid/references/eventmodeling.md +474 -0
  21. package/.agents/skills/mermaid/references/examples.md +300 -0
  22. package/.agents/skills/mermaid/references/flowchart.md +2166 -0
  23. package/.agents/skills/mermaid/references/gantt.md +736 -0
  24. package/.agents/skills/mermaid/references/gitgraph.md +2137 -0
  25. package/.agents/skills/mermaid/references/ishikawa.md +65 -0
  26. package/.agents/skills/mermaid/references/kanban.md +160 -0
  27. package/.agents/skills/mermaid/references/kit-examples.md +210 -0
  28. package/.agents/skills/mermaid/references/mindmap.md +334 -0
  29. package/.agents/skills/mermaid/references/packet.md +152 -0
  30. package/.agents/skills/mermaid/references/pie.md +111 -0
  31. package/.agents/skills/mermaid/references/preview.html +1143 -0
  32. package/.agents/skills/mermaid/references/quadrantChart.md +266 -0
  33. package/.agents/skills/mermaid/references/radar.md +268 -0
  34. package/.agents/skills/mermaid/references/railroad.md +455 -0
  35. package/.agents/skills/mermaid/references/requirementDiagram.md +494 -0
  36. package/.agents/skills/mermaid/references/sankey.md +414 -0
  37. package/.agents/skills/mermaid/references/sequenceDiagram.md +1206 -0
  38. package/.agents/skills/mermaid/references/stateDiagram.md +669 -0
  39. package/.agents/skills/mermaid/references/styling-preset.md +620 -0
  40. package/.agents/skills/mermaid/references/swimlanes.md +523 -0
  41. package/.agents/skills/mermaid/references/timeline.md +570 -0
  42. package/.agents/skills/mermaid/references/treeView.md +432 -0
  43. package/.agents/skills/mermaid/references/treemap.md +352 -0
  44. package/.agents/skills/mermaid/references/userJourney.md +41 -0
  45. package/.agents/skills/mermaid/references/venn.md +156 -0
  46. package/.agents/skills/mermaid/references/wardley.md +731 -0
  47. package/.agents/skills/mermaid/references/xyChart.md +392 -0
  48. package/.agents/skills/mermaid/references/zenuml.md +473 -0
  49. package/.agents/skills/sequential-thinking/SKILL.md +97 -69
  50. package/.agents/skills/sequential-thinking/examples/adaptive-depth.md +15 -536
  51. package/.agents/skills/sequential-thinking/examples/branching-exploration.md +18 -468
  52. package/.agents/skills/sequential-thinking/examples/linear-reasoning.md +22 -203
  53. package/.agents/skills/sequential-thinking/examples/revision-pattern.md +17 -298
  54. package/.agents/skills/sequential-thinking/references/advanced-techniques.md +98 -0
  55. package/.agents/skills/sequential-thinking/references/output-schema.md +99 -458
  56. package/.agents/skills/sequential-thinking/references/parameters.md +73 -435
  57. package/.agents/skills/sequential-thinking/references/patterns.md +72 -639
  58. package/.agents/skills/tutien/SKILL.md +36 -13
  59. package/.agents/skills/tutien/references/adaptive-response.md +68 -0
  60. package/.agents/skills/tutien/references/lore-sources.md +28 -0
  61. package/.agents/skills/tutien/references/privacy.md +13 -1
  62. package/.agents/skills/tutien/references/schema.md +32 -1
  63. package/.agents/skills/tutien/references/story-system.md +176 -0
  64. package/.agents/skills/tutien/references/vi-style-guide.md +89 -0
  65. package/.agents/skills/tutien/references/voice-and-mode.md +23 -8
  66. package/.agents/skills/tutien/scripts/catalog.mjs +17 -17
  67. package/.agents/skills/tutien/scripts/classify.mjs +64 -37
  68. package/.agents/skills/tutien/scripts/command.mjs +40 -21
  69. package/.agents/skills/tutien/scripts/project-profile.mjs +202 -0
  70. package/.agents/skills/tutien/scripts/render-report.mjs +128 -72
  71. package/.agents/skills/tutien/scripts/response-brief.mjs +103 -0
  72. package/.agents/skills/tutien/scripts/run-tutien.mjs +141 -63
  73. package/.agents/skills/tutien/scripts/story-ledger.mjs +241 -0
  74. package/.agents/skills/tutien/scripts/villains.mjs +14 -14
  75. package/.claude/skills/agentshield-security-review/SKILL.md +16 -8
  76. package/.claude/skills/agentshield-security-review/references/native-install.md +2 -2
  77. package/.claude/skills/agentshield-security-review/scripts/agentshield_repo_probe.py +19 -1
  78. package/.claude/skills/mermaid/SKILL.md +141 -0
  79. package/.claude/skills/mermaid/UPSTREAM-NOTICE.md +52 -0
  80. package/.claude/skills/mermaid/references/architecture.md +433 -0
  81. package/.claude/skills/mermaid/references/block.md +752 -0
  82. package/.claude/skills/mermaid/references/c4.md +618 -0
  83. package/.claude/skills/mermaid/references/classDiagram.md +1191 -0
  84. package/.claude/skills/mermaid/references/coding-level-charts.md +27 -0
  85. package/.claude/skills/mermaid/references/config-configuration.md +71 -0
  86. package/.claude/skills/mermaid/references/config-directives.md +341 -0
  87. package/.claude/skills/mermaid/references/config-layouts.md +39 -0
  88. package/.claude/skills/mermaid/references/config-math.md +95 -0
  89. package/.claude/skills/mermaid/references/config-theming.md +245 -0
  90. package/.claude/skills/mermaid/references/config-tidy-tree.md +88 -0
  91. package/.claude/skills/mermaid/references/cynefin.md +278 -0
  92. package/.claude/skills/mermaid/references/debug-heatmap.md +68 -0
  93. package/.claude/skills/mermaid/references/entityRelationshipDiagram.md +902 -0
  94. package/.claude/skills/mermaid/references/eventmodeling.md +474 -0
  95. package/.claude/skills/mermaid/references/examples.md +300 -0
  96. package/.claude/skills/mermaid/references/flowchart.md +2166 -0
  97. package/.claude/skills/mermaid/references/gantt.md +736 -0
  98. package/.claude/skills/mermaid/references/gitgraph.md +2137 -0
  99. package/.claude/skills/mermaid/references/ishikawa.md +65 -0
  100. package/.claude/skills/mermaid/references/kanban.md +160 -0
  101. package/.claude/skills/mermaid/references/kit-examples.md +210 -0
  102. package/.claude/skills/mermaid/references/mindmap.md +334 -0
  103. package/.claude/skills/mermaid/references/packet.md +152 -0
  104. package/.claude/skills/mermaid/references/pie.md +111 -0
  105. package/.claude/skills/mermaid/references/preview.html +1143 -0
  106. package/.claude/skills/mermaid/references/quadrantChart.md +266 -0
  107. package/.claude/skills/mermaid/references/radar.md +268 -0
  108. package/.claude/skills/mermaid/references/railroad.md +455 -0
  109. package/.claude/skills/mermaid/references/requirementDiagram.md +494 -0
  110. package/.claude/skills/mermaid/references/sankey.md +414 -0
  111. package/.claude/skills/mermaid/references/sequenceDiagram.md +1206 -0
  112. package/.claude/skills/mermaid/references/stateDiagram.md +669 -0
  113. package/.claude/skills/mermaid/references/styling-preset.md +620 -0
  114. package/.claude/skills/mermaid/references/swimlanes.md +523 -0
  115. package/.claude/skills/mermaid/references/timeline.md +570 -0
  116. package/.claude/skills/mermaid/references/treeView.md +432 -0
  117. package/.claude/skills/mermaid/references/treemap.md +352 -0
  118. package/.claude/skills/mermaid/references/userJourney.md +41 -0
  119. package/.claude/skills/mermaid/references/venn.md +156 -0
  120. package/.claude/skills/mermaid/references/wardley.md +731 -0
  121. package/.claude/skills/mermaid/references/xyChart.md +392 -0
  122. package/.claude/skills/mermaid/references/zenuml.md +473 -0
  123. package/.claude/skills/sequential-thinking/SKILL.md +97 -69
  124. package/.claude/skills/sequential-thinking/examples/adaptive-depth.md +15 -536
  125. package/.claude/skills/sequential-thinking/examples/branching-exploration.md +18 -468
  126. package/.claude/skills/sequential-thinking/examples/linear-reasoning.md +22 -203
  127. package/.claude/skills/sequential-thinking/examples/revision-pattern.md +17 -298
  128. package/.claude/skills/sequential-thinking/references/advanced-techniques.md +98 -0
  129. package/.claude/skills/sequential-thinking/references/output-schema.md +99 -458
  130. package/.claude/skills/sequential-thinking/references/parameters.md +73 -435
  131. package/.claude/skills/sequential-thinking/references/patterns.md +72 -639
  132. package/.claude/skills/tutien/SKILL.md +36 -13
  133. package/.claude/skills/tutien/references/adaptive-response.md +68 -0
  134. package/.claude/skills/tutien/references/lore-sources.md +28 -0
  135. package/.claude/skills/tutien/references/privacy.md +13 -1
  136. package/.claude/skills/tutien/references/schema.md +32 -1
  137. package/.claude/skills/tutien/references/story-system.md +176 -0
  138. package/.claude/skills/tutien/references/vi-style-guide.md +89 -0
  139. package/.claude/skills/tutien/references/voice-and-mode.md +23 -8
  140. package/.claude/skills/tutien/scripts/catalog.mjs +17 -17
  141. package/.claude/skills/tutien/scripts/classify.mjs +64 -37
  142. package/.claude/skills/tutien/scripts/command.mjs +40 -21
  143. package/.claude/skills/tutien/scripts/project-profile.mjs +202 -0
  144. package/.claude/skills/tutien/scripts/render-report.mjs +128 -72
  145. package/.claude/skills/tutien/scripts/response-brief.mjs +103 -0
  146. package/.claude/skills/tutien/scripts/run-tutien.mjs +141 -63
  147. package/.claude/skills/tutien/scripts/story-ledger.mjs +241 -0
  148. package/.claude/skills/tutien/scripts/villains.mjs +14 -14
  149. package/.codex-plugin/plugin.json +1 -1
  150. package/.cursor/skills/mermaid/SKILL.md +141 -0
  151. package/.cursor/skills/mermaid/UPSTREAM-NOTICE.md +52 -0
  152. package/.cursor/skills/mermaid/references/architecture.md +433 -0
  153. package/.cursor/skills/mermaid/references/block.md +752 -0
  154. package/.cursor/skills/mermaid/references/c4.md +618 -0
  155. package/.cursor/skills/mermaid/references/classDiagram.md +1191 -0
  156. package/.cursor/skills/mermaid/references/coding-level-charts.md +27 -0
  157. package/.cursor/skills/mermaid/references/config-configuration.md +71 -0
  158. package/.cursor/skills/mermaid/references/config-directives.md +341 -0
  159. package/.cursor/skills/mermaid/references/config-layouts.md +39 -0
  160. package/.cursor/skills/mermaid/references/config-math.md +95 -0
  161. package/.cursor/skills/mermaid/references/config-theming.md +245 -0
  162. package/.cursor/skills/mermaid/references/config-tidy-tree.md +88 -0
  163. package/.cursor/skills/mermaid/references/cynefin.md +278 -0
  164. package/.cursor/skills/mermaid/references/debug-heatmap.md +68 -0
  165. package/.cursor/skills/mermaid/references/entityRelationshipDiagram.md +902 -0
  166. package/.cursor/skills/mermaid/references/eventmodeling.md +474 -0
  167. package/.cursor/skills/mermaid/references/examples.md +300 -0
  168. package/.cursor/skills/mermaid/references/flowchart.md +2166 -0
  169. package/.cursor/skills/mermaid/references/gantt.md +736 -0
  170. package/.cursor/skills/mermaid/references/gitgraph.md +2137 -0
  171. package/.cursor/skills/mermaid/references/ishikawa.md +65 -0
  172. package/.cursor/skills/mermaid/references/kanban.md +160 -0
  173. package/.cursor/skills/mermaid/references/kit-examples.md +210 -0
  174. package/.cursor/skills/mermaid/references/mindmap.md +334 -0
  175. package/.cursor/skills/mermaid/references/packet.md +152 -0
  176. package/.cursor/skills/mermaid/references/pie.md +111 -0
  177. package/.cursor/skills/mermaid/references/preview.html +1143 -0
  178. package/.cursor/skills/mermaid/references/quadrantChart.md +266 -0
  179. package/.cursor/skills/mermaid/references/radar.md +268 -0
  180. package/.cursor/skills/mermaid/references/railroad.md +455 -0
  181. package/.cursor/skills/mermaid/references/requirementDiagram.md +494 -0
  182. package/.cursor/skills/mermaid/references/sankey.md +414 -0
  183. package/.cursor/skills/mermaid/references/sequenceDiagram.md +1206 -0
  184. package/.cursor/skills/mermaid/references/stateDiagram.md +669 -0
  185. package/.cursor/skills/mermaid/references/styling-preset.md +620 -0
  186. package/.cursor/skills/mermaid/references/swimlanes.md +523 -0
  187. package/.cursor/skills/mermaid/references/timeline.md +570 -0
  188. package/.cursor/skills/mermaid/references/treeView.md +432 -0
  189. package/.cursor/skills/mermaid/references/treemap.md +352 -0
  190. package/.cursor/skills/mermaid/references/userJourney.md +41 -0
  191. package/.cursor/skills/mermaid/references/venn.md +156 -0
  192. package/.cursor/skills/mermaid/references/wardley.md +731 -0
  193. package/.cursor/skills/mermaid/references/xyChart.md +392 -0
  194. package/.cursor/skills/mermaid/references/zenuml.md +473 -0
  195. package/.cursor/skills/sequential-thinking/SKILL.md +97 -69
  196. package/.cursor/skills/sequential-thinking/examples/adaptive-depth.md +15 -536
  197. package/.cursor/skills/sequential-thinking/examples/branching-exploration.md +18 -468
  198. package/.cursor/skills/sequential-thinking/examples/linear-reasoning.md +22 -203
  199. package/.cursor/skills/sequential-thinking/examples/revision-pattern.md +17 -298
  200. package/.cursor/skills/sequential-thinking/references/advanced-techniques.md +98 -0
  201. package/.cursor/skills/sequential-thinking/references/output-schema.md +99 -458
  202. package/.cursor/skills/sequential-thinking/references/parameters.md +73 -435
  203. package/.cursor/skills/sequential-thinking/references/patterns.md +72 -639
  204. package/.cursor/skills/tutien/SKILL.md +36 -13
  205. package/.cursor/skills/tutien/references/adaptive-response.md +68 -0
  206. package/.cursor/skills/tutien/references/lore-sources.md +28 -0
  207. package/.cursor/skills/tutien/references/privacy.md +13 -1
  208. package/.cursor/skills/tutien/references/schema.md +32 -1
  209. package/.cursor/skills/tutien/references/story-system.md +176 -0
  210. package/.cursor/skills/tutien/references/vi-style-guide.md +89 -0
  211. package/.cursor/skills/tutien/references/voice-and-mode.md +23 -8
  212. package/.cursor/skills/tutien/scripts/catalog.mjs +17 -17
  213. package/.cursor/skills/tutien/scripts/classify.mjs +64 -37
  214. package/.cursor/skills/tutien/scripts/command.mjs +40 -21
  215. package/.cursor/skills/tutien/scripts/project-profile.mjs +202 -0
  216. package/.cursor/skills/tutien/scripts/render-report.mjs +128 -72
  217. package/.cursor/skills/tutien/scripts/response-brief.mjs +103 -0
  218. package/.cursor/skills/tutien/scripts/run-tutien.mjs +141 -63
  219. package/.cursor/skills/tutien/scripts/story-ledger.mjs +241 -0
  220. package/.cursor/skills/tutien/scripts/villains.mjs +14 -14
  221. package/.grok/skills/agentshield-security-review/SKILL.md +16 -8
  222. package/.grok/skills/agentshield-security-review/references/native-install.md +2 -2
  223. package/.grok/skills/agentshield-security-review/scripts/agentshield_repo_probe.py +19 -1
  224. package/.grok/skills/mermaid/SKILL.md +141 -0
  225. package/.grok/skills/mermaid/UPSTREAM-NOTICE.md +52 -0
  226. package/.grok/skills/mermaid/references/architecture.md +433 -0
  227. package/.grok/skills/mermaid/references/block.md +752 -0
  228. package/.grok/skills/mermaid/references/c4.md +618 -0
  229. package/.grok/skills/mermaid/references/classDiagram.md +1191 -0
  230. package/.grok/skills/mermaid/references/coding-level-charts.md +27 -0
  231. package/.grok/skills/mermaid/references/config-configuration.md +71 -0
  232. package/.grok/skills/mermaid/references/config-directives.md +341 -0
  233. package/.grok/skills/mermaid/references/config-layouts.md +39 -0
  234. package/.grok/skills/mermaid/references/config-math.md +95 -0
  235. package/.grok/skills/mermaid/references/config-theming.md +245 -0
  236. package/.grok/skills/mermaid/references/config-tidy-tree.md +88 -0
  237. package/.grok/skills/mermaid/references/cynefin.md +278 -0
  238. package/.grok/skills/mermaid/references/debug-heatmap.md +68 -0
  239. package/.grok/skills/mermaid/references/entityRelationshipDiagram.md +902 -0
  240. package/.grok/skills/mermaid/references/eventmodeling.md +474 -0
  241. package/.grok/skills/mermaid/references/examples.md +300 -0
  242. package/.grok/skills/mermaid/references/flowchart.md +2166 -0
  243. package/.grok/skills/mermaid/references/gantt.md +736 -0
  244. package/.grok/skills/mermaid/references/gitgraph.md +2137 -0
  245. package/.grok/skills/mermaid/references/ishikawa.md +65 -0
  246. package/.grok/skills/mermaid/references/kanban.md +160 -0
  247. package/.grok/skills/mermaid/references/kit-examples.md +210 -0
  248. package/.grok/skills/mermaid/references/mindmap.md +334 -0
  249. package/.grok/skills/mermaid/references/packet.md +152 -0
  250. package/.grok/skills/mermaid/references/pie.md +111 -0
  251. package/.grok/skills/mermaid/references/preview.html +1143 -0
  252. package/.grok/skills/mermaid/references/quadrantChart.md +266 -0
  253. package/.grok/skills/mermaid/references/radar.md +268 -0
  254. package/.grok/skills/mermaid/references/railroad.md +455 -0
  255. package/.grok/skills/mermaid/references/requirementDiagram.md +494 -0
  256. package/.grok/skills/mermaid/references/sankey.md +414 -0
  257. package/.grok/skills/mermaid/references/sequenceDiagram.md +1206 -0
  258. package/.grok/skills/mermaid/references/stateDiagram.md +669 -0
  259. package/.grok/skills/mermaid/references/styling-preset.md +620 -0
  260. package/.grok/skills/mermaid/references/swimlanes.md +523 -0
  261. package/.grok/skills/mermaid/references/timeline.md +570 -0
  262. package/.grok/skills/mermaid/references/treeView.md +432 -0
  263. package/.grok/skills/mermaid/references/treemap.md +352 -0
  264. package/.grok/skills/mermaid/references/userJourney.md +41 -0
  265. package/.grok/skills/mermaid/references/venn.md +156 -0
  266. package/.grok/skills/mermaid/references/wardley.md +731 -0
  267. package/.grok/skills/mermaid/references/xyChart.md +392 -0
  268. package/.grok/skills/mermaid/references/zenuml.md +473 -0
  269. package/.grok/skills/sequential-thinking/SKILL.md +97 -69
  270. package/.grok/skills/sequential-thinking/examples/adaptive-depth.md +15 -536
  271. package/.grok/skills/sequential-thinking/examples/branching-exploration.md +18 -468
  272. package/.grok/skills/sequential-thinking/examples/linear-reasoning.md +22 -203
  273. package/.grok/skills/sequential-thinking/examples/revision-pattern.md +17 -298
  274. package/.grok/skills/sequential-thinking/references/advanced-techniques.md +98 -0
  275. package/.grok/skills/sequential-thinking/references/output-schema.md +99 -458
  276. package/.grok/skills/sequential-thinking/references/parameters.md +73 -435
  277. package/.grok/skills/sequential-thinking/references/patterns.md +72 -639
  278. package/.grok/skills/tutien/SKILL.md +36 -13
  279. package/.grok/skills/tutien/references/adaptive-response.md +68 -0
  280. package/.grok/skills/tutien/references/lore-sources.md +28 -0
  281. package/.grok/skills/tutien/references/privacy.md +13 -1
  282. package/.grok/skills/tutien/references/schema.md +32 -1
  283. package/.grok/skills/tutien/references/story-system.md +176 -0
  284. package/.grok/skills/tutien/references/vi-style-guide.md +89 -0
  285. package/.grok/skills/tutien/references/voice-and-mode.md +23 -8
  286. package/.grok/skills/tutien/scripts/catalog.mjs +17 -17
  287. package/.grok/skills/tutien/scripts/classify.mjs +64 -37
  288. package/.grok/skills/tutien/scripts/command.mjs +40 -21
  289. package/.grok/skills/tutien/scripts/project-profile.mjs +202 -0
  290. package/.grok/skills/tutien/scripts/render-report.mjs +128 -72
  291. package/.grok/skills/tutien/scripts/response-brief.mjs +103 -0
  292. package/.grok/skills/tutien/scripts/run-tutien.mjs +141 -63
  293. package/.grok/skills/tutien/scripts/story-ledger.mjs +241 -0
  294. package/.grok/skills/tutien/scripts/villains.mjs +14 -14
  295. package/.vibekit/docs/INSTALL.md +2 -1
  296. package/.vibekit/docs/SECURITY_MODEL.md +4 -1
  297. package/.vibekit/scripts/init-backbone.mjs +1 -1
  298. package/.vibekit/scripts/validate-kit.mjs +179 -3
  299. package/.vibekit/skills/agentshield-security-review/SKILL.md +16 -8
  300. package/.vibekit/skills/agentshield-security-review/references/native-install.md +2 -2
  301. package/.vibekit/skills/agentshield-security-review/scripts/agentshield_repo_probe.py +19 -1
  302. package/.vibekit/skills/mermaid/SKILL.md +141 -0
  303. package/.vibekit/skills/mermaid/UPSTREAM-NOTICE.md +52 -0
  304. package/.vibekit/skills/mermaid/references/architecture.md +433 -0
  305. package/.vibekit/skills/mermaid/references/block.md +752 -0
  306. package/.vibekit/skills/mermaid/references/c4.md +618 -0
  307. package/.vibekit/skills/mermaid/references/classDiagram.md +1191 -0
  308. package/.vibekit/skills/mermaid/references/coding-level-charts.md +27 -0
  309. package/.vibekit/skills/mermaid/references/config-configuration.md +71 -0
  310. package/.vibekit/skills/mermaid/references/config-directives.md +341 -0
  311. package/.vibekit/skills/mermaid/references/config-layouts.md +39 -0
  312. package/.vibekit/skills/mermaid/references/config-math.md +95 -0
  313. package/.vibekit/skills/mermaid/references/config-theming.md +245 -0
  314. package/.vibekit/skills/mermaid/references/config-tidy-tree.md +88 -0
  315. package/.vibekit/skills/mermaid/references/cynefin.md +278 -0
  316. package/.vibekit/skills/mermaid/references/debug-heatmap.md +68 -0
  317. package/.vibekit/skills/mermaid/references/entityRelationshipDiagram.md +902 -0
  318. package/.vibekit/skills/mermaid/references/eventmodeling.md +474 -0
  319. package/.vibekit/skills/mermaid/references/examples.md +300 -0
  320. package/.vibekit/skills/mermaid/references/flowchart.md +2166 -0
  321. package/.vibekit/skills/mermaid/references/gantt.md +736 -0
  322. package/.vibekit/skills/mermaid/references/gitgraph.md +2137 -0
  323. package/.vibekit/skills/mermaid/references/ishikawa.md +65 -0
  324. package/.vibekit/skills/mermaid/references/kanban.md +160 -0
  325. package/.vibekit/skills/mermaid/references/kit-examples.md +210 -0
  326. package/.vibekit/skills/mermaid/references/mindmap.md +334 -0
  327. package/.vibekit/skills/mermaid/references/packet.md +152 -0
  328. package/.vibekit/skills/mermaid/references/pie.md +111 -0
  329. package/.vibekit/skills/mermaid/references/preview.html +1143 -0
  330. package/.vibekit/skills/mermaid/references/quadrantChart.md +266 -0
  331. package/.vibekit/skills/mermaid/references/radar.md +268 -0
  332. package/.vibekit/skills/mermaid/references/railroad.md +455 -0
  333. package/.vibekit/skills/mermaid/references/requirementDiagram.md +494 -0
  334. package/.vibekit/skills/mermaid/references/sankey.md +414 -0
  335. package/.vibekit/skills/mermaid/references/sequenceDiagram.md +1206 -0
  336. package/.vibekit/skills/mermaid/references/stateDiagram.md +669 -0
  337. package/.vibekit/skills/mermaid/references/styling-preset.md +620 -0
  338. package/.vibekit/skills/mermaid/references/swimlanes.md +523 -0
  339. package/.vibekit/skills/mermaid/references/timeline.md +570 -0
  340. package/.vibekit/skills/mermaid/references/treeView.md +432 -0
  341. package/.vibekit/skills/mermaid/references/treemap.md +352 -0
  342. package/.vibekit/skills/mermaid/references/userJourney.md +41 -0
  343. package/.vibekit/skills/mermaid/references/venn.md +156 -0
  344. package/.vibekit/skills/mermaid/references/wardley.md +731 -0
  345. package/.vibekit/skills/mermaid/references/xyChart.md +392 -0
  346. package/.vibekit/skills/mermaid/references/zenuml.md +473 -0
  347. package/.vibekit/skills/sequential-thinking/SKILL.md +97 -69
  348. package/.vibekit/skills/sequential-thinking/examples/adaptive-depth.md +15 -536
  349. package/.vibekit/skills/sequential-thinking/examples/branching-exploration.md +18 -468
  350. package/.vibekit/skills/sequential-thinking/examples/linear-reasoning.md +22 -203
  351. package/.vibekit/skills/sequential-thinking/examples/revision-pattern.md +17 -298
  352. package/.vibekit/skills/sequential-thinking/references/advanced-techniques.md +98 -0
  353. package/.vibekit/skills/sequential-thinking/references/output-schema.md +99 -458
  354. package/.vibekit/skills/sequential-thinking/references/parameters.md +73 -435
  355. package/.vibekit/skills/sequential-thinking/references/patterns.md +72 -639
  356. package/.vibekit/skills/skills-manifest.json +2 -1
  357. package/.vibekit/skills/tutien/SKILL.md +36 -13
  358. package/.vibekit/skills/tutien/references/adaptive-response.md +68 -0
  359. package/.vibekit/skills/tutien/references/lore-sources.md +28 -0
  360. package/.vibekit/skills/tutien/references/privacy.md +13 -1
  361. package/.vibekit/skills/tutien/references/schema.md +32 -1
  362. package/.vibekit/skills/tutien/references/story-system.md +176 -0
  363. package/.vibekit/skills/tutien/references/vi-style-guide.md +89 -0
  364. package/.vibekit/skills/tutien/references/voice-and-mode.md +23 -8
  365. package/.vibekit/skills/tutien/scripts/catalog.mjs +17 -17
  366. package/.vibekit/skills/tutien/scripts/classify.mjs +64 -37
  367. package/.vibekit/skills/tutien/scripts/command.mjs +40 -21
  368. package/.vibekit/skills/tutien/scripts/project-profile.mjs +202 -0
  369. package/.vibekit/skills/tutien/scripts/render-report.mjs +128 -72
  370. package/.vibekit/skills/tutien/scripts/response-brief.mjs +103 -0
  371. package/.vibekit/skills/tutien/scripts/run-tutien.mjs +141 -63
  372. package/.vibekit/skills/tutien/scripts/story-ledger.mjs +241 -0
  373. package/.vibekit/skills/tutien/scripts/villains.mjs +14 -14
  374. package/CHANGELOG.md +47 -1
  375. package/README.md +273 -15
  376. package/docs/README.vi.md +290 -32
  377. package/docs/README.zh-CN.md +273 -15
  378. package/package.json +4 -2
@@ -1,666 +1,99 @@
1
- # Sequential Thinking - Usage Patterns
1
+ # Evidence-Led Sequential Thinking Patterns
2
2
 
3
- Comprehensive guide to reasoning patterns with Sequential Thinking.
3
+ These patterns use kit-native cases and public checkpoints. They are examples of concise reasoning state, not transcripts of private deliberation.
4
4
 
5
- ## Core Patterns
5
+ ## Linear Evidence Chain
6
6
 
7
- ### Pattern 1: Linear Sequence
7
+ Use when each check depends on the previous result.
8
8
 
9
- **Use for:** Straightforward problems with clear progression
9
+ ~~~text
10
+ Thought 1/5: A packaged skill is missing; completion means it appears in the dry-run.
11
+ Thought 2/5 [HYPOTHESIS]: The canonical directory is absent.
12
+ Thought 3/5 [VERIFICATION]: The directory exists and contains all required files; reject the hypothesis.
13
+ Thought 4/5 [HYPOTHESIS]: The package files list omits the surface directory.
14
+ Thought 5/5 [FINAL]: The omission is confirmed; patch the list and rerun validation plus the dry-run.
15
+ ~~~
10
16
 
11
- **Structure:**
12
- ```
13
- Thought 1 → Thought 2 → Thought 3 → ... → Conclusion
14
- ```
17
+ ## Hypothesis And Verification Loop
15
18
 
16
- **Example:**
17
- ```bash
18
- /sequential-thinking "Problem: Slow API performance" 1 5 true
19
- /sequential-thinking "Measure: P95 latency is 800ms" 2 5 true
20
- /sequential-thinking "Analyze: Database queries are bottleneck" 3 5 true
21
- /sequential-thinking "Solution: Add database indexes" 4 5 true
22
- /sequential-thinking "Validation: Latency reduced to 120ms" 5 5 false
23
- ```
19
+ Use when several causes could explain one symptom.
24
20
 
25
- **When to use:**
26
- - Clear problem statement
27
- - Predictable analysis steps
28
- - Sequential dependencies
21
+ ~~~text
22
+ Thought 1/6: The validator reports a mirror mismatch.
23
+ Thought 2/6 [HYPOTHESIS]: Distribution skipped the Codex surface.
24
+ Thought 3/6 [VERIFICATION]: Codex is current; the Grok copy differs.
25
+ Thought 4/6 [REVISION of Thought 2]: The fault is one stale Grok file; no other surface is affected.
26
+ Thought 5/6 [VERIFICATION]: Synchronize that file in a sandbox; mirror parity and the full validator pass.
27
+ Thought 6/6 [FINAL]: Keep the scoped synchronization and review the diff.
28
+ ~~~
29
29
 
30
- ---
30
+ A verification result can refute the current hypothesis. That is progress.
31
31
 
32
- ### Pattern 2: Revision Chain
32
+ ## Branch And Convergence
33
33
 
34
- **Use for:** Problems where initial assumptions may be wrong
34
+ Use when alternatives materially change ownership or failure modes.
35
35
 
36
- **Structure:**
37
- ```
38
- Thought 1 Thought 2 [Revision of 1] Thought 3 (corrected path)
39
- ```
36
+ ~~~text
37
+ Thought 1/7: Decide where skill registration should live.
38
+ Thought 2/7 [BRANCH manifest-driven from Thought 1]: One central manifest derives every surface; lower drift, stronger tooling dependency.
39
+ Thought 3/7 [BRANCH surface-local from Thought 1]: Each agent owns a registry; easier local edits, high parity risk.
40
+ Thought 4/7 [VERIFICATION]: Current installer already reads the central manifest.
41
+ Thought 5/7 [CONVERGENCE]: Manifest-driven registration fits existing architecture and removes duplicate truth.
42
+ Thought 6/7 [VERIFICATION]: A fixture added once appears on all declared surfaces.
43
+ Thought 7/7 [FINAL]: Keep the manifest-driven design and document the derivation.
44
+ ~~~
40
45
 
41
- **Example:**
42
- ```bash
43
- /sequential-thinking "Hypothesis: Caching will solve it" 1 5 true
44
- /sequential-thinking "Implementing Redis cache..." 2 5 true
45
- /sequential-thinking "Testing shows no improvement - cache wasn't the issue" 3 5 true isRevision=true revisesThought=1
46
- /sequential-thinking "Real cause: N+1 query problem" 4 5 true
47
- /sequential-thinking "Solution: Eager loading relationships" 5 5 false
48
- ```
46
+ Branches must converge before FINAL.
49
47
 
50
- **When to use:**
51
- - Hypothesis-driven analysis
52
- - Uncertain root cause
53
- - Trial-and-error exploration
48
+ ## Revision Cascade
54
49
 
55
- ---
50
+ Use when new evidence invalidates a foundation.
56
51
 
57
- ### Pattern 3: Branching Exploration
52
+ ~~~text
53
+ Thought 1/6: Assume the release failure comes from a missing mirror.
54
+ Thought 2/6: Plan to copy the canonical directory to every surface.
55
+ Thought 3/6 [VERIFICATION]: Mirrors already match; the package dry-run excludes an entire parent path.
56
+ Thought 4/6 [REVISION of Thought 1]: The packaging rule is wrong. Thought 2 is discarded.
57
+ Thought 5/6 [VERIFICATION]: Repair only the package rule; mirror parity remains green and the file appears.
58
+ Thought 6/6 [FINAL]: Keep the packaging repair; no mirror rewrite is needed.
59
+ ~~~
58
60
 
59
- **Use for:** Comparing multiple approaches
61
+ State which downstream checkpoints survive a revision.
60
62
 
61
- **Structure:**
62
- ```
63
- ├→ Branch A (approach 1)
64
- Thought 1 → Thought 2 ├→ Branch B (approach 2) → Synthesis
65
- └→ Branch C (approach 3)
66
- ```
63
+ ## Adaptive Depth
67
64
 
68
- **Example:**
69
- ```bash
70
- /sequential-thinking "Need to choose state management" 1 8 true
71
- /sequential-thinking "Options: Redux, MobX, Context API" 2 8 true
65
+ Use when the initial estimate changes after evidence.
72
66
 
73
- # Branch A: Redux
74
- /sequential-thinking "Redux: Predictable, great DevTools" 3 8 true branchFromThought=2 branchId="redux"
75
- /sequential-thinking "Redux: More boilerplate needed" 4 8 true branchFromThought=2 branchId="redux"
67
+ ~~~text
68
+ Thought 1/4: Inspect an installer scope bug.
69
+ Thought 2/6 [VERIFICATION]: The same path resolver serves install, repair, and doctor; expand to cover three callers.
70
+ Thought 3/6: Define containment and non-empty-path invariants once.
71
+ Thought 4/5 [VERIFICATION]: All callers use the shared guard, so a separate doctor patch is unnecessary; contract the total.
72
+ Thought 5/5 [FINAL]: Validate the shared guard with empty, root, traversal, and valid project fixtures.
73
+ ~~~
76
74
 
77
- # Branch B: MobX
78
- /sequential-thinking "MobX: Simple, reactive" 5 8 true branchFromThought=2 branchId="mobx"
79
- /sequential-thinking "MobX: Magic can be confusing" 6 8 true branchFromThought=2 branchId="mobx"
75
+ Totals may expand or contract but never below the current checkpoint number.
80
76
 
81
- # Branch C: Context
82
- /sequential-thinking "Context: Built-in, no deps" 7 8 true branchFromThought=2 branchId="context"
77
+ ## Meta Calibration
83
78
 
84
- # Synthesis
85
- /sequential-thinking "Decision: Redux for large apps, Context for small" 8 8 false
86
- ```
79
+ Use when checkpoints repeat without reducing uncertainty.
87
80
 
88
- **When to use:**
89
- - Multiple valid approaches
90
- - Need to compare pros/cons
91
- - Uncertain best path
81
+ ~~~text
82
+ Thought 4/7 [META]: Two speculative fixes produced no new evidence. Pause edits and inspect the failing fixture plus call graph.
83
+ Thought 5/7 [VERIFICATION]: The fixture bypasses the helper both fixes targeted.
84
+ Thought 6/7 [REVISION of Thought 2]: Move the guard to the actual entry point and discard both speculative patches.
85
+ Thought 7/7 [FINAL]: Targeted and full validation pass with one smaller change.
86
+ ~~~
92
87
 
93
- ---
88
+ META changes the investigation method; it is not a decorative status.
94
89
 
95
- ### Pattern 4: Adaptive Depth
90
+ ## Completion Checklist
96
91
 
97
- **Use for:** Problems where scope isn't initially clear
92
+ Before FINAL, confirm:
98
93
 
99
- **Structure:**
100
- ```
101
- Initial estimate Discovery → Adjustment → Extended analysis
102
- (totalThoughts=3) (needsMore) (totalThoughts=6)
103
- ```
104
-
105
- **Example:**
106
- ```bash
107
- /sequential-thinking "Analyzing microservices migration" 1 3 true
108
- /sequential-thinking "Identifying services..." 2 3 true
109
- /sequential-thinking "This is more complex than expected - many dependencies" 3 3 true needsMoreThoughts=true
110
- # Auto-adjusts: totalThoughts=6
111
- /sequential-thinking "Mapping service boundaries" 4 6 true
112
- /sequential-thinking "Planning data migration strategy" 5 6 true
113
- /sequential-thinking "Conclusion with migration plan" 6 6 false
114
- ```
115
-
116
- **When to use:**
117
- - Uncertain problem complexity
118
- - Exploratory analysis
119
- - Open-ended questions
120
-
121
- ---
122
-
123
- ### Pattern 5: Hybrid (Revision + Branching)
124
-
125
- **Use for:** Complex problems requiring both correction and exploration
126
-
127
- **Structure:**
128
- ```
129
- Thought 1 → Thought 2 (revise 1) → Thought 3 (branch point)
130
- ├→ Branch A
131
- └→ Branch B → Synthesis
132
- ```
133
-
134
- **Example:**
135
- ```bash
136
- /sequential-thinking "Approach: Optimize with caching" 1 8 true
137
- /sequential-thinking "Actually, profiling shows DB is fast" 2 8 true isRevision=true revisesThought=1
138
- /sequential-thinking "Real bottleneck: API serialization" 3 8 true
139
-
140
- # Explore solutions
141
- /sequential-thinking "Option: Use MessagePack" 4 8 true branchFromThought=3 branchId="messagepack"
142
- /sequential-thinking "Option: Stream responses" 5 8 true branchFromThought=3 branchId="streaming"
143
- /sequential-thinking "Option: Optimize JSON" 6 8 true branchFromThought=3 branchId="json-opt"
144
-
145
- # Decide
146
- /sequential-thinking "Comparison: Streaming has best ROI" 7 8 true
147
- /sequential-thinking "Implementation plan: Use HTTP streaming" 8 8 false
148
- ```
149
-
150
- **When to use:**
151
- - Complex problems
152
- - Multiple uncertainties
153
- - Need both correction and comparison
154
-
155
- ---
156
-
157
- ## Advanced Patterns
158
-
159
- ### Pattern 6: Depth-First Branch Exploration
160
-
161
- **Structure:**
162
- ```
163
- Main → Branch A → Branch A.1 → Branch A.2
164
- └→ Branch A.1.x
165
- ```
166
-
167
- **Example:**
168
- ```bash
169
- /sequential-thinking "Root problem" 1 10 true
170
- /sequential-thinking "Exploring authentication" 2 10 true branchFromThought=1 branchId="auth"
171
- /sequential-thinking "JWT sub-option" 3 10 true branchFromThought=2 branchId="auth.jwt"
172
- /sequential-thinking "OAuth sub-option" 4 10 true branchFromThought=2 branchId="auth.oauth"
173
- /sequential-thinking "Back to main: Decision made" 5 10 false
174
- ```
175
-
176
- **When to use:**
177
- - Hierarchical problem breakdown
178
- - Nested decision trees
179
- - Deep exploration of one path
180
-
181
- ---
182
-
183
- ### Pattern 7: Breadth-First Branch Exploration
184
-
185
- **Structure:**
186
- ```
187
- Main → Branch A (shallow)
188
- → Branch B (shallow)
189
- → Branch C (shallow)
190
- → Synthesis
191
- ```
192
-
193
- **Example:**
194
- ```bash
195
- /sequential-thinking "Identify options" 1 7 true
196
- /sequential-thinking "Quick check: Option A" 2 7 true branchFromThought=1 branchId="a"
197
- /sequential-thinking "Quick check: Option B" 3 7 true branchFromThought=1 branchId="b"
198
- /sequential-thinking "Quick check: Option C" 4 7 true branchFromThought=1 branchId="c"
199
- /sequential-thinking "All explored, comparing..." 5 7 true
200
- /sequential-thinking "Option B best fits requirements" 6 7 true
201
- /sequential-thinking "Recommendation: Proceed with B" 7 7 false
202
- ```
203
-
204
- **When to use:**
205
- - Survey multiple options
206
- - Rapid comparison
207
- - Time-constrained analysis
208
-
209
- ---
210
-
211
- ### Pattern 8: Iterative Refinement
212
-
213
- **Structure:**
214
- ```
215
- Hypothesis → Test → Revise → Test → Revise → Validate
216
- ```
217
-
218
- **Example:**
219
- ```bash
220
- /sequential-thinking "Hypothesis: Algorithm is O(n²)" 1 8 true
221
- /sequential-thinking "Test: Small input works fine" 2 8 true
222
- /sequential-thinking "Test: Large input times out" 3 8 true
223
- /sequential-thinking "Revision: Actually O(n³) nested loops" 4 8 true isRevision=true revisesThought=1
224
- /sequential-thinking "Fix: Remove inner loop" 5 8 true
225
- /sequential-thinking "Test: Performance improved 10x" 6 8 true
226
- /sequential-thinking "Validation: Complexity now O(n)" 7 8 true
227
- /sequential-thinking "Confirmed: Problem solved" 8 8 false
228
- ```
229
-
230
- **When to use:**
231
- - Hypothesis testing
232
- - Performance optimization
233
- - Iterative debugging
234
-
235
- ---
236
-
237
- ## Integration Patterns
238
-
239
- ### Pattern 9: Sequential → ClearThought → Sequential
240
-
241
- **Hybrid workflow for comprehensive analysis:**
242
-
243
- ```bash
244
- # Phase 1: Explore with Sequential Thinking
245
- /sequential-thinking "Problem: Choose database" 1 3 true
246
- /sequential-thinking "Options: PostgreSQL vs MongoDB" 2 3 true
247
- /sequential-thinking "Need structured decision framework" 3 3 false
248
-
249
- # Phase 2: Analyze with ClearThought
250
- /clearthought decision_framework framework=decision_matrix PostgreSQL vs MongoDB
251
-
252
- # Phase 3: Synthesize with Sequential Thinking
253
- /sequential-thinking "Based on decision analysis: PostgreSQL wins" 4 5 true
254
- /sequential-thinking "Implementation plan: Setup PostgreSQL cluster" 5 5 false
255
- ```
256
-
257
- **When to use:**
258
- - Complex decisions
259
- - Need both exploration and structured analysis
260
- - Combining qualitative and quantitative reasoning
261
-
262
- ---
263
-
264
- ### Pattern 10: ClearThought → Sequential → ClearThought
265
-
266
- **Specialized → Exploration → Specialized:**
267
-
268
- ```bash
269
- # Phase 1: Initial analysis with ClearThought
270
- /clearthought statistical_reasoning mode=descriptive Analyze API response times: [120, 145, 203, ...]
271
-
272
- # Phase 2: Deep dive with Sequential Thinking
273
- /sequential-thinking "Stats show high variance - investigating..." 1 5 true
274
- /sequential-thinking "Hypothesis: Database connection pool issues" 2 5 true
275
- /sequential-thinking "Verified: Pool size is 5, need 20" 3 5 false
276
-
277
- # Phase 3: Optimization with ClearThought
278
- /clearthought optimization type=gradient_descent Optimize pool size vs latency
279
- ```
280
-
281
- **When to use:**
282
- - Data-driven problems
283
- - Need exploration after initial analysis
284
- - Optimization scenarios
285
-
286
- ---
287
-
288
- ## Anti-Patterns (Don't Do This)
289
-
290
- ### ❌ Anti-Pattern 1: Skipping Thought Numbers
291
-
292
- ```bash
293
- /sequential-thinking "Thought 1" 1 5
294
- /sequential-thinking "Thought 5" 5 5 # Skip 2,3,4
295
- ```
296
-
297
- **Why bad:** Breaks sequence integrity, confuses history tracking
298
-
299
- **Fix:** Use sequential numbers (1, 2, 3, 4, 5)
300
-
301
- ---
302
-
303
- ### ❌ Anti-Pattern 2: Premature Conclusion
304
-
305
- ```bash
306
- /sequential-thinking "Problem identified" 1 10 true
307
- /sequential-thinking "Conclusion: Fix it" 2 10 false # Too early!
308
- ```
309
-
310
- **Why bad:** Incomplete analysis, missing insights
311
-
312
- **Fix:** Use realistic `totalThoughts`, explore thoroughly
313
-
314
- ---
315
-
316
- ### ❌ Anti-Pattern 3: Orphan Branches
317
-
318
- ```bash
319
- /sequential-thinking "Main thought" 1 5
320
- /sequential-thinking "Branch A" branchFromThought=1 branchId="a"
321
- /sequential-thinking "Branch B" branchFromThought=1 branchId="b"
322
- /sequential-thinking "Conclusion" 4 5 nextThoughtNeeded=false
323
- # Never synthesized branches!
324
- ```
325
-
326
- **Why bad:** Wasted exploration, no synthesis
327
-
328
- **Fix:** Always synthesize/compare branches before concluding
329
-
330
- ---
331
-
332
- ### ❌ Anti-Pattern 4: Meaningless Revisions
333
-
334
- ```bash
335
- /sequential-thinking "Thought 1" 1 5
336
- /sequential-thinking "Revising for no reason" 2 5 isRevision=true revisesThought=1
337
- ```
338
-
339
- **Why bad:** Revision without new insight
340
-
341
- **Fix:** Only revise when new information contradicts previous thought
342
-
343
- ---
344
-
345
- ## Best Practices
346
-
347
- ### ✅ Do:
348
- 1. Start with realistic estimate (3-5 thoughts)
349
- 2. Revise when new insights contradict assumptions
350
- 3. Branch when multiple approaches merit exploration
351
- 4. Extend dynamically when complexity emerges
352
- 5. Synthesize branches before concluding
353
- 6. Set `nextThoughtNeeded=false` only when truly done
354
-
355
- ### ❌ Don't:
356
- 1. Skip thought numbers
357
- 2. Set unrealistic high totals initially
358
- 3. Create orphan branches (explore but don't synthesize)
359
- 4. Revise without clear reason
360
- 5. End prematurely
361
- 6. Exceed 100 thoughts (summarize instead)
362
-
363
- ---
364
-
365
- ## Pattern Selection Guide
366
-
367
- ```
368
- Start here: What's your problem?
369
-
370
- ├─ Clear steps known? → Pattern 1: Linear Sequence
371
-
372
- ├─ Assumptions might be wrong? → Pattern 2: Revision Chain
373
-
374
- ├─ Multiple approaches to compare? → Pattern 3: Branching
375
-
376
- ├─ Scope unclear? → Pattern 4: Adaptive Depth
377
-
378
- └─ Complex with unknowns? → Pattern 5: Hybrid
379
- ```
380
-
381
- ---
382
-
383
- ## Real-World Examples
384
-
385
- ### Example 1: System Architecture Decision
386
-
387
- **Problem:** "Should we use microservices or monolith?"
388
-
389
- **Pattern:** Branching Exploration (Pattern 3)
390
-
391
- **Flow:**
392
- 1. Problem statement
393
- 2. List criteria (scalability, complexity, team size)
394
- 3. Branch A: Analyze microservices
395
- 4. Branch B: Analyze monolith
396
- 5. Branch C: Analyze modular monolith
397
- 6. Compare branches
398
- 7. Decide based on criteria
399
- 8. Conclusion with recommendation
400
-
401
- ---
402
-
403
- ### Example 2: Bug Investigation
404
-
405
- **Problem:** "API randomly returns 500 errors"
406
-
407
- **Pattern:** Revision Chain (Pattern 2)
408
-
409
- **Flow:**
410
- 1. Hypothesis: Load balancer issue
411
- 2. Test: Check load balancer logs
412
- 3. Revision: Not load balancer - database connection timeouts
413
- 4. Hypothesis 2: Connection pool too small
414
- 5. Test: Increase pool size
415
- 6. Validation: Errors eliminated
416
- 7. Conclusion: Pool size was 5, needed 20
417
-
418
- ---
419
-
420
- ### Example 3: Feature Planning
421
-
422
- **Problem:** "Plan authentication feature implementation"
423
-
424
- **Pattern:** Linear Sequence (Pattern 1)
425
-
426
- **Flow:**
427
- 1. Requirements gathering
428
- 2. Technology selection (JWT vs OAuth)
429
- 3. Database schema design
430
- 4. API endpoint design
431
- 5. Security considerations
432
- 6. Testing strategy
433
- 7. Rollout plan
434
- 8. Documentation needs
435
-
436
- ---
437
-
438
- ### Example 4: Research Paper Analysis
439
-
440
- **Problem:** "Understand and critique research paper"
441
-
442
- **Pattern:** Adaptive Depth (Pattern 4)
443
-
444
- **Flow:**
445
- 1. Read abstract (estimate 5 thoughts)
446
- 2. Read methodology
447
- 3. Realize complexity → needsMoreThoughts (now 8)
448
- 4. Analyze results section
449
- 5. Statistical validation deep dive
450
- 6. Related work comparison
451
- 7. Critical evaluation
452
- 8. Summary and implications
453
-
454
- ---
455
-
456
- ## Workflow Integration
457
-
458
- ### With ClearThought Operations
459
-
460
- **Exploration → Analysis → Decision:**
461
-
462
- ```bash
463
- # 1. Sequential Thinking: Break down problem
464
- /sequential-thinking "What factors matter for database choice?" 1 3
465
-
466
- # 2. ClearThought: Structured decision
467
- /clearthought decision_framework framework=decision_matrix Options: PostgreSQL, MongoDB, DynamoDB
468
-
469
- # 3. Sequential Thinking: Synthesize
470
- /sequential-thinking "Based on analysis, PostgreSQL best for ACID requirements" 4 5 false
471
- ```
472
-
473
- ---
474
-
475
- ### With Multiple Tools
476
-
477
- **Complex workflow:**
478
-
479
- ```bash
480
- # 1. Sequential: Initial exploration
481
- /sequential-thinking "Performance issue analysis" 1 5
482
-
483
- # 2. ClearThought: Statistical analysis
484
- /clearthought statistical_reasoning mode=descriptive data=[response_times]
485
-
486
- # 3. Sequential: Interpret statistics
487
- /sequential-thinking "Stats show bimodal distribution..." 6 10
488
-
489
- # 4. ClearThought: Debug approach
490
- /clearthought debugging_approach binary_search Isolate slow requests
491
-
492
- # 5. Sequential: Conclusion
493
- /sequential-thinking "Root cause identified: Uncached queries" 10 10 false
494
- ```
495
-
496
- ---
497
-
498
- ## Pattern Templates
499
-
500
- ### Template 1: Problem Breakdown
501
-
502
- ```
503
- 1. Problem statement (what, why, who affected)
504
- 2. Context and constraints
505
- 3. Requirements gathering
506
- 4. Options identification
507
- 5. Analysis of each option
508
- 6. Comparison and ranking
509
- 7. Decision with rationale
510
- 8. Implementation plan
511
- ```
512
-
513
- ---
514
-
515
- ### Template 2: Root Cause Analysis
516
-
517
- ```
518
- 1. Symptom description
519
- 2. Data gathering
520
- 3. Hypothesis generation
521
- 4. Test hypothesis
522
- 5. [Revision if wrong] New hypothesis
523
- 6. [Repeat 4-5 until found]
524
- 7. Root cause identified
525
- 8. Solution proposed and validated
526
- ```
527
-
528
- ---
529
-
530
- ### Template 3: Design Exploration
531
-
532
- ```
533
- 1. Design goals and constraints
534
- 2. Brainstorm approaches
535
- 3. Branch A: First approach detailed
536
- 4. Branch B: Second approach detailed
537
- 5. Branch C: Third approach detailed
538
- 6. Evaluation criteria
539
- 7. Comparison across branches
540
- 8. Recommended design with justification
541
- ```
542
-
543
- ---
544
-
545
- ### Template 4: Research Synthesis
546
-
547
- ```
548
- 1. Topic and research question
549
- 2. Key papers/sources identified
550
- 3. Summary of source 1
551
- 4. Summary of source 2
552
- 5. Summary of source 3
553
- 6. Common themes across sources
554
- 7. Contradictions and debates
555
- 8. Synthesis and conclusions
556
- ```
557
-
558
- ---
559
-
560
- ## Thought Progression Strategies
561
-
562
- ### Strategy A: Start Small, Grow Organically
563
-
564
- ```
565
- Initial: totalThoughts=3
566
- Reality: Grows to 5, then 8, then 12 as complexity emerges
567
- ```
568
-
569
- **Benefits:** Flexible, responsive to problem complexity
570
-
571
- ---
572
-
573
- ### Strategy B: Conservative Estimate
574
-
575
- ```
576
- Initial: totalThoughts=10
577
- Reality: Finish at thought 7, extrathoughts unused
578
- ```
579
-
580
- **Benefits:** Room for exploration, no premature conclusions
581
-
582
- ---
583
-
584
- ### Strategy C: Fixed Depth
585
-
586
- ```
587
- Initial: totalThoughts=8 (fixed)
588
- Reality: Exactly 8 thoughts, no more, no less
589
- ```
590
-
591
- **Benefits:** Structured, time-boxed, disciplined
592
-
593
- ---
594
-
595
- ## Debugging Patterns
596
-
597
- ### Pattern: Binary Search with Revisions
598
-
599
- ```bash
600
- /sequential-thinking "Bug: API fails on large requests" 1 10 true
601
- /sequential-thinking "Hypothesis: Request size limit" 2 10 true
602
- /sequential-thinking "Test: Small request (100 items) works" 3 10 true
603
- /sequential-thinking "Test: Large request (10k items) fails" 4 10 true
604
- /sequential-thinking "Test: Medium (1k items) fails" 5 10 true
605
- /sequential-thinking "Revision: Not size, but timeout" 6 10 true isRevision=true revisesThought=2
606
- /sequential-thinking "Test: Increase timeout" 7 10 true
607
- /sequential-thinking "Validation: Works with 60s timeout" 8 10 true
608
- /sequential-thinking "Root cause: Default 30s too short" 9 10 true
609
- /sequential-thinking "Solution: Set timeout to 60s" 10 10 false
610
- ```
611
-
612
- ---
613
-
614
- ## Optimization Patterns
615
-
616
- ### Pattern: Explore → Measure → Optimize
617
-
618
- ```bash
619
- /sequential-thinking "Performance bottleneck identification" 1 8 true
620
- /sequential-thinking "Profiling shows database queries take 80% time" 2 8 true
621
-
622
- # Branch: Different optimization approaches
623
- /sequential-thinking "Approach: Add indexes" 3 8 true branchFromThought=2 branchId="indexes"
624
- /sequential-thinking "Approach: Query optimization" 4 8 true branchFromThought=2 branchId="queries"
625
- /sequential-thinking "Approach: Caching layer" 5 8 true branchFromThought=2 branchId="cache"
626
-
627
- /sequential-thinking "Measuring each: Indexes give 10x improvement" 6 8 true
628
- /sequential-thinking "Decision: Indexes first, cache later" 7 8 true
629
- /sequential-thinking "Implementation plan for indexes" 8 8 false
630
- ```
631
-
632
- ---
633
-
634
- ## When to Stop
635
-
636
- ### Stop When:
637
- ✅ Problem fully analyzed
638
- ✅ All branches explored and synthesized
639
- ✅ Solution identified and validated
640
- ✅ No more insights to gain
641
- ✅ Diminishing returns on additional thoughts
642
-
643
- ### Don't Stop When:
644
- ❌ Approaching thought estimate (keep going if needed)
645
- ❌ Branches not synthesized
646
- ❌ Solution untested
647
- ❌ Uncertainty remains
648
- ❌ Stakeholder concerns unaddressed
649
-
650
- ---
651
-
652
- ## Pattern Metrics
653
-
654
- | Pattern | Avg Thoughts | Time Estimate | Complexity |
655
- |---------|-------------|---------------|------------|
656
- | Linear Sequence | 5-8 | 5-10 min | Low |
657
- | Revision Chain | 8-12 | 10-15 min | Medium |
658
- | Branching | 10-15 | 15-25 min | High |
659
- | Adaptive Depth | 5-20 | Variable | Medium |
660
- | Hybrid | 12-20 | 20-30 min | High |
661
-
662
- ---
663
-
664
- **For complete examples, see:** [../examples/](../examples/)
665
- **For parameters, see:** [parameters.md](parameters.md)
666
- **For output format, see:** [output-schema.md](output-schema.md)
94
+ - the original completion criterion is met;
95
+ - every hypothesis is confirmed or rejected by observed evidence;
96
+ - every branch has converged;
97
+ - revision fallout is reassessed;
98
+ - critical uncertainty has an owner or resolution method;
99
+ - the next action and validation are concrete.