@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,57 +1,57 @@
1
- ---
2
- name: "React Native"
3
- description: "Language: JavaScript, TypeScript"
4
- version: "1.0.0"
5
- category: "frameworks"
6
- author: "Rulebook"
7
- tags: ["frameworks", "framework"]
8
- dependencies: []
9
- conflicts: []
10
- ---
11
- <!-- REACT_NATIVE:START -->
12
- # React Native Framework Rules
13
-
14
- **Language**: JavaScript, TypeScript
15
- **Version**: React Native 0.72+
16
-
17
- ## Setup
18
-
19
- ```bash
20
- npx react-native init MyApp --template react-native-template-typescript
21
- ```
22
-
23
- ## Quality Gates
24
-
25
- ```bash
26
- npm run lint
27
- npm run type-check
28
- npm test
29
- npm run android # Test build
30
- npm run ios # Test build
31
- ```
32
-
33
- ## Best Practices
34
-
35
- ✅ Use TypeScript
36
- ✅ Implement proper navigation (React Navigation)
37
- ✅ Use platform-specific code when needed
38
- ✅ Optimize images and assets
39
- ✅ Test on both iOS and Android
40
-
41
- ❌ Don't hardcode dimensions
42
- ❌ Don't skip accessibility
43
- ❌ Don't ignore memory leaks
44
-
45
- ## Project Structure
46
-
47
- ```
48
- src/
49
- ├── components/
50
- ├── screens/
51
- ├── navigation/
52
- ├── services/
53
- └── utils/
54
- ```
55
-
56
- <!-- REACT_NATIVE:END -->
57
-
1
+ ---
2
+ name: "React Native"
3
+ description: "Language: JavaScript, TypeScript"
4
+ version: "1.0.0"
5
+ category: "frameworks"
6
+ author: "Rulebook"
7
+ tags: ["frameworks", "framework"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
+ <!-- REACT_NATIVE:START -->
12
+ # React Native Framework Rules
13
+
14
+ **Language**: JavaScript, TypeScript
15
+ **Version**: React Native 0.72+
16
+
17
+ ## Setup
18
+
19
+ ```bash
20
+ npx react-native init MyApp --template react-native-template-typescript
21
+ ```
22
+
23
+ ## Quality Gates
24
+
25
+ ```bash
26
+ npm run lint
27
+ npm run type-check
28
+ npm test
29
+ npm run android # Test build
30
+ npm run ios # Test build
31
+ ```
32
+
33
+ ## Best Practices
34
+
35
+ ✅ Use TypeScript
36
+ ✅ Implement proper navigation (React Navigation)
37
+ ✅ Use platform-specific code when needed
38
+ ✅ Optimize images and assets
39
+ ✅ Test on both iOS and Android
40
+
41
+ ❌ Don't hardcode dimensions
42
+ ❌ Don't skip accessibility
43
+ ❌ Don't ignore memory leaks
44
+
45
+ ## Project Structure
46
+
47
+ ```
48
+ src/
49
+ ├── components/
50
+ ├── screens/
51
+ ├── navigation/
52
+ ├── services/
53
+ └── utils/
54
+ ```
55
+
56
+ <!-- REACT_NATIVE:END -->
57
+
@@ -1,49 +1,49 @@
1
- ---
2
- name: "Spring"
3
- description: "Every Spring service must satisfy these quality gates before merge."
4
- version: "1.0.0"
5
- category: "frameworks"
6
- author: "Rulebook"
7
- tags: ["frameworks", "framework"]
8
- dependencies: []
9
- conflicts: []
10
- ---
11
- <!-- SPRING:START -->
12
- # Spring Boot Framework Rules
13
-
14
- **CRITICAL**: Every Spring service must satisfy these quality gates before merge.
15
-
16
- ## Build & Quality Commands
17
- - Lint/format: `./gradlew checkstyleMain` or `mvn verify`
18
- - Unit tests: `./gradlew test` or `mvn test`
19
- - Integration tests: `./gradlew integrationTest` (if module exists)
20
- - Static analysis: `./gradlew jacocoTestReport` to ensure 80%+ coverage
21
-
22
- ## Project Structure
23
- - Keep domain logic in `src/main/java/.../service`
24
- - Expose REST controllers in `controller` packages
25
- - Isolate configuration classes under `config`
26
- - Share DTOs via `dto` package and map with MapStruct where applicable
27
-
28
- ## Implementation Guidelines
29
- - Manage configuration with `application.yml` profiles (dev/test/prod)
30
- - Prefer constructor injection, avoid `@Autowired` field injection
31
- - Wrap transactional operations with `@Transactional`
32
- - Use `ResponseEntity` for explicit HTTP semantics
33
- - Validate inputs using `javax.validation` annotations and `@Valid`
34
-
35
- ## Build Matrix
36
- ```bash
37
- # Gradle
38
- ./gradlew clean check
39
-
40
- # Maven
41
- mvn -B clean verify
42
- ```
43
-
44
- ## Additional Checks
45
- - Ensure `application.yml` contains defaults for new properties
46
- - Update Flyway/Liquibase migrations when schema changes
47
- - Keep `README` and `/docs/architecture.md` synced with new services
48
-
49
- <!-- SPRING:END -->
1
+ ---
2
+ name: "Spring"
3
+ description: "Every Spring service must satisfy these quality gates before merge."
4
+ version: "1.0.0"
5
+ category: "frameworks"
6
+ author: "Rulebook"
7
+ tags: ["frameworks", "framework"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
+ <!-- SPRING:START -->
12
+ # Spring Boot Framework Rules
13
+
14
+ **CRITICAL**: Every Spring service must satisfy these quality gates before merge.
15
+
16
+ ## Build & Quality Commands
17
+ - Lint/format: `./gradlew checkstyleMain` or `mvn verify`
18
+ - Unit tests: `./gradlew test` or `mvn test`
19
+ - Integration tests: `./gradlew integrationTest` (if module exists)
20
+ - Static analysis: `./gradlew jacocoTestReport` to ensure 80%+ coverage
21
+
22
+ ## Project Structure
23
+ - Keep domain logic in `src/main/java/.../service`
24
+ - Expose REST controllers in `controller` packages
25
+ - Isolate configuration classes under `config`
26
+ - Share DTOs via `dto` package and map with MapStruct where applicable
27
+
28
+ ## Implementation Guidelines
29
+ - Manage configuration with `application.yml` profiles (dev/test/prod)
30
+ - Prefer constructor injection, avoid `@Autowired` field injection
31
+ - Wrap transactional operations with `@Transactional`
32
+ - Use `ResponseEntity` for explicit HTTP semantics
33
+ - Validate inputs using `javax.validation` annotations and `@Valid`
34
+
35
+ ## Build Matrix
36
+ ```bash
37
+ # Gradle
38
+ ./gradlew clean check
39
+
40
+ # Maven
41
+ mvn -B clean verify
42
+ ```
43
+
44
+ ## Additional Checks
45
+ - Ensure `application.yml` contains defaults for new properties
46
+ - Update Flyway/Liquibase migrations when schema changes
47
+ - Keep `README` and `/docs/architecture.md` synced with new services
48
+
49
+ <!-- SPRING:END -->
@@ -1,46 +1,46 @@
1
- ---
2
- name: "Symfony"
3
- description: "Language: PHP"
4
- version: "1.0.0"
5
- category: "frameworks"
6
- author: "Rulebook"
7
- tags: ["frameworks", "framework"]
8
- dependencies: []
9
- conflicts: []
10
- ---
11
- <!-- SYMFONY:START -->
12
- # Symfony Framework Rules
13
-
14
- **Language**: PHP
15
- **Version**: Symfony 6.0+ or 7.0+
16
-
17
- ## Setup
18
-
19
- ```yaml
20
- # config/packages/framework.yaml
21
- framework:
22
- secret: '%env(APP_SECRET)%'
23
- csrf_protection: true
24
- ```
25
-
26
- ## Quality Gates
27
-
28
- ```bash
29
- php bin/console lint:twig templates/
30
- php bin/console lint:yaml config/
31
- vendor/bin/phpstan analyze src tests
32
- vendor/bin/phpunit
33
- ```
34
-
35
- ## Best Practices
36
-
37
- ✅ Use dependency injection
38
- ✅ Follow PSR standards
39
- ✅ Use Doctrine ORM
40
- ✅ Implement security voters
41
-
42
- ❌ Don't bypass security
43
- ❌ Don't hardcode routes
44
-
45
- <!-- SYMFONY:END -->
46
-
1
+ ---
2
+ name: "Symfony"
3
+ description: "Language: PHP"
4
+ version: "1.0.0"
5
+ category: "frameworks"
6
+ author: "Rulebook"
7
+ tags: ["frameworks", "framework"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
+ <!-- SYMFONY:START -->
12
+ # Symfony Framework Rules
13
+
14
+ **Language**: PHP
15
+ **Version**: Symfony 6.0+ or 7.0+
16
+
17
+ ## Setup
18
+
19
+ ```yaml
20
+ # config/packages/framework.yaml
21
+ framework:
22
+ secret: '%env(APP_SECRET)%'
23
+ csrf_protection: true
24
+ ```
25
+
26
+ ## Quality Gates
27
+
28
+ ```bash
29
+ php bin/console lint:twig templates/
30
+ php bin/console lint:yaml config/
31
+ vendor/bin/phpstan analyze src tests
32
+ vendor/bin/phpunit
33
+ ```
34
+
35
+ ## Best Practices
36
+
37
+ ✅ Use dependency injection
38
+ ✅ Follow PSR standards
39
+ ✅ Use Doctrine ORM
40
+ ✅ Implement security voters
41
+
42
+ ❌ Don't bypass security
43
+ ❌ Don't hardcode routes
44
+
45
+ <!-- SYMFONY:END -->
46
+
@@ -1,46 +1,46 @@
1
- ---
2
- name: "Vue"
3
- description: "Vue 3 projects should follow these guardrails."
4
- version: "1.0.0"
5
- category: "frameworks"
6
- author: "Rulebook"
7
- tags: ["frameworks", "framework"]
8
- dependencies: []
9
- conflicts: []
10
- ---
11
- <!-- VUE:START -->
12
- # Vue Framework Rules
13
-
14
- **CRITICAL**: Vue 3 projects should follow these guardrails.
15
-
16
- ## Quality Commands
17
- - Lint: `npm run lint`
18
- - Unit tests: `npm run test:unit`
19
- - e2e tests (Cypress/Playwright): `npm run test:e2e`
20
- - Build: `npm run build`
21
-
22
- ## Project Structure
23
- - Place feature modules in `src/modules/<feature>/`
24
- - Keep reusable components in `src/components`
25
- - Shared composables go in `src/composables`
26
- - Centralize Pinia/Vuex stores under `src/stores`
27
-
28
- ## Implementation Guidelines
29
- - Adopt `<script setup>` with TypeScript and define props via `defineProps`
30
- - Leverage `defineEmits` for typed event emission
31
- - Lazy-load routes with dynamic imports in `router/index.ts`
32
- - Ensure global styles scoped via `:global` or dedicated CSS files
33
-
34
- ## Pre-Commit Commands
35
- ```bash
36
- npm run lint
37
- npm run test:unit
38
- npm run build
39
- ```
40
-
41
- ## Documentation
42
- - Update `/docs/vue-architecture.md` with module tree changes
43
- - Document composables in `/docs/composables.md`
44
- - Add component usage examples to `/docs/ui-components.md`
45
-
46
- <!-- VUE:END -->
1
+ ---
2
+ name: "Vue"
3
+ description: "Vue 3 projects should follow these guardrails."
4
+ version: "1.0.0"
5
+ category: "frameworks"
6
+ author: "Rulebook"
7
+ tags: ["frameworks", "framework"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
+ <!-- VUE:START -->
12
+ # Vue Framework Rules
13
+
14
+ **CRITICAL**: Vue 3 projects should follow these guardrails.
15
+
16
+ ## Quality Commands
17
+ - Lint: `npm run lint`
18
+ - Unit tests: `npm run test:unit`
19
+ - e2e tests (Cypress/Playwright): `npm run test:e2e`
20
+ - Build: `npm run build`
21
+
22
+ ## Project Structure
23
+ - Place feature modules in `src/modules/<feature>/`
24
+ - Keep reusable components in `src/components`
25
+ - Shared composables go in `src/composables`
26
+ - Centralize Pinia/Vuex stores under `src/stores`
27
+
28
+ ## Implementation Guidelines
29
+ - Adopt `<script setup>` with TypeScript and define props via `defineProps`
30
+ - Leverage `defineEmits` for typed event emission
31
+ - Lazy-load routes with dynamic imports in `router/index.ts`
32
+ - Ensure global styles scoped via `:global` or dedicated CSS files
33
+
34
+ ## Pre-Commit Commands
35
+ ```bash
36
+ npm run lint
37
+ npm run test:unit
38
+ npm run build
39
+ ```
40
+
41
+ ## Documentation
42
+ - Update `/docs/vue-architecture.md` with module tree changes
43
+ - Document composables in `/docs/composables.md`
44
+ - Add component usage examples to `/docs/ui-components.md`
45
+
46
+ <!-- VUE:END -->
@@ -1,45 +1,45 @@
1
- ---
2
- name: "Zend"
3
- description: "Language: PHP"
4
- version: "1.0.0"
5
- category: "frameworks"
6
- author: "Rulebook"
7
- tags: ["frameworks", "framework"]
8
- dependencies: []
9
- conflicts: []
10
- ---
11
- <!-- ZEND:START -->
12
- # Zend/Laminas Framework Rules
13
-
14
- **Language**: PHP
15
- **Version**: Laminas MVC 3.x+
16
-
17
- ## Setup
18
-
19
- ```php
20
- // config/modules.config.php
21
- return [
22
- 'Laminas\Router',
23
- 'Application',
24
- ];
25
- ```
26
-
27
- ## Quality Gates
28
-
29
- ```bash
30
- vendor/bin/phpcs --standard=PSR12 src/
31
- vendor/bin/phpstan analyze
32
- vendor/bin/phpunit
33
- ```
34
-
35
- ## Best Practices
36
-
37
- ✅ Use service manager
38
- ✅ Implement middleware
39
- ✅ Use form validation
40
-
41
- ❌ Don't skip CSRF tokens
42
- ❌ Don't expose errors in production
43
-
44
- <!-- ZEND:END -->
45
-
1
+ ---
2
+ name: "Zend"
3
+ description: "Language: PHP"
4
+ version: "1.0.0"
5
+ category: "frameworks"
6
+ author: "Rulebook"
7
+ tags: ["frameworks", "framework"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
+ <!-- ZEND:START -->
12
+ # Zend/Laminas Framework Rules
13
+
14
+ **Language**: PHP
15
+ **Version**: Laminas MVC 3.x+
16
+
17
+ ## Setup
18
+
19
+ ```php
20
+ // config/modules.config.php
21
+ return [
22
+ 'Laminas\Router',
23
+ 'Application',
24
+ ];
25
+ ```
26
+
27
+ ## Quality Gates
28
+
29
+ ```bash
30
+ vendor/bin/phpcs --standard=PSR12 src/
31
+ vendor/bin/phpstan analyze
32
+ vendor/bin/phpunit
33
+ ```
34
+
35
+ ## Best Practices
36
+
37
+ ✅ Use service manager
38
+ ✅ Implement middleware
39
+ ✅ Use form validation
40
+
41
+ ❌ Don't skip CSRF tokens
42
+ ❌ Don't expose errors in production
43
+
44
+ <!-- ZEND:END -->
45
+
@@ -1,47 +1,47 @@
1
- ---
2
- name: "Copilot"
3
- description: "Tool: GitHub's AI pair programmer (inline + chat)"
4
- version: "1.0.0"
5
- category: "ides"
6
- author: "Rulebook"
7
- tags: ["ides", "ide"]
8
- dependencies: []
9
- conflicts: []
10
- ---
11
- <!-- COPILOT:START -->
12
- # GitHub Copilot Rules
13
-
14
- **Tool**: GitHub's AI pair programmer (inline + chat)
15
-
16
- ## Quick Start
17
-
18
- Copilot reads:
19
- - `.github/copilot-instructions.md` (generated by `rulebook init`)
20
- - Workspace context (open files)
21
-
22
- ## Usage
23
-
24
- ```bash
25
- # In Copilot Chat:
26
- "Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
27
-
28
- # Inline suggestions:
29
- Accept/reject based on AGENTS.md standards
30
- ```
31
-
32
- ## Modes
33
-
34
- **Inline Completions**: Context-aware suggestions while typing
35
- **Copilot Chat**: Ask questions, request implementations
36
- **Workspace Agent** (Labs): Multi-file autonomous mode
37
-
38
- ## Workflow
39
-
40
- 1. Rulebook generates `.github/copilot-instructions.md` → references AGENTS.md
41
- 2. Keep AGENTS.md open for context
42
- 3. Use `@workspace` to include project context
43
- 4. Reference `@AGENTS.md` explicitly in chat
44
-
45
- **Critical**: Generated `copilot-instructions.md` points Copilot to AGENTS.md standards.
46
-
47
- <!-- COPILOT:END -->
1
+ ---
2
+ name: "Copilot"
3
+ description: "Tool: GitHub's AI pair programmer (inline + chat)"
4
+ version: "1.0.0"
5
+ category: "ides"
6
+ author: "Rulebook"
7
+ tags: ["ides", "ide"]
8
+ dependencies: []
9
+ conflicts: []
10
+ ---
11
+ <!-- COPILOT:START -->
12
+ # GitHub Copilot Rules
13
+
14
+ **Tool**: GitHub's AI pair programmer (inline + chat)
15
+
16
+ ## Quick Start
17
+
18
+ Copilot reads:
19
+ - `.github/copilot-instructions.md` (generated by `rulebook init`)
20
+ - Workspace context (open files)
21
+
22
+ ## Usage
23
+
24
+ ```bash
25
+ # In Copilot Chat:
26
+ "Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
27
+
28
+ # Inline suggestions:
29
+ Accept/reject based on AGENTS.md standards
30
+ ```
31
+
32
+ ## Modes
33
+
34
+ **Inline Completions**: Context-aware suggestions while typing
35
+ **Copilot Chat**: Ask questions, request implementations
36
+ **Workspace Agent** (Labs): Multi-file autonomous mode
37
+
38
+ ## Workflow
39
+
40
+ 1. Rulebook generates `.github/copilot-instructions.md` → references AGENTS.md
41
+ 2. Keep AGENTS.md open for context
42
+ 3. Use `@workspace` to include project context
43
+ 4. Reference `@AGENTS.md` explicitly in chat
44
+
45
+ **Critical**: Generated `copilot-instructions.md` points Copilot to AGENTS.md standards.
46
+
47
+ <!-- COPILOT:END -->