@hivehub/rulebook 5.1.3 → 5.2.1

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 (374) 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-decision-create.md +55 -55
  9. package/.claude/commands/rulebook-decision-list.md +15 -15
  10. package/.claude/commands/rulebook-knowledge-add.md +41 -41
  11. package/.claude/commands/rulebook-knowledge-list.md +15 -15
  12. package/.claude/commands/rulebook-learn-capture.md +48 -48
  13. package/.claude/commands/rulebook-learn-list.md +13 -13
  14. package/.claude/commands/rulebook-memory-save.md +48 -48
  15. package/.claude/commands/rulebook-memory-search.md +47 -47
  16. package/.claude/commands/rulebook-task-apply.md +85 -67
  17. package/.claude/commands/rulebook-task-archive.md +103 -94
  18. package/.claude/commands/rulebook-task-create.md +93 -93
  19. package/.claude/commands/rulebook-task-list.md +42 -42
  20. package/.claude/commands/rulebook-task-show.md +52 -52
  21. package/.claude/commands/rulebook-task-validate.md +53 -53
  22. package/.claude-plugin/marketplace.json +28 -28
  23. package/.claude-plugin/plugin.json +8 -8
  24. package/README.md +25 -43
  25. package/dist/cli/commands.d.ts.map +1 -1
  26. package/dist/cli/commands.js +11 -0
  27. package/dist/cli/commands.js.map +1 -1
  28. package/dist/core/agent-template-engine.js +28 -28
  29. package/dist/core/generator.js +28 -28
  30. package/dist/core/task-manager.d.ts +23 -0
  31. package/dist/core/task-manager.d.ts.map +1 -1
  32. package/dist/core/task-manager.js +163 -27
  33. package/dist/core/task-manager.js.map +1 -1
  34. package/dist/index.js +0 -0
  35. package/dist/mcp/rulebook-server.js +3 -3
  36. package/dist/mcp/rulebook-server.js.map +1 -1
  37. package/dist/memory/memory-store.js +91 -91
  38. package/package.json +21 -22
  39. package/templates/agents/accessibility-reviewer.md +43 -43
  40. package/templates/agents/api-designer.md +42 -42
  41. package/templates/agents/architect.md +51 -51
  42. package/templates/agents/build-engineer.md +36 -36
  43. package/templates/agents/code-reviewer.md +47 -47
  44. package/templates/agents/compiler/codegen-debugger.md +34 -34
  45. package/templates/agents/compiler/stdlib-engineer.md +28 -28
  46. package/templates/agents/compiler/test-coverage-guardian.md +31 -31
  47. package/templates/agents/context-intelligence.md +52 -52
  48. package/templates/agents/database-architect.md +41 -41
  49. package/templates/agents/devops-engineer.md +42 -42
  50. package/templates/agents/docs-writer.md +38 -38
  51. package/templates/agents/game-engine/cpp-core-expert.md +35 -35
  52. package/templates/agents/game-engine/render-engineer.md +22 -22
  53. package/templates/agents/game-engine/shader-engineer.md +38 -38
  54. package/templates/agents/game-engine/systems-integration.md +43 -43
  55. package/templates/agents/generic/code-reviewer.md +41 -41
  56. package/templates/agents/generic/docs-writer.md +25 -25
  57. package/templates/agents/generic/project-manager.md +36 -36
  58. package/templates/agents/generic/researcher.md +34 -34
  59. package/templates/agents/generic/test-engineer.md +41 -41
  60. package/templates/agents/i18n-engineer.md +42 -42
  61. package/templates/agents/implementer.md +42 -42
  62. package/templates/agents/migration-engineer.md +42 -42
  63. package/templates/agents/mobile/platform-specialist.md +22 -22
  64. package/templates/agents/mobile/ui-engineer.md +22 -22
  65. package/templates/agents/performance-engineer.md +49 -49
  66. package/templates/agents/refactoring-agent.md +41 -41
  67. package/templates/agents/researcher.md +38 -38
  68. package/templates/agents/security-reviewer.md +40 -40
  69. package/templates/agents/team-lead.md +37 -37
  70. package/templates/agents/tester.md +48 -48
  71. package/templates/agents/ux-reviewer.md +43 -43
  72. package/templates/agents/web-app/api-designer.md +22 -22
  73. package/templates/agents/web-app/backend-engineer.md +30 -30
  74. package/templates/agents/web-app/database-engineer.md +22 -22
  75. package/templates/agents/web-app/frontend-engineer.md +29 -29
  76. package/templates/agents/web-app/security-reviewer.md +32 -32
  77. package/templates/ci/rulebook-review.yml +26 -26
  78. package/templates/cli/AIDER.md +49 -49
  79. package/templates/cli/AMAZON_Q.md +25 -25
  80. package/templates/cli/AUGGIE.md +32 -32
  81. package/templates/cli/CLAUDE.md +117 -117
  82. package/templates/cli/CLINE.md +99 -99
  83. package/templates/cli/CODEBUDDY.md +20 -20
  84. package/templates/cli/CODEIUM.md +20 -20
  85. package/templates/cli/CODEX.md +21 -21
  86. package/templates/cli/CONTINUE.md +34 -34
  87. package/templates/cli/CURSOR_CLI.md +62 -62
  88. package/templates/cli/FACTORY.md +18 -18
  89. package/templates/cli/GEMINI.md +35 -35
  90. package/templates/cli/KILOCODE.md +18 -18
  91. package/templates/cli/OPENCODE.md +18 -18
  92. package/templates/cli/_GENERIC_TEMPLATE.md +29 -29
  93. package/templates/commands/rulebook-decision-create.md +55 -55
  94. package/templates/commands/rulebook-decision-list.md +15 -15
  95. package/templates/commands/rulebook-knowledge-add.md +41 -41
  96. package/templates/commands/rulebook-knowledge-list.md +15 -15
  97. package/templates/commands/rulebook-learn-capture.md +48 -48
  98. package/templates/commands/rulebook-learn-list.md +13 -13
  99. package/templates/commands/rulebook-memory-save.md +48 -48
  100. package/templates/commands/rulebook-memory-search.md +47 -47
  101. package/templates/commands/rulebook-task-apply.md +67 -67
  102. package/templates/commands/rulebook-task-archive.md +94 -94
  103. package/templates/commands/rulebook-task-create.md +93 -93
  104. package/templates/commands/rulebook-task-list.md +42 -42
  105. package/templates/commands/rulebook-task-show.md +52 -52
  106. package/templates/commands/rulebook-task-validate.md +53 -53
  107. package/templates/core/AGENTS_LEAN.md +25 -25
  108. package/templates/core/AGENTS_OVERRIDE.md +16 -16
  109. package/templates/core/AGENT_AUTOMATION.md +296 -296
  110. package/templates/core/DAG.md +304 -304
  111. package/templates/core/DECISIONS.md +38 -38
  112. package/templates/core/DOCUMENTATION_RULES.md +36 -36
  113. package/templates/core/KNOWLEDGE.md +49 -49
  114. package/templates/core/MULTI_AGENT.md +74 -74
  115. package/templates/core/PLANS.md +28 -28
  116. package/templates/core/QUALITY_ENFORCEMENT.md +68 -68
  117. package/templates/core/RALPH.md +471 -471
  118. package/templates/core/RULEBOOK.md +1947 -1947
  119. package/templates/core/TIER1_PROHIBITIONS.md +154 -154
  120. package/templates/core/TOKEN_OPTIMIZATION.md +49 -49
  121. package/templates/frameworks/ANGULAR.md +36 -36
  122. package/templates/frameworks/DJANGO.md +83 -83
  123. package/templates/frameworks/ELECTRON.md +147 -147
  124. package/templates/frameworks/FLASK.md +38 -38
  125. package/templates/frameworks/FLUTTER.md +55 -55
  126. package/templates/frameworks/JQUERY.md +32 -32
  127. package/templates/frameworks/LARAVEL.md +38 -38
  128. package/templates/frameworks/NESTJS.md +43 -43
  129. package/templates/frameworks/NEXTJS.md +127 -127
  130. package/templates/frameworks/NUXT.md +40 -40
  131. package/templates/frameworks/RAILS.md +66 -66
  132. package/templates/frameworks/REACT.md +38 -38
  133. package/templates/frameworks/REACT_NATIVE.md +47 -47
  134. package/templates/frameworks/SPRING.md +39 -39
  135. package/templates/frameworks/SYMFONY.md +36 -36
  136. package/templates/frameworks/VUE.md +36 -36
  137. package/templates/frameworks/ZEND.md +35 -35
  138. package/templates/git/CI_CD_PATTERNS.md +661 -661
  139. package/templates/git/GITHUB_ACTIONS.md +728 -728
  140. package/templates/git/GITLAB_CI.md +730 -730
  141. package/templates/git/GIT_WORKFLOW.md +1192 -1192
  142. package/templates/git/SECRETS_MANAGEMENT.md +585 -585
  143. package/templates/hooks/COMMIT_MSG.md +530 -530
  144. package/templates/hooks/POST_CHECKOUT.md +546 -546
  145. package/templates/hooks/PREPARE_COMMIT_MSG.md +619 -619
  146. package/templates/hooks/PRE_COMMIT.md +414 -414
  147. package/templates/hooks/PRE_PUSH.md +601 -601
  148. package/templates/ides/CONTINUE_RULES.md +16 -16
  149. package/templates/ides/COPILOT.md +37 -37
  150. package/templates/ides/COPILOT_INSTRUCTIONS.md +23 -23
  151. package/templates/ides/CURSOR.md +43 -43
  152. package/templates/ides/GEMINI_RULES.md +17 -17
  153. package/templates/ides/JETBRAINS_AI.md +35 -35
  154. package/templates/ides/REPLIT.md +36 -36
  155. package/templates/ides/TABNINE.md +29 -29
  156. package/templates/ides/VSCODE.md +40 -40
  157. package/templates/ides/WINDSURF.md +36 -36
  158. package/templates/ides/WINDSURF_RULES.md +14 -14
  159. package/templates/ides/ZED.md +32 -32
  160. package/templates/ides/cursor-mdc/go.mdc +24 -24
  161. package/templates/ides/cursor-mdc/python.mdc +24 -24
  162. package/templates/ides/cursor-mdc/quality.mdc +25 -25
  163. package/templates/ides/cursor-mdc/ralph.mdc +39 -39
  164. package/templates/ides/cursor-mdc/rulebook.mdc +38 -38
  165. package/templates/ides/cursor-mdc/rust.mdc +24 -24
  166. package/templates/ides/cursor-mdc/typescript.mdc +25 -25
  167. package/templates/languages/C.md +333 -333
  168. package/templates/languages/CPP.md +743 -743
  169. package/templates/languages/CSHARP.md +417 -417
  170. package/templates/languages/ELIXIR.md +454 -454
  171. package/templates/languages/ERLANG.md +361 -361
  172. package/templates/languages/GO.md +645 -645
  173. package/templates/languages/HASKELL.md +177 -177
  174. package/templates/languages/JAVA.md +607 -607
  175. package/templates/languages/JAVASCRIPT.md +631 -631
  176. package/templates/languages/JULIA.md +97 -97
  177. package/templates/languages/KOTLIN.md +511 -511
  178. package/templates/languages/LISP.md +100 -100
  179. package/templates/languages/LUA.md +74 -74
  180. package/templates/languages/OBJECTIVEC.md +90 -90
  181. package/templates/languages/PHP.md +416 -416
  182. package/templates/languages/PYTHON.md +682 -682
  183. package/templates/languages/RUBY.md +421 -421
  184. package/templates/languages/RUST.md +477 -477
  185. package/templates/languages/SAS.md +73 -73
  186. package/templates/languages/SCALA.md +348 -348
  187. package/templates/languages/SOLIDITY.md +580 -580
  188. package/templates/languages/SQL.md +137 -137
  189. package/templates/languages/SWIFT.md +466 -466
  190. package/templates/languages/TYPESCRIPT.md +591 -591
  191. package/templates/languages/ZIG.md +265 -265
  192. package/templates/modules/ATLASSIAN.md +255 -255
  193. package/templates/modules/CONTEXT7.md +54 -54
  194. package/templates/modules/FIGMA.md +267 -267
  195. package/templates/modules/GITHUB_MCP.md +64 -64
  196. package/templates/modules/GRAFANA.md +328 -328
  197. package/templates/modules/MEMORY.md +126 -126
  198. package/templates/modules/NOTION.md +247 -247
  199. package/templates/modules/PLAYWRIGHT.md +90 -90
  200. package/templates/modules/RULEBOOK_MCP.md +156 -156
  201. package/templates/modules/SERENA.md +337 -337
  202. package/templates/modules/SUPABASE.md +223 -223
  203. package/templates/modules/SYNAP.md +69 -69
  204. package/templates/modules/VECTORIZER.md +63 -63
  205. package/templates/modules/sequential-thinking.md +42 -42
  206. package/templates/ralph/ralph-history.bat +4 -4
  207. package/templates/ralph/ralph-history.sh +5 -5
  208. package/templates/ralph/ralph-init.bat +5 -5
  209. package/templates/ralph/ralph-init.sh +5 -5
  210. package/templates/ralph/ralph-pause.bat +5 -5
  211. package/templates/ralph/ralph-pause.sh +5 -5
  212. package/templates/ralph/ralph-run.bat +5 -5
  213. package/templates/ralph/ralph-run.sh +5 -5
  214. package/templates/ralph/ralph-status.bat +4 -4
  215. package/templates/ralph/ralph-status.sh +5 -5
  216. package/templates/rules/follow-task-sequence.md +36 -36
  217. package/templates/rules/git-safety.md +29 -29
  218. package/templates/rules/incremental-tests.md +29 -29
  219. package/templates/rules/knowledge-base-usage.md +41 -0
  220. package/templates/rules/no-deferred.md +31 -31
  221. package/templates/rules/no-shortcuts.md +30 -30
  222. package/templates/rules/research-first.md +30 -30
  223. package/templates/rules/sequential-editing.md +21 -21
  224. package/templates/rules/session-workflow.md +24 -24
  225. package/templates/rules/task-decomposition.md +32 -32
  226. package/templates/services/AZURE_BLOB.md +184 -184
  227. package/templates/services/CASSANDRA.md +239 -239
  228. package/templates/services/DATADOG.md +26 -26
  229. package/templates/services/DOCKER.md +124 -124
  230. package/templates/services/DOCKER_COMPOSE.md +168 -168
  231. package/templates/services/DYNAMODB.md +308 -308
  232. package/templates/services/ELASTICSEARCH.md +347 -347
  233. package/templates/services/GCS.md +178 -178
  234. package/templates/services/HELM.md +194 -194
  235. package/templates/services/INFLUXDB.md +265 -265
  236. package/templates/services/KAFKA.md +341 -341
  237. package/templates/services/KUBERNETES.md +208 -208
  238. package/templates/services/MARIADB.md +183 -183
  239. package/templates/services/MEMCACHED.md +242 -242
  240. package/templates/services/MINIO.md +201 -201
  241. package/templates/services/MONGODB.md +268 -268
  242. package/templates/services/MYSQL.md +358 -358
  243. package/templates/services/NEO4J.md +247 -247
  244. package/templates/services/OPENTELEMETRY.md +25 -25
  245. package/templates/services/ORACLE.md +290 -290
  246. package/templates/services/PINO.md +24 -24
  247. package/templates/services/POSTGRESQL.md +326 -326
  248. package/templates/services/PROMETHEUS.md +33 -33
  249. package/templates/services/RABBITMQ.md +286 -286
  250. package/templates/services/REDIS.md +292 -292
  251. package/templates/services/S3.md +298 -298
  252. package/templates/services/SENTRY.md +23 -23
  253. package/templates/services/SQLITE.md +294 -294
  254. package/templates/services/SQLSERVER.md +294 -294
  255. package/templates/services/WINSTON.md +30 -30
  256. package/templates/skills/cli/aider/SKILL.md +59 -59
  257. package/templates/skills/cli/amazon-q/SKILL.md +35 -35
  258. package/templates/skills/cli/auggie/SKILL.md +42 -42
  259. package/templates/skills/cli/claude/SKILL.md +42 -42
  260. package/templates/skills/cli/cline/SKILL.md +42 -42
  261. package/templates/skills/cli/codebuddy/SKILL.md +30 -30
  262. package/templates/skills/cli/codeium/SKILL.md +30 -30
  263. package/templates/skills/cli/codex/SKILL.md +31 -31
  264. package/templates/skills/cli/continue/SKILL.md +44 -44
  265. package/templates/skills/cli/cursor-cli/SKILL.md +38 -38
  266. package/templates/skills/cli/factory/SKILL.md +28 -28
  267. package/templates/skills/cli/gemini/SKILL.md +45 -45
  268. package/templates/skills/cli/kilocode/SKILL.md +28 -28
  269. package/templates/skills/cli/opencode/SKILL.md +28 -28
  270. package/templates/skills/core/agent-automation/SKILL.md +194 -194
  271. package/templates/skills/core/dag/SKILL.md +314 -314
  272. package/templates/skills/core/documentation-rules/SKILL.md +46 -46
  273. package/templates/skills/core/quality-enforcement/SKILL.md +78 -78
  274. package/templates/skills/core/rulebook/SKILL.md +176 -176
  275. package/templates/skills/dev/accessibility/SKILL.md +17 -17
  276. package/templates/skills/dev/api-design/SKILL.md +15 -15
  277. package/templates/skills/dev/architect/SKILL.md +17 -17
  278. package/templates/skills/dev/build-fix/SKILL.md +17 -17
  279. package/templates/skills/dev/db-design/SKILL.md +15 -15
  280. package/templates/skills/dev/debug/SKILL.md +16 -16
  281. package/templates/skills/dev/deploy/SKILL.md +17 -17
  282. package/templates/skills/dev/docs/SKILL.md +17 -17
  283. package/templates/skills/dev/migrate/SKILL.md +15 -15
  284. package/templates/skills/dev/perf/SKILL.md +17 -17
  285. package/templates/skills/dev/refactor/SKILL.md +17 -17
  286. package/templates/skills/dev/research/SKILL.md +14 -14
  287. package/templates/skills/dev/review/SKILL.md +18 -18
  288. package/templates/skills/dev/security-audit/SKILL.md +17 -17
  289. package/templates/skills/frameworks/angular/SKILL.md +46 -46
  290. package/templates/skills/frameworks/django/SKILL.md +93 -93
  291. package/templates/skills/frameworks/electron/SKILL.md +157 -157
  292. package/templates/skills/frameworks/flask/SKILL.md +48 -48
  293. package/templates/skills/frameworks/flutter/SKILL.md +65 -65
  294. package/templates/skills/frameworks/jquery/SKILL.md +42 -42
  295. package/templates/skills/frameworks/laravel/SKILL.md +48 -48
  296. package/templates/skills/frameworks/nestjs/SKILL.md +53 -53
  297. package/templates/skills/frameworks/nextjs/SKILL.md +137 -137
  298. package/templates/skills/frameworks/nuxt/SKILL.md +50 -50
  299. package/templates/skills/frameworks/rails/SKILL.md +76 -76
  300. package/templates/skills/frameworks/react/SKILL.md +48 -48
  301. package/templates/skills/frameworks/react-native/SKILL.md +57 -57
  302. package/templates/skills/frameworks/spring/SKILL.md +49 -49
  303. package/templates/skills/frameworks/symfony/SKILL.md +46 -46
  304. package/templates/skills/frameworks/vue/SKILL.md +46 -46
  305. package/templates/skills/frameworks/zend/SKILL.md +45 -45
  306. package/templates/skills/ides/copilot/SKILL.md +47 -47
  307. package/templates/skills/ides/cursor/SKILL.md +53 -53
  308. package/templates/skills/ides/jetbrains-ai/SKILL.md +45 -45
  309. package/templates/skills/ides/replit/SKILL.md +46 -46
  310. package/templates/skills/ides/tabnine/SKILL.md +39 -39
  311. package/templates/skills/ides/vscode/SKILL.md +50 -50
  312. package/templates/skills/ides/windsurf/SKILL.md +46 -46
  313. package/templates/skills/ides/zed/SKILL.md +42 -42
  314. package/templates/skills/languages/c/SKILL.md +343 -343
  315. package/templates/skills/languages/cpp/SKILL.md +753 -753
  316. package/templates/skills/languages/csharp/SKILL.md +427 -427
  317. package/templates/skills/languages/elixir/SKILL.md +464 -464
  318. package/templates/skills/languages/erlang/SKILL.md +371 -371
  319. package/templates/skills/languages/go/SKILL.md +655 -655
  320. package/templates/skills/languages/haskell/SKILL.md +187 -187
  321. package/templates/skills/languages/java/SKILL.md +617 -617
  322. package/templates/skills/languages/javascript/SKILL.md +641 -641
  323. package/templates/skills/languages/julia/SKILL.md +107 -107
  324. package/templates/skills/languages/kotlin/SKILL.md +521 -521
  325. package/templates/skills/languages/lisp/SKILL.md +110 -110
  326. package/templates/skills/languages/lua/SKILL.md +84 -84
  327. package/templates/skills/languages/objectivec/SKILL.md +100 -100
  328. package/templates/skills/languages/php/SKILL.md +426 -426
  329. package/templates/skills/languages/python/SKILL.md +692 -692
  330. package/templates/skills/languages/ruby/SKILL.md +431 -431
  331. package/templates/skills/languages/rust/SKILL.md +487 -487
  332. package/templates/skills/languages/sas/SKILL.md +83 -83
  333. package/templates/skills/languages/scala/SKILL.md +358 -358
  334. package/templates/skills/languages/solidity/SKILL.md +590 -590
  335. package/templates/skills/languages/sql/SKILL.md +147 -147
  336. package/templates/skills/languages/swift/SKILL.md +476 -476
  337. package/templates/skills/languages/typescript/SKILL.md +302 -302
  338. package/templates/skills/languages/zig/SKILL.md +275 -275
  339. package/templates/skills/modules/atlassian/SKILL.md +265 -265
  340. package/templates/skills/modules/context7/SKILL.md +64 -64
  341. package/templates/skills/modules/figma/SKILL.md +277 -277
  342. package/templates/skills/modules/github-mcp/SKILL.md +74 -74
  343. package/templates/skills/modules/grafana/SKILL.md +338 -338
  344. package/templates/skills/modules/memory/SKILL.md +73 -73
  345. package/templates/skills/modules/notion/SKILL.md +257 -257
  346. package/templates/skills/modules/playwright/SKILL.md +100 -100
  347. package/templates/skills/modules/rulebook-mcp/SKILL.md +166 -166
  348. package/templates/skills/modules/serena/SKILL.md +347 -347
  349. package/templates/skills/modules/supabase/SKILL.md +233 -233
  350. package/templates/skills/modules/synap/SKILL.md +79 -79
  351. package/templates/skills/modules/vectorizer/SKILL.md +73 -73
  352. package/templates/skills/services/azure-blob/SKILL.md +194 -194
  353. package/templates/skills/services/cassandra/SKILL.md +249 -249
  354. package/templates/skills/services/dynamodb/SKILL.md +318 -318
  355. package/templates/skills/services/elasticsearch/SKILL.md +357 -357
  356. package/templates/skills/services/gcs/SKILL.md +188 -188
  357. package/templates/skills/services/influxdb/SKILL.md +275 -275
  358. package/templates/skills/services/kafka/SKILL.md +351 -351
  359. package/templates/skills/services/mariadb/SKILL.md +193 -193
  360. package/templates/skills/services/memcached/SKILL.md +252 -252
  361. package/templates/skills/services/minio/SKILL.md +211 -211
  362. package/templates/skills/services/mongodb/SKILL.md +278 -278
  363. package/templates/skills/services/mysql/SKILL.md +368 -368
  364. package/templates/skills/services/neo4j/SKILL.md +257 -257
  365. package/templates/skills/services/oracle/SKILL.md +300 -300
  366. package/templates/skills/services/postgresql/SKILL.md +336 -336
  367. package/templates/skills/services/rabbitmq/SKILL.md +296 -296
  368. package/templates/skills/services/redis/SKILL.md +302 -302
  369. package/templates/skills/services/s3/SKILL.md +308 -308
  370. package/templates/skills/services/sqlite/SKILL.md +304 -304
  371. package/templates/skills/services/sqlserver/SKILL.md +304 -304
  372. package/templates/skills/workflows/ralph/SKILL.md +309 -309
  373. package/templates/skills/workflows/ralph/install.sh +87 -87
  374. package/templates/skills/workflows/ralph/manifest.json +158 -158
@@ -1,93 +1,93 @@
1
- ---
2
- name: "Django"
3
- description: "Language: Python"
4
- version: "1.0.0"
5
- category: "frameworks"
6
- author: "Rulebook"
7
- tags: ["frameworks", "framework"]
8
- dependencies: []
9
- conflicts: []
10
- ---
11
- <!-- DJANGO:START -->
12
- # Django Framework Rules
13
-
14
- **Language**: Python
15
- **Version**: Django 4.2+ (LTS) or 5.0+
16
-
17
- ## Setup & Configuration
18
-
19
- ```python
20
- # settings.py
21
- SECRET_KEY = env('SECRET_KEY') # Never hardcode
22
- DEBUG = env.bool('DEBUG', default=False)
23
- ALLOWED_HOSTS = env.list('ALLOWED_HOSTS')
24
-
25
- INSTALLED_APPS = [
26
- # Django apps
27
- 'django.contrib.admin',
28
- 'django.contrib.auth',
29
- # Third-party
30
- 'rest_framework',
31
- 'corsheaders',
32
- # Local apps
33
- 'apps.users',
34
- ]
35
-
36
- DATABASES = {
37
- 'default': env.db('DATABASE_URL') # Use django-environ
38
- }
39
- ```
40
-
41
- ## Quality Gates
42
-
43
- ```bash
44
- # Code quality
45
- black . # Format
46
- ruff check . # Lint
47
- mypy . # Type check
48
-
49
- # Tests
50
- python manage.py test # Run tests
51
- pytest --cov=apps --cov-report=html # With coverage
52
-
53
- # Security
54
- python manage.py check --deploy # Production checks
55
- bandit -r apps/ # Security scan
56
- ```
57
-
58
- ## Best Practices
59
-
60
- ✅ **DO:**
61
- - Use Class-Based Views (CBVs) or Django REST Framework ViewSets
62
- - Implement custom User model from start
63
- - Use Django ORM properly (select_related, prefetch_related)
64
- - Enable CSRF protection
65
- - Use environment variables for secrets
66
- - Write tests for views, models, and forms
67
-
68
- ❌ **DON'T:**
69
- - Use `DEBUG=True` in production
70
- - Store secrets in settings.py
71
- - Use raw SQL without parameterization
72
- - Skip migrations
73
- - Ignore security middleware
74
-
75
- ## Project Structure
76
-
77
- ```
78
- project/
79
- ├── manage.py
80
- ├── requirements.txt
81
- ├── apps/
82
- │ ├── users/
83
- │ ├── api/
84
- │ └── core/
85
- ├── config/
86
- │ ├── settings.py
87
- │ ├── urls.py
88
- │ └── wsgi.py
89
- └── tests/
90
- ```
91
-
92
- <!-- DJANGO:END -->
93
-
1
+ ---
2
+ name: "Django"
3
+ description: "Language: Python"
4
+ version: "1.0.0"
5
+ category: "frameworks"
6
+ author: "Rulebook"
7
+ tags: ["frameworks", "framework"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
+ <!-- DJANGO:START -->
12
+ # Django Framework Rules
13
+
14
+ **Language**: Python
15
+ **Version**: Django 4.2+ (LTS) or 5.0+
16
+
17
+ ## Setup & Configuration
18
+
19
+ ```python
20
+ # settings.py
21
+ SECRET_KEY = env('SECRET_KEY') # Never hardcode
22
+ DEBUG = env.bool('DEBUG', default=False)
23
+ ALLOWED_HOSTS = env.list('ALLOWED_HOSTS')
24
+
25
+ INSTALLED_APPS = [
26
+ # Django apps
27
+ 'django.contrib.admin',
28
+ 'django.contrib.auth',
29
+ # Third-party
30
+ 'rest_framework',
31
+ 'corsheaders',
32
+ # Local apps
33
+ 'apps.users',
34
+ ]
35
+
36
+ DATABASES = {
37
+ 'default': env.db('DATABASE_URL') # Use django-environ
38
+ }
39
+ ```
40
+
41
+ ## Quality Gates
42
+
43
+ ```bash
44
+ # Code quality
45
+ black . # Format
46
+ ruff check . # Lint
47
+ mypy . # Type check
48
+
49
+ # Tests
50
+ python manage.py test # Run tests
51
+ pytest --cov=apps --cov-report=html # With coverage
52
+
53
+ # Security
54
+ python manage.py check --deploy # Production checks
55
+ bandit -r apps/ # Security scan
56
+ ```
57
+
58
+ ## Best Practices
59
+
60
+ ✅ **DO:**
61
+ - Use Class-Based Views (CBVs) or Django REST Framework ViewSets
62
+ - Implement custom User model from start
63
+ - Use Django ORM properly (select_related, prefetch_related)
64
+ - Enable CSRF protection
65
+ - Use environment variables for secrets
66
+ - Write tests for views, models, and forms
67
+
68
+ ❌ **DON'T:**
69
+ - Use `DEBUG=True` in production
70
+ - Store secrets in settings.py
71
+ - Use raw SQL without parameterization
72
+ - Skip migrations
73
+ - Ignore security middleware
74
+
75
+ ## Project Structure
76
+
77
+ ```
78
+ project/
79
+ ├── manage.py
80
+ ├── requirements.txt
81
+ ├── apps/
82
+ │ ├── users/
83
+ │ ├── api/
84
+ │ └── core/
85
+ ├── config/
86
+ │ ├── settings.py
87
+ │ ├── urls.py
88
+ │ └── wsgi.py
89
+ └── tests/
90
+ ```
91
+
92
+ <!-- DJANGO:END -->
93
+
@@ -1,157 +1,157 @@
1
- ---
2
- name: "Electron"
3
- description: "Language: TypeScript, JavaScript"
4
- version: "1.0.0"
5
- category: "frameworks"
6
- author: "Rulebook"
7
- tags: ["frameworks", "framework"]
8
- dependencies: []
9
- conflicts: []
10
- ---
11
- <!-- ELECTRON:START -->
12
- # Electron Framework Rules
13
-
14
- **Language**: TypeScript, JavaScript
15
- **Version**: Electron 28+
16
-
17
- ## Setup & Configuration
18
-
19
- ```typescript
20
- // main.ts (Main Process)
21
- import { app, BrowserWindow } from 'electron'
22
- import path from 'path'
23
-
24
- function createWindow() {
25
- const win = new BrowserWindow({
26
- width: 1200,
27
- height: 800,
28
- webPreferences: {
29
- preload: path.join(__dirname, 'preload.js'),
30
- contextIsolation: true,
31
- nodeIntegration: false,
32
- },
33
- })
34
-
35
- win.loadFile('index.html')
36
- }
37
-
38
- app.whenReady().then(createWindow)
39
- ```
40
-
41
- ## Quality Gates
42
-
43
- ```bash
44
- # Type check
45
- npm run type-check
46
-
47
- # Lint
48
- npm run lint
49
-
50
- # Tests
51
- npm test
52
-
53
- # Build
54
- npm run build # Compile TypeScript
55
- npm run package # Package app
56
- npm run make # Create distributables
57
- ```
58
-
59
- ## Best Practices
60
-
61
- ✅ **DO:**
62
- - Use contextIsolation: true
63
- - Disable nodeIntegration
64
- - Use preload scripts for IPC
65
- - Implement auto-updates (electron-updater)
66
- - Sign and notarize apps (production)
67
- - Use Content Security Policy
68
- - Implement proper error handling
69
- - Separate main and renderer processes
70
-
71
- ❌ **DON'T:**
72
- - Enable nodeIntegration in renderer
73
- - Skip contextIsolation
74
- - Use remote module (deprecated)
75
- - Ignore security warnings
76
- - Skip code signing
77
- - Load remote content without CSP
78
- - Use synchronous IPC
79
- - Hardcode credentials
80
-
81
- ## Project Structure
82
-
83
- ```
84
- src/
85
- ├── main/
86
- │ ├── main.ts # Main process
87
- │ ├── preload.ts # Preload script
88
- │ └── ipc/ # IPC handlers
89
- ├── renderer/
90
- │ ├── index.html
91
- │ ├── renderer.ts
92
- │ └── components/
93
- └── shared/
94
- └── types.ts
95
- ```
96
-
97
- ## IPC Communication
98
-
99
- ```typescript
100
- // preload.ts
101
- import { contextBridge, ipcRenderer } from 'electron'
102
-
103
- contextBridge.exposeInMainWorld('electronAPI', {
104
- sendMessage: (message: string) => ipcRenderer.send('message', message),
105
- onReply: (callback: (reply: string) => void) =>
106
- ipcRenderer.on('reply', (_event, reply) => callback(reply)),
107
- })
108
-
109
- // main.ts
110
- import { ipcMain } from 'electron'
111
-
112
- ipcMain.on('message', (event, message) => {
113
- console.log(message)
114
- event.reply('reply', 'Message received')
115
- })
116
-
117
- // renderer.ts
118
- declare global {
119
- interface Window {
120
- electronAPI: {
121
- sendMessage: (message: string) => void
122
- onReply: (callback: (reply: string) => void) => void
123
- }
124
- }
125
- }
126
-
127
- window.electronAPI.sendMessage('Hello from renderer')
128
- window.electronAPI.onReply((reply) => console.log(reply))
129
- ```
130
-
131
- ## Security Checklist
132
-
133
- ```typescript
134
- // ✅ Good security configuration
135
- const win = new BrowserWindow({
136
- webPreferences: {
137
- contextIsolation: true, // ✅ MUST enable
138
- nodeIntegration: false, // ✅ MUST disable
139
- sandbox: true, // ✅ Enable sandbox
140
- webSecurity: true, // ✅ Enable web security
141
- allowRunningInsecureContent: false, // ✅ Block insecure content
142
- },
143
- })
144
-
145
- // Content Security Policy
146
- session.defaultSession.webRequest.onHeadersReceived((details, callback) => {
147
- callback({
148
- responseHeaders: {
149
- ...details.responseHeaders,
150
- 'Content-Security-Policy': ["default-src 'self'"]
151
- }
152
- })
153
- })
154
- ```
155
-
156
- <!-- ELECTRON:END -->
157
-
1
+ ---
2
+ name: "Electron"
3
+ description: "Language: TypeScript, JavaScript"
4
+ version: "1.0.0"
5
+ category: "frameworks"
6
+ author: "Rulebook"
7
+ tags: ["frameworks", "framework"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
+ <!-- ELECTRON:START -->
12
+ # Electron Framework Rules
13
+
14
+ **Language**: TypeScript, JavaScript
15
+ **Version**: Electron 28+
16
+
17
+ ## Setup & Configuration
18
+
19
+ ```typescript
20
+ // main.ts (Main Process)
21
+ import { app, BrowserWindow } from 'electron'
22
+ import path from 'path'
23
+
24
+ function createWindow() {
25
+ const win = new BrowserWindow({
26
+ width: 1200,
27
+ height: 800,
28
+ webPreferences: {
29
+ preload: path.join(__dirname, 'preload.js'),
30
+ contextIsolation: true,
31
+ nodeIntegration: false,
32
+ },
33
+ })
34
+
35
+ win.loadFile('index.html')
36
+ }
37
+
38
+ app.whenReady().then(createWindow)
39
+ ```
40
+
41
+ ## Quality Gates
42
+
43
+ ```bash
44
+ # Type check
45
+ npm run type-check
46
+
47
+ # Lint
48
+ npm run lint
49
+
50
+ # Tests
51
+ npm test
52
+
53
+ # Build
54
+ npm run build # Compile TypeScript
55
+ npm run package # Package app
56
+ npm run make # Create distributables
57
+ ```
58
+
59
+ ## Best Practices
60
+
61
+ ✅ **DO:**
62
+ - Use contextIsolation: true
63
+ - Disable nodeIntegration
64
+ - Use preload scripts for IPC
65
+ - Implement auto-updates (electron-updater)
66
+ - Sign and notarize apps (production)
67
+ - Use Content Security Policy
68
+ - Implement proper error handling
69
+ - Separate main and renderer processes
70
+
71
+ ❌ **DON'T:**
72
+ - Enable nodeIntegration in renderer
73
+ - Skip contextIsolation
74
+ - Use remote module (deprecated)
75
+ - Ignore security warnings
76
+ - Skip code signing
77
+ - Load remote content without CSP
78
+ - Use synchronous IPC
79
+ - Hardcode credentials
80
+
81
+ ## Project Structure
82
+
83
+ ```
84
+ src/
85
+ ├── main/
86
+ │ ├── main.ts # Main process
87
+ │ ├── preload.ts # Preload script
88
+ │ └── ipc/ # IPC handlers
89
+ ├── renderer/
90
+ │ ├── index.html
91
+ │ ├── renderer.ts
92
+ │ └── components/
93
+ └── shared/
94
+ └── types.ts
95
+ ```
96
+
97
+ ## IPC Communication
98
+
99
+ ```typescript
100
+ // preload.ts
101
+ import { contextBridge, ipcRenderer } from 'electron'
102
+
103
+ contextBridge.exposeInMainWorld('electronAPI', {
104
+ sendMessage: (message: string) => ipcRenderer.send('message', message),
105
+ onReply: (callback: (reply: string) => void) =>
106
+ ipcRenderer.on('reply', (_event, reply) => callback(reply)),
107
+ })
108
+
109
+ // main.ts
110
+ import { ipcMain } from 'electron'
111
+
112
+ ipcMain.on('message', (event, message) => {
113
+ console.log(message)
114
+ event.reply('reply', 'Message received')
115
+ })
116
+
117
+ // renderer.ts
118
+ declare global {
119
+ interface Window {
120
+ electronAPI: {
121
+ sendMessage: (message: string) => void
122
+ onReply: (callback: (reply: string) => void) => void
123
+ }
124
+ }
125
+ }
126
+
127
+ window.electronAPI.sendMessage('Hello from renderer')
128
+ window.electronAPI.onReply((reply) => console.log(reply))
129
+ ```
130
+
131
+ ## Security Checklist
132
+
133
+ ```typescript
134
+ // ✅ Good security configuration
135
+ const win = new BrowserWindow({
136
+ webPreferences: {
137
+ contextIsolation: true, // ✅ MUST enable
138
+ nodeIntegration: false, // ✅ MUST disable
139
+ sandbox: true, // ✅ Enable sandbox
140
+ webSecurity: true, // ✅ Enable web security
141
+ allowRunningInsecureContent: false, // ✅ Block insecure content
142
+ },
143
+ })
144
+
145
+ // Content Security Policy
146
+ session.defaultSession.webRequest.onHeadersReceived((details, callback) => {
147
+ callback({
148
+ responseHeaders: {
149
+ ...details.responseHeaders,
150
+ 'Content-Security-Policy': ["default-src 'self'"]
151
+ }
152
+ })
153
+ })
154
+ ```
155
+
156
+ <!-- ELECTRON:END -->
157
+
@@ -1,48 +1,48 @@
1
- ---
2
- name: "Flask"
3
- description: "Language: Python"
4
- version: "1.0.0"
5
- category: "frameworks"
6
- author: "Rulebook"
7
- tags: ["frameworks", "framework"]
8
- dependencies: []
9
- conflicts: []
10
- ---
11
- <!-- FLASK:START -->
12
- # Flask Framework Rules
13
-
14
- **Language**: Python
15
- **Version**: Flask 3.0+
16
-
17
- ## Setup
18
-
19
- ```python
20
- from flask import Flask
21
- app = Flask(__name__)
22
- app.config.from_object('config.ProductionConfig')
23
-
24
- # Use Flask-SQLAlchemy for ORM
25
- # Use Flask-Migrate for migrations
26
- # Use Flask-Login for auth
27
- ```
28
-
29
- ## Quality Gates
30
-
31
- ```bash
32
- black .
33
- ruff check .
34
- pytest --cov=app
35
- ```
36
-
37
- ## Best Practices
38
-
39
- ✅ Use application factory pattern
40
- ✅ Enable CORS properly
41
- ✅ Use blueprints for organization
42
- ✅ Implement error handlers
43
-
44
- ❌ Don't use `debug=True` in production
45
- ❌ Don't store secrets in code
46
-
47
- <!-- FLASK:END -->
48
-
1
+ ---
2
+ name: "Flask"
3
+ description: "Language: Python"
4
+ version: "1.0.0"
5
+ category: "frameworks"
6
+ author: "Rulebook"
7
+ tags: ["frameworks", "framework"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
+ <!-- FLASK:START -->
12
+ # Flask Framework Rules
13
+
14
+ **Language**: Python
15
+ **Version**: Flask 3.0+
16
+
17
+ ## Setup
18
+
19
+ ```python
20
+ from flask import Flask
21
+ app = Flask(__name__)
22
+ app.config.from_object('config.ProductionConfig')
23
+
24
+ # Use Flask-SQLAlchemy for ORM
25
+ # Use Flask-Migrate for migrations
26
+ # Use Flask-Login for auth
27
+ ```
28
+
29
+ ## Quality Gates
30
+
31
+ ```bash
32
+ black .
33
+ ruff check .
34
+ pytest --cov=app
35
+ ```
36
+
37
+ ## Best Practices
38
+
39
+ ✅ Use application factory pattern
40
+ ✅ Enable CORS properly
41
+ ✅ Use blueprints for organization
42
+ ✅ Implement error handlers
43
+
44
+ ❌ Don't use `debug=True` in production
45
+ ❌ Don't store secrets in code
46
+
47
+ <!-- FLASK:END -->
48
+