@hivehub/rulebook 4.1.0 → 4.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (334) hide show
  1. package/.claude/commands/continue.md +33 -33
  2. package/.claude/commands/ralph-config.md +112 -112
  3. package/.claude/commands/ralph-history.md +110 -110
  4. package/.claude/commands/ralph-init.md +72 -72
  5. package/.claude/commands/ralph-pause-resume.md +105 -105
  6. package/.claude/commands/ralph-run.md +101 -101
  7. package/.claude/commands/ralph-status.md +76 -76
  8. package/.claude/commands/rulebook-memory-save.md +48 -48
  9. package/.claude/commands/rulebook-memory-search.md +47 -47
  10. package/.claude/commands/rulebook-task-apply.md +67 -67
  11. package/.claude/commands/rulebook-task-archive.md +70 -70
  12. package/.claude/commands/rulebook-task-create.md +93 -93
  13. package/.claude/commands/rulebook-task-list.md +42 -42
  14. package/.claude/commands/rulebook-task-show.md +52 -52
  15. package/.claude/commands/rulebook-task-validate.md +53 -53
  16. package/.claude-plugin/marketplace.json +28 -28
  17. package/.claude-plugin/plugin.json +8 -8
  18. package/dist/cli/commands.d.ts +18 -6
  19. package/dist/cli/commands.d.ts.map +1 -1
  20. package/dist/cli/commands.js +717 -406
  21. package/dist/cli/commands.js.map +1 -1
  22. package/dist/core/claude-mcp.d.ts +4 -2
  23. package/dist/core/claude-mcp.d.ts.map +1 -1
  24. package/dist/core/claude-mcp.js +14 -9
  25. package/dist/core/claude-mcp.js.map +1 -1
  26. package/dist/core/generator.d.ts.map +1 -1
  27. package/dist/core/generator.js +13 -0
  28. package/dist/core/generator.js.map +1 -1
  29. package/dist/core/indexer/background-indexer.d.ts.map +1 -1
  30. package/dist/core/indexer/background-indexer.js +26 -5
  31. package/dist/core/indexer/background-indexer.js.map +1 -1
  32. package/dist/core/indexer/file-parser.d.ts.map +1 -1
  33. package/dist/core/indexer/file-parser.js +1 -1
  34. package/dist/core/indexer/file-parser.js.map +1 -1
  35. package/dist/core/indexer/indexer-types.d.ts.map +1 -1
  36. package/dist/core/workspace/legacy-migrator.d.ts +29 -0
  37. package/dist/core/workspace/legacy-migrator.d.ts.map +1 -0
  38. package/dist/core/workspace/legacy-migrator.js +142 -0
  39. package/dist/core/workspace/legacy-migrator.js.map +1 -0
  40. package/dist/core/workspace/project-worker.d.ts +49 -0
  41. package/dist/core/workspace/project-worker.d.ts.map +1 -0
  42. package/dist/core/workspace/project-worker.js +108 -0
  43. package/dist/core/workspace/project-worker.js.map +1 -0
  44. package/dist/core/workspace/workspace-manager.d.ts +90 -0
  45. package/dist/core/workspace/workspace-manager.d.ts.map +1 -0
  46. package/dist/core/workspace/workspace-manager.js +337 -0
  47. package/dist/core/workspace/workspace-manager.js.map +1 -0
  48. package/dist/core/workspace/workspace-types.d.ts +37 -0
  49. package/dist/core/workspace/workspace-types.d.ts.map +1 -0
  50. package/dist/core/workspace/workspace-types.js +8 -0
  51. package/dist/core/workspace/workspace-types.js.map +1 -0
  52. package/dist/index.js +43 -7
  53. package/dist/index.js.map +1 -1
  54. package/dist/mcp/rulebook-server.d.ts.map +1 -1
  55. package/dist/mcp/rulebook-server.js +367 -100
  56. package/dist/mcp/rulebook-server.js.map +1 -1
  57. package/dist/memory/memory-manager.js +2 -2
  58. package/dist/memory/memory-manager.js.map +1 -1
  59. package/dist/memory/memory-search.js.map +1 -1
  60. package/dist/memory/memory-store.d.ts.map +1 -1
  61. package/dist/memory/memory-store.js +1 -1
  62. package/dist/memory/memory-store.js.map +1 -1
  63. package/dist/types.d.ts +1 -0
  64. package/dist/types.d.ts.map +1 -1
  65. package/package.json +22 -21
  66. package/templates/agents/implementer.md +35 -35
  67. package/templates/agents/researcher.md +34 -34
  68. package/templates/agents/team-lead.md +34 -34
  69. package/templates/agents/tester.md +42 -42
  70. package/templates/ci/rulebook-review.yml +26 -26
  71. package/templates/cli/AIDER.md +49 -49
  72. package/templates/cli/AMAZON_Q.md +25 -25
  73. package/templates/cli/AUGGIE.md +32 -32
  74. package/templates/cli/CLAUDE.md +117 -117
  75. package/templates/cli/CLINE.md +99 -99
  76. package/templates/cli/CODEBUDDY.md +20 -20
  77. package/templates/cli/CODEIUM.md +20 -20
  78. package/templates/cli/CODEX.md +21 -21
  79. package/templates/cli/CONTINUE.md +34 -34
  80. package/templates/cli/CURSOR_CLI.md +62 -62
  81. package/templates/cli/FACTORY.md +18 -18
  82. package/templates/cli/GEMINI.md +35 -35
  83. package/templates/cli/KILOCODE.md +18 -18
  84. package/templates/cli/OPENCODE.md +18 -18
  85. package/templates/cli/_GENERIC_TEMPLATE.md +29 -29
  86. package/templates/commands/rulebook-memory-save.md +48 -48
  87. package/templates/commands/rulebook-memory-search.md +47 -47
  88. package/templates/commands/rulebook-task-apply.md +67 -67
  89. package/templates/commands/rulebook-task-archive.md +94 -94
  90. package/templates/commands/rulebook-task-create.md +93 -93
  91. package/templates/commands/rulebook-task-list.md +42 -42
  92. package/templates/commands/rulebook-task-show.md +52 -52
  93. package/templates/commands/rulebook-task-validate.md +53 -53
  94. package/templates/core/AGENTS_LEAN.md +25 -25
  95. package/templates/core/AGENTS_OVERRIDE.md +16 -16
  96. package/templates/core/AGENT_AUTOMATION.md +288 -288
  97. package/templates/core/DAG.md +304 -304
  98. package/templates/core/DOCUMENTATION_RULES.md +36 -36
  99. package/templates/core/MULTI_AGENT.md +74 -74
  100. package/templates/core/PLANS.md +28 -28
  101. package/templates/core/QUALITY_ENFORCEMENT.md +68 -68
  102. package/templates/core/RALPH.md +471 -471
  103. package/templates/core/RULEBOOK.md +1935 -1935
  104. package/templates/core/WORKSPACE.md +69 -0
  105. package/templates/frameworks/ANGULAR.md +36 -36
  106. package/templates/frameworks/DJANGO.md +83 -83
  107. package/templates/frameworks/ELECTRON.md +147 -147
  108. package/templates/frameworks/FLASK.md +38 -38
  109. package/templates/frameworks/FLUTTER.md +55 -55
  110. package/templates/frameworks/JQUERY.md +32 -32
  111. package/templates/frameworks/LARAVEL.md +38 -38
  112. package/templates/frameworks/NESTJS.md +43 -43
  113. package/templates/frameworks/NEXTJS.md +127 -127
  114. package/templates/frameworks/NUXT.md +40 -40
  115. package/templates/frameworks/RAILS.md +66 -66
  116. package/templates/frameworks/REACT.md +38 -38
  117. package/templates/frameworks/REACT_NATIVE.md +47 -47
  118. package/templates/frameworks/SPRING.md +39 -39
  119. package/templates/frameworks/SYMFONY.md +36 -36
  120. package/templates/frameworks/VUE.md +36 -36
  121. package/templates/frameworks/ZEND.md +35 -35
  122. package/templates/git/CI_CD_PATTERNS.md +661 -661
  123. package/templates/git/GITHUB_ACTIONS.md +728 -728
  124. package/templates/git/GITLAB_CI.md +730 -730
  125. package/templates/git/GIT_WORKFLOW.md +1157 -1157
  126. package/templates/git/SECRETS_MANAGEMENT.md +585 -585
  127. package/templates/hooks/COMMIT_MSG.md +530 -530
  128. package/templates/hooks/POST_CHECKOUT.md +546 -546
  129. package/templates/hooks/PREPARE_COMMIT_MSG.md +619 -619
  130. package/templates/hooks/PRE_COMMIT.md +414 -414
  131. package/templates/hooks/PRE_PUSH.md +601 -601
  132. package/templates/ides/CONTINUE_RULES.md +16 -16
  133. package/templates/ides/COPILOT.md +37 -37
  134. package/templates/ides/COPILOT_INSTRUCTIONS.md +23 -23
  135. package/templates/ides/CURSOR.md +43 -43
  136. package/templates/ides/GEMINI_RULES.md +17 -17
  137. package/templates/ides/JETBRAINS_AI.md +35 -35
  138. package/templates/ides/REPLIT.md +36 -36
  139. package/templates/ides/TABNINE.md +29 -29
  140. package/templates/ides/VSCODE.md +40 -40
  141. package/templates/ides/WINDSURF.md +36 -36
  142. package/templates/ides/WINDSURF_RULES.md +14 -14
  143. package/templates/ides/ZED.md +32 -32
  144. package/templates/ides/cursor-mdc/go.mdc +24 -24
  145. package/templates/ides/cursor-mdc/python.mdc +24 -24
  146. package/templates/ides/cursor-mdc/quality.mdc +25 -25
  147. package/templates/ides/cursor-mdc/ralph.mdc +39 -39
  148. package/templates/ides/cursor-mdc/rulebook.mdc +38 -38
  149. package/templates/ides/cursor-mdc/rust.mdc +24 -24
  150. package/templates/ides/cursor-mdc/typescript.mdc +25 -25
  151. package/templates/languages/C.md +333 -333
  152. package/templates/languages/CPP.md +743 -743
  153. package/templates/languages/CSHARP.md +417 -417
  154. package/templates/languages/ELIXIR.md +454 -454
  155. package/templates/languages/ERLANG.md +361 -361
  156. package/templates/languages/GO.md +645 -645
  157. package/templates/languages/HASKELL.md +177 -177
  158. package/templates/languages/JAVA.md +607 -607
  159. package/templates/languages/JAVASCRIPT.md +631 -631
  160. package/templates/languages/JULIA.md +97 -97
  161. package/templates/languages/KOTLIN.md +511 -511
  162. package/templates/languages/LISP.md +100 -100
  163. package/templates/languages/LUA.md +74 -74
  164. package/templates/languages/OBJECTIVEC.md +90 -90
  165. package/templates/languages/PHP.md +416 -416
  166. package/templates/languages/PYTHON.md +682 -682
  167. package/templates/languages/RUBY.md +421 -421
  168. package/templates/languages/RUST.md +477 -477
  169. package/templates/languages/SAS.md +73 -73
  170. package/templates/languages/SCALA.md +348 -348
  171. package/templates/languages/SOLIDITY.md +580 -580
  172. package/templates/languages/SQL.md +137 -137
  173. package/templates/languages/SWIFT.md +466 -466
  174. package/templates/languages/TYPESCRIPT.md +591 -591
  175. package/templates/languages/ZIG.md +265 -265
  176. package/templates/modules/ATLASSIAN.md +255 -255
  177. package/templates/modules/CONTEXT7.md +54 -54
  178. package/templates/modules/FIGMA.md +267 -267
  179. package/templates/modules/GITHUB_MCP.md +64 -64
  180. package/templates/modules/GRAFANA.md +328 -328
  181. package/templates/modules/MEMORY.md +126 -126
  182. package/templates/modules/NOTION.md +247 -247
  183. package/templates/modules/PLAYWRIGHT.md +90 -90
  184. package/templates/modules/RULEBOOK_MCP.md +156 -156
  185. package/templates/modules/SERENA.md +337 -337
  186. package/templates/modules/SUPABASE.md +223 -223
  187. package/templates/modules/SYNAP.md +69 -69
  188. package/templates/modules/VECTORIZER.md +63 -63
  189. package/templates/modules/sequential-thinking.md +42 -42
  190. package/templates/ralph/ralph-history.bat +4 -4
  191. package/templates/ralph/ralph-history.sh +5 -5
  192. package/templates/ralph/ralph-init.bat +5 -5
  193. package/templates/ralph/ralph-init.sh +5 -5
  194. package/templates/ralph/ralph-pause.bat +5 -5
  195. package/templates/ralph/ralph-pause.sh +5 -5
  196. package/templates/ralph/ralph-run.bat +5 -5
  197. package/templates/ralph/ralph-run.sh +5 -5
  198. package/templates/ralph/ralph-status.bat +4 -4
  199. package/templates/ralph/ralph-status.sh +5 -5
  200. package/templates/services/AZURE_BLOB.md +184 -184
  201. package/templates/services/CASSANDRA.md +239 -239
  202. package/templates/services/DATADOG.md +26 -26
  203. package/templates/services/DOCKER.md +124 -124
  204. package/templates/services/DOCKER_COMPOSE.md +168 -168
  205. package/templates/services/DYNAMODB.md +308 -308
  206. package/templates/services/ELASTICSEARCH.md +347 -347
  207. package/templates/services/GCS.md +178 -178
  208. package/templates/services/HELM.md +194 -194
  209. package/templates/services/INFLUXDB.md +265 -265
  210. package/templates/services/KAFKA.md +341 -341
  211. package/templates/services/KUBERNETES.md +208 -208
  212. package/templates/services/MARIADB.md +183 -183
  213. package/templates/services/MEMCACHED.md +242 -242
  214. package/templates/services/MINIO.md +201 -201
  215. package/templates/services/MONGODB.md +268 -268
  216. package/templates/services/MYSQL.md +358 -358
  217. package/templates/services/NEO4J.md +247 -247
  218. package/templates/services/OPENTELEMETRY.md +25 -25
  219. package/templates/services/ORACLE.md +290 -290
  220. package/templates/services/PINO.md +24 -24
  221. package/templates/services/POSTGRESQL.md +326 -326
  222. package/templates/services/PROMETHEUS.md +33 -33
  223. package/templates/services/RABBITMQ.md +286 -286
  224. package/templates/services/REDIS.md +292 -292
  225. package/templates/services/S3.md +298 -298
  226. package/templates/services/SENTRY.md +23 -23
  227. package/templates/services/SQLITE.md +294 -294
  228. package/templates/services/SQLSERVER.md +294 -294
  229. package/templates/services/WINSTON.md +30 -30
  230. package/templates/skills/cli/aider/SKILL.md +59 -59
  231. package/templates/skills/cli/amazon-q/SKILL.md +35 -35
  232. package/templates/skills/cli/auggie/SKILL.md +42 -42
  233. package/templates/skills/cli/claude/SKILL.md +42 -42
  234. package/templates/skills/cli/cline/SKILL.md +42 -42
  235. package/templates/skills/cli/codebuddy/SKILL.md +30 -30
  236. package/templates/skills/cli/codeium/SKILL.md +30 -30
  237. package/templates/skills/cli/codex/SKILL.md +31 -31
  238. package/templates/skills/cli/continue/SKILL.md +44 -44
  239. package/templates/skills/cli/cursor-cli/SKILL.md +38 -38
  240. package/templates/skills/cli/factory/SKILL.md +28 -28
  241. package/templates/skills/cli/gemini/SKILL.md +45 -45
  242. package/templates/skills/cli/kilocode/SKILL.md +28 -28
  243. package/templates/skills/cli/opencode/SKILL.md +28 -28
  244. package/templates/skills/core/agent-automation/SKILL.md +194 -194
  245. package/templates/skills/core/dag/SKILL.md +314 -314
  246. package/templates/skills/core/documentation-rules/SKILL.md +46 -46
  247. package/templates/skills/core/quality-enforcement/SKILL.md +78 -78
  248. package/templates/skills/core/rulebook/SKILL.md +176 -176
  249. package/templates/skills/frameworks/angular/SKILL.md +46 -46
  250. package/templates/skills/frameworks/django/SKILL.md +93 -93
  251. package/templates/skills/frameworks/electron/SKILL.md +157 -157
  252. package/templates/skills/frameworks/flask/SKILL.md +48 -48
  253. package/templates/skills/frameworks/flutter/SKILL.md +65 -65
  254. package/templates/skills/frameworks/jquery/SKILL.md +42 -42
  255. package/templates/skills/frameworks/laravel/SKILL.md +48 -48
  256. package/templates/skills/frameworks/nestjs/SKILL.md +53 -53
  257. package/templates/skills/frameworks/nextjs/SKILL.md +137 -137
  258. package/templates/skills/frameworks/nuxt/SKILL.md +50 -50
  259. package/templates/skills/frameworks/rails/SKILL.md +76 -76
  260. package/templates/skills/frameworks/react/SKILL.md +48 -48
  261. package/templates/skills/frameworks/react-native/SKILL.md +57 -57
  262. package/templates/skills/frameworks/spring/SKILL.md +49 -49
  263. package/templates/skills/frameworks/symfony/SKILL.md +46 -46
  264. package/templates/skills/frameworks/vue/SKILL.md +46 -46
  265. package/templates/skills/frameworks/zend/SKILL.md +45 -45
  266. package/templates/skills/ides/copilot/SKILL.md +47 -47
  267. package/templates/skills/ides/cursor/SKILL.md +53 -53
  268. package/templates/skills/ides/jetbrains-ai/SKILL.md +45 -45
  269. package/templates/skills/ides/replit/SKILL.md +46 -46
  270. package/templates/skills/ides/tabnine/SKILL.md +39 -39
  271. package/templates/skills/ides/vscode/SKILL.md +50 -50
  272. package/templates/skills/ides/windsurf/SKILL.md +46 -46
  273. package/templates/skills/ides/zed/SKILL.md +42 -42
  274. package/templates/skills/languages/c/SKILL.md +343 -343
  275. package/templates/skills/languages/cpp/SKILL.md +753 -753
  276. package/templates/skills/languages/csharp/SKILL.md +427 -427
  277. package/templates/skills/languages/elixir/SKILL.md +464 -464
  278. package/templates/skills/languages/erlang/SKILL.md +371 -371
  279. package/templates/skills/languages/go/SKILL.md +655 -655
  280. package/templates/skills/languages/haskell/SKILL.md +187 -187
  281. package/templates/skills/languages/java/SKILL.md +617 -617
  282. package/templates/skills/languages/javascript/SKILL.md +641 -641
  283. package/templates/skills/languages/julia/SKILL.md +107 -107
  284. package/templates/skills/languages/kotlin/SKILL.md +521 -521
  285. package/templates/skills/languages/lisp/SKILL.md +110 -110
  286. package/templates/skills/languages/lua/SKILL.md +84 -84
  287. package/templates/skills/languages/objectivec/SKILL.md +100 -100
  288. package/templates/skills/languages/php/SKILL.md +426 -426
  289. package/templates/skills/languages/python/SKILL.md +692 -692
  290. package/templates/skills/languages/ruby/SKILL.md +431 -431
  291. package/templates/skills/languages/rust/SKILL.md +487 -487
  292. package/templates/skills/languages/sas/SKILL.md +83 -83
  293. package/templates/skills/languages/scala/SKILL.md +358 -358
  294. package/templates/skills/languages/solidity/SKILL.md +590 -590
  295. package/templates/skills/languages/sql/SKILL.md +147 -147
  296. package/templates/skills/languages/swift/SKILL.md +476 -476
  297. package/templates/skills/languages/typescript/SKILL.md +302 -302
  298. package/templates/skills/languages/zig/SKILL.md +275 -275
  299. package/templates/skills/modules/atlassian/SKILL.md +265 -265
  300. package/templates/skills/modules/context7/SKILL.md +64 -64
  301. package/templates/skills/modules/figma/SKILL.md +277 -277
  302. package/templates/skills/modules/github-mcp/SKILL.md +74 -74
  303. package/templates/skills/modules/grafana/SKILL.md +338 -338
  304. package/templates/skills/modules/memory/SKILL.md +73 -73
  305. package/templates/skills/modules/notion/SKILL.md +257 -257
  306. package/templates/skills/modules/playwright/SKILL.md +100 -100
  307. package/templates/skills/modules/rulebook-mcp/SKILL.md +166 -166
  308. package/templates/skills/modules/serena/SKILL.md +347 -347
  309. package/templates/skills/modules/supabase/SKILL.md +233 -233
  310. package/templates/skills/modules/synap/SKILL.md +79 -79
  311. package/templates/skills/modules/vectorizer/SKILL.md +73 -73
  312. package/templates/skills/services/azure-blob/SKILL.md +194 -194
  313. package/templates/skills/services/cassandra/SKILL.md +249 -249
  314. package/templates/skills/services/dynamodb/SKILL.md +318 -318
  315. package/templates/skills/services/elasticsearch/SKILL.md +357 -357
  316. package/templates/skills/services/gcs/SKILL.md +188 -188
  317. package/templates/skills/services/influxdb/SKILL.md +275 -275
  318. package/templates/skills/services/kafka/SKILL.md +351 -351
  319. package/templates/skills/services/mariadb/SKILL.md +193 -193
  320. package/templates/skills/services/memcached/SKILL.md +252 -252
  321. package/templates/skills/services/minio/SKILL.md +211 -211
  322. package/templates/skills/services/mongodb/SKILL.md +278 -278
  323. package/templates/skills/services/mysql/SKILL.md +368 -368
  324. package/templates/skills/services/neo4j/SKILL.md +257 -257
  325. package/templates/skills/services/oracle/SKILL.md +300 -300
  326. package/templates/skills/services/postgresql/SKILL.md +336 -336
  327. package/templates/skills/services/rabbitmq/SKILL.md +296 -296
  328. package/templates/skills/services/redis/SKILL.md +302 -302
  329. package/templates/skills/services/s3/SKILL.md +308 -308
  330. package/templates/skills/services/sqlite/SKILL.md +304 -304
  331. package/templates/skills/services/sqlserver/SKILL.md +304 -304
  332. package/templates/skills/workflows/ralph/SKILL.md +309 -309
  333. package/templates/skills/workflows/ralph/install.sh +87 -87
  334. package/templates/skills/workflows/ralph/manifest.json +158 -158
@@ -1,63 +1,63 @@
1
- <!-- VECTORIZER:START -->
2
- # Vectorizer Instructions
3
-
4
- **CRITICAL**: Use MCP Vectorizer as primary data source for project information instead of file reading.
5
-
6
- ## Core Functions
7
-
8
- ### Search
9
- ```
10
- mcp_vectorizer_search - Multiple strategies:
11
- - intelligent: AI-powered with query expansion
12
- - semantic: Advanced with reranking
13
- - contextual: Context-aware with filtering
14
- - multi_collection: Cross-project search
15
- - batch: Parallel queries
16
- - by_file_type: Filter by extension (.rs, .ts, .py)
17
- ```
18
-
19
- ### File Operations
20
- ```
21
- get_content - Retrieve file without disk I/O
22
- list_files - List indexed files with metadata
23
- get_summary - File summaries (extractive/structural)
24
- get_chunks - Progressive reading of large files
25
- get_outline - Project structure overview
26
- get_related - Find semantically related files
27
- ```
28
-
29
- ### Discovery
30
- ```
31
- full_pipeline - Complete discovery with scoring
32
- broad_discovery - Multi-query with deduplication
33
- semantic_focus - Deep semantic search
34
- expand_queries - Generate query variations
35
- ```
36
-
37
- ## When to Use
38
-
39
- | Task | Tool |
40
- |------|------|
41
- | Explore unfamiliar code | intelligent search |
42
- | Read file | get_content |
43
- | Understand structure | get_outline |
44
- | Find related files | get_related |
45
- | Read large file | get_chunks |
46
- | Complex question | full_pipeline |
47
-
48
- ## Best Practices
49
-
50
- ✅ **DO:**
51
- - Start with intelligent search for exploration
52
- - Use file_operations to avoid disk I/O
53
- - Batch queries for related items
54
- - Set similarity thresholds (0.6-0.8)
55
- - Use specific collections when known
56
-
57
- ❌ **DON'T:**
58
- - Read files from disk when available in vectorizer
59
- - Use sequential searches (batch instead)
60
- - Skip similarity thresholds
61
- - Search entire codebase when collection is known
62
-
63
- <!-- VECTORIZER:END -->
1
+ <!-- VECTORIZER:START -->
2
+ # Vectorizer Instructions
3
+
4
+ **CRITICAL**: Use MCP Vectorizer as primary data source for project information instead of file reading.
5
+
6
+ ## Core Functions
7
+
8
+ ### Search
9
+ ```
10
+ mcp_vectorizer_search - Multiple strategies:
11
+ - intelligent: AI-powered with query expansion
12
+ - semantic: Advanced with reranking
13
+ - contextual: Context-aware with filtering
14
+ - multi_collection: Cross-project search
15
+ - batch: Parallel queries
16
+ - by_file_type: Filter by extension (.rs, .ts, .py)
17
+ ```
18
+
19
+ ### File Operations
20
+ ```
21
+ get_content - Retrieve file without disk I/O
22
+ list_files - List indexed files with metadata
23
+ get_summary - File summaries (extractive/structural)
24
+ get_chunks - Progressive reading of large files
25
+ get_outline - Project structure overview
26
+ get_related - Find semantically related files
27
+ ```
28
+
29
+ ### Discovery
30
+ ```
31
+ full_pipeline - Complete discovery with scoring
32
+ broad_discovery - Multi-query with deduplication
33
+ semantic_focus - Deep semantic search
34
+ expand_queries - Generate query variations
35
+ ```
36
+
37
+ ## When to Use
38
+
39
+ | Task | Tool |
40
+ |------|------|
41
+ | Explore unfamiliar code | intelligent search |
42
+ | Read file | get_content |
43
+ | Understand structure | get_outline |
44
+ | Find related files | get_related |
45
+ | Read large file | get_chunks |
46
+ | Complex question | full_pipeline |
47
+
48
+ ## Best Practices
49
+
50
+ ✅ **DO:**
51
+ - Start with intelligent search for exploration
52
+ - Use file_operations to avoid disk I/O
53
+ - Batch queries for related items
54
+ - Set similarity thresholds (0.6-0.8)
55
+ - Use specific collections when known
56
+
57
+ ❌ **DON'T:**
58
+ - Read files from disk when available in vectorizer
59
+ - Use sequential searches (batch instead)
60
+ - Skip similarity thresholds
61
+ - Search entire codebase when collection is known
62
+
63
+ <!-- VECTORIZER:END -->
@@ -1,42 +1,42 @@
1
- <!-- SEQUENTIAL_THINKING:START -->
2
- # Sequential Thinking MCP
3
-
4
- Sequential thinking MCP enables structured, step-by-step problem solving for complex tasks.
5
-
6
- ## When to Use
7
-
8
- Use sequential thinking for:
9
- - Complex architectural decisions requiring multiple trade-off analyses
10
- - Debugging hard-to-reproduce issues
11
- - Planning multi-step implementations before writing code
12
- - Tasks where mistakes are costly (data migrations, API changes)
13
-
14
- ## Usage Pattern
15
-
16
- ```
17
- mcp__sequential-thinking__sequentialthinking
18
- ```
19
-
20
- Call with a thought/problem to explore it step by step before committing to an implementation.
21
-
22
- ## Integration
23
-
24
- When sequential thinking MCP is available:
25
- 1. Start complex tasks with a thinking step to plan the approach
26
- 2. Use it to validate assumptions before writing code
27
- 3. Record key decisions from the thinking process in task spec files
28
-
29
- ## Install (if not configured)
30
-
31
- ```bash
32
- # Add to .mcp.json
33
- {
34
- "mcpServers": {
35
- "sequential-thinking": {
36
- "command": "npx",
37
- "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
38
- }
39
- }
40
- }
41
- ```
42
- <!-- SEQUENTIAL_THINKING:END -->
1
+ <!-- SEQUENTIAL_THINKING:START -->
2
+ # Sequential Thinking MCP
3
+
4
+ Sequential thinking MCP enables structured, step-by-step problem solving for complex tasks.
5
+
6
+ ## When to Use
7
+
8
+ Use sequential thinking for:
9
+ - Complex architectural decisions requiring multiple trade-off analyses
10
+ - Debugging hard-to-reproduce issues
11
+ - Planning multi-step implementations before writing code
12
+ - Tasks where mistakes are costly (data migrations, API changes)
13
+
14
+ ## Usage Pattern
15
+
16
+ ```
17
+ mcp__sequential-thinking__sequentialthinking
18
+ ```
19
+
20
+ Call with a thought/problem to explore it step by step before committing to an implementation.
21
+
22
+ ## Integration
23
+
24
+ When sequential thinking MCP is available:
25
+ 1. Start complex tasks with a thinking step to plan the approach
26
+ 2. Use it to validate assumptions before writing code
27
+ 3. Record key decisions from the thinking process in task spec files
28
+
29
+ ## Install (if not configured)
30
+
31
+ ```bash
32
+ # Add to .mcp.json
33
+ {
34
+ "mcpServers": {
35
+ "sequential-thinking": {
36
+ "command": "npx",
37
+ "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
38
+ }
39
+ }
40
+ }
41
+ ```
42
+ <!-- SEQUENTIAL_THINKING:END -->
@@ -1,4 +1,4 @@
1
- @echo off
2
- REM Ralph History — View iteration history
3
- REM Generated by @hivehub/rulebook
4
- npx @hivehub/rulebook@latest ralph history %*
1
+ @echo off
2
+ REM Ralph History — View iteration history
3
+ REM Generated by @hivehub/rulebook
4
+ npx @hivehub/rulebook@latest ralph history %*
@@ -1,5 +1,5 @@
1
- #!/bin/sh
2
- # Ralph History — View iteration history
3
- # Generated by @hivehub/rulebook
4
- echo "Loading Ralph history..."
5
- npx @hivehub/rulebook@latest ralph history "$@"
1
+ #!/bin/sh
2
+ # Ralph History — View iteration history
3
+ # Generated by @hivehub/rulebook
4
+ echo "Loading Ralph history..."
5
+ npx @hivehub/rulebook@latest ralph history "$@"
@@ -1,5 +1,5 @@
1
- @echo off
2
- REM Ralph Init — Initialize autonomous loop
3
- REM Generated by @hivehub/rulebook
4
- echo Initializing Ralph autonomous loop...
5
- npx @hivehub/rulebook@latest ralph init %*
1
+ @echo off
2
+ REM Ralph Init — Initialize autonomous loop
3
+ REM Generated by @hivehub/rulebook
4
+ echo Initializing Ralph autonomous loop...
5
+ npx @hivehub/rulebook@latest ralph init %*
@@ -1,5 +1,5 @@
1
- #!/bin/sh
2
- # Ralph Init — Initialize autonomous loop
3
- # Generated by @hivehub/rulebook
4
- echo "Initializing Ralph autonomous loop..."
5
- npx @hivehub/rulebook@latest ralph init "$@"
1
+ #!/bin/sh
2
+ # Ralph Init — Initialize autonomous loop
3
+ # Generated by @hivehub/rulebook
4
+ echo "Initializing Ralph autonomous loop..."
5
+ npx @hivehub/rulebook@latest ralph init "$@"
@@ -1,5 +1,5 @@
1
- @echo off
2
- REM Ralph Pause — Pause autonomous loop
3
- REM Generated by @hivehub/rulebook
4
- echo Pausing Ralph autonomous loop...
5
- npx @hivehub/rulebook@latest ralph pause %*
1
+ @echo off
2
+ REM Ralph Pause — Pause autonomous loop
3
+ REM Generated by @hivehub/rulebook
4
+ echo Pausing Ralph autonomous loop...
5
+ npx @hivehub/rulebook@latest ralph pause %*
@@ -1,5 +1,5 @@
1
- #!/bin/sh
2
- # Ralph Pause — Pause autonomous loop
3
- # Generated by @hivehub/rulebook
4
- echo "Pausing Ralph autonomous loop..."
5
- npx @hivehub/rulebook@latest ralph pause "$@"
1
+ #!/bin/sh
2
+ # Ralph Pause — Pause autonomous loop
3
+ # Generated by @hivehub/rulebook
4
+ echo "Pausing Ralph autonomous loop..."
5
+ npx @hivehub/rulebook@latest ralph pause "$@"
@@ -1,5 +1,5 @@
1
- @echo off
2
- REM Ralph Run — Start autonomous loop
3
- REM Generated by @hivehub/rulebook
4
- echo Starting Ralph autonomous loop...
5
- npx @hivehub/rulebook@latest ralph run %*
1
+ @echo off
2
+ REM Ralph Run — Start autonomous loop
3
+ REM Generated by @hivehub/rulebook
4
+ echo Starting Ralph autonomous loop...
5
+ npx @hivehub/rulebook@latest ralph run %*
@@ -1,5 +1,5 @@
1
- #!/bin/sh
2
- # Ralph Run — Start autonomous loop
3
- # Generated by @hivehub/rulebook
4
- echo "Starting Ralph autonomous loop..."
5
- npx @hivehub/rulebook@latest ralph run "$@"
1
+ #!/bin/sh
2
+ # Ralph Run — Start autonomous loop
3
+ # Generated by @hivehub/rulebook
4
+ echo "Starting Ralph autonomous loop..."
5
+ npx @hivehub/rulebook@latest ralph run "$@"
@@ -1,4 +1,4 @@
1
- @echo off
2
- REM Ralph Status — Check loop status
3
- REM Generated by @hivehub/rulebook
4
- npx @hivehub/rulebook@latest ralph status %*
1
+ @echo off
2
+ REM Ralph Status — Check loop status
3
+ REM Generated by @hivehub/rulebook
4
+ npx @hivehub/rulebook@latest ralph status %*
@@ -1,5 +1,5 @@
1
- #!/bin/sh
2
- # Ralph Status — Check loop status
3
- # Generated by @hivehub/rulebook
4
- echo "Checking Ralph status..."
5
- npx @hivehub/rulebook@latest ralph status "$@"
1
+ #!/bin/sh
2
+ # Ralph Status — Check loop status
3
+ # Generated by @hivehub/rulebook
4
+ echo "Checking Ralph status..."
5
+ npx @hivehub/rulebook@latest ralph status "$@"