@hivehub/rulebook 4.2.2 → 4.3.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/README.md +8 -1
  19. package/dist/cli/commands.d.ts.map +1 -1
  20. package/dist/cli/commands.js +4 -4
  21. package/dist/cli/commands.js.map +1 -1
  22. package/dist/core/claude-mcp.d.ts +8 -1
  23. package/dist/core/claude-mcp.d.ts.map +1 -1
  24. package/dist/core/claude-mcp.js +32 -1
  25. package/dist/core/claude-mcp.js.map +1 -1
  26. package/dist/core/generator.d.ts +13 -0
  27. package/dist/core/generator.d.ts.map +1 -1
  28. package/dist/core/generator.js +283 -28
  29. package/dist/core/generator.js.map +1 -1
  30. package/dist/core/workspace/workspace-manager.d.ts.map +1 -1
  31. package/dist/core/workspace/workspace-manager.js +2 -6
  32. package/dist/core/workspace/workspace-manager.js.map +1 -1
  33. package/dist/index.js +1 -3
  34. package/dist/index.js.map +1 -1
  35. package/dist/mcp/rulebook-server.d.ts.map +1 -1
  36. package/dist/mcp/rulebook-server.js +5 -4
  37. package/dist/mcp/rulebook-server.js.map +1 -1
  38. package/package.json +21 -22
  39. package/templates/agents/accessibility-reviewer.md +43 -0
  40. package/templates/agents/api-designer.md +42 -0
  41. package/templates/agents/architect.md +51 -0
  42. package/templates/agents/build-engineer.md +36 -0
  43. package/templates/agents/code-reviewer.md +47 -0
  44. package/templates/agents/database-architect.md +41 -0
  45. package/templates/agents/devops-engineer.md +42 -0
  46. package/templates/agents/docs-writer.md +38 -0
  47. package/templates/agents/i18n-engineer.md +42 -0
  48. package/templates/agents/implementer.md +38 -35
  49. package/templates/agents/migration-engineer.md +42 -0
  50. package/templates/agents/performance-engineer.md +49 -0
  51. package/templates/agents/refactoring-agent.md +41 -0
  52. package/templates/agents/researcher.md +38 -34
  53. package/templates/agents/security-reviewer.md +40 -0
  54. package/templates/agents/team-lead.md +37 -34
  55. package/templates/agents/tester.md +45 -42
  56. package/templates/agents/ux-reviewer.md +43 -0
  57. package/templates/ci/rulebook-review.yml +26 -26
  58. package/templates/cli/AIDER.md +49 -49
  59. package/templates/cli/AMAZON_Q.md +25 -25
  60. package/templates/cli/AUGGIE.md +32 -32
  61. package/templates/cli/CLAUDE.md +117 -117
  62. package/templates/cli/CLINE.md +99 -99
  63. package/templates/cli/CODEBUDDY.md +20 -20
  64. package/templates/cli/CODEIUM.md +20 -20
  65. package/templates/cli/CODEX.md +21 -21
  66. package/templates/cli/CONTINUE.md +34 -34
  67. package/templates/cli/CURSOR_CLI.md +62 -62
  68. package/templates/cli/FACTORY.md +18 -18
  69. package/templates/cli/GEMINI.md +35 -35
  70. package/templates/cli/KILOCODE.md +18 -18
  71. package/templates/cli/OPENCODE.md +18 -18
  72. package/templates/cli/_GENERIC_TEMPLATE.md +29 -29
  73. package/templates/commands/rulebook-memory-save.md +48 -48
  74. package/templates/commands/rulebook-memory-search.md +47 -47
  75. package/templates/commands/rulebook-task-apply.md +67 -67
  76. package/templates/commands/rulebook-task-archive.md +94 -94
  77. package/templates/commands/rulebook-task-create.md +93 -93
  78. package/templates/commands/rulebook-task-list.md +42 -42
  79. package/templates/commands/rulebook-task-show.md +52 -52
  80. package/templates/commands/rulebook-task-validate.md +53 -53
  81. package/templates/core/AGENTS_LEAN.md +25 -25
  82. package/templates/core/AGENTS_OVERRIDE.md +16 -16
  83. package/templates/core/AGENT_AUTOMATION.md +288 -288
  84. package/templates/core/DAG.md +304 -304
  85. package/templates/core/DOCUMENTATION_RULES.md +36 -36
  86. package/templates/core/MULTI_AGENT.md +74 -74
  87. package/templates/core/PLANS.md +28 -28
  88. package/templates/core/QUALITY_ENFORCEMENT.md +68 -68
  89. package/templates/core/RALPH.md +471 -471
  90. package/templates/core/RULEBOOK.md +1935 -1935
  91. package/templates/frameworks/ANGULAR.md +36 -36
  92. package/templates/frameworks/DJANGO.md +83 -83
  93. package/templates/frameworks/ELECTRON.md +147 -147
  94. package/templates/frameworks/FLASK.md +38 -38
  95. package/templates/frameworks/FLUTTER.md +55 -55
  96. package/templates/frameworks/JQUERY.md +32 -32
  97. package/templates/frameworks/LARAVEL.md +38 -38
  98. package/templates/frameworks/NESTJS.md +43 -43
  99. package/templates/frameworks/NEXTJS.md +127 -127
  100. package/templates/frameworks/NUXT.md +40 -40
  101. package/templates/frameworks/RAILS.md +66 -66
  102. package/templates/frameworks/REACT.md +38 -38
  103. package/templates/frameworks/REACT_NATIVE.md +47 -47
  104. package/templates/frameworks/SPRING.md +39 -39
  105. package/templates/frameworks/SYMFONY.md +36 -36
  106. package/templates/frameworks/VUE.md +36 -36
  107. package/templates/frameworks/ZEND.md +35 -35
  108. package/templates/git/CI_CD_PATTERNS.md +661 -661
  109. package/templates/git/GITHUB_ACTIONS.md +728 -728
  110. package/templates/git/GITLAB_CI.md +730 -730
  111. package/templates/git/GIT_WORKFLOW.md +1157 -1157
  112. package/templates/git/SECRETS_MANAGEMENT.md +585 -585
  113. package/templates/hooks/COMMIT_MSG.md +530 -530
  114. package/templates/hooks/POST_CHECKOUT.md +546 -546
  115. package/templates/hooks/PREPARE_COMMIT_MSG.md +619 -619
  116. package/templates/hooks/PRE_COMMIT.md +414 -414
  117. package/templates/hooks/PRE_PUSH.md +601 -601
  118. package/templates/ides/CONTINUE_RULES.md +16 -16
  119. package/templates/ides/COPILOT.md +37 -37
  120. package/templates/ides/COPILOT_INSTRUCTIONS.md +23 -23
  121. package/templates/ides/CURSOR.md +43 -43
  122. package/templates/ides/GEMINI_RULES.md +17 -17
  123. package/templates/ides/JETBRAINS_AI.md +35 -35
  124. package/templates/ides/REPLIT.md +36 -36
  125. package/templates/ides/TABNINE.md +29 -29
  126. package/templates/ides/VSCODE.md +40 -40
  127. package/templates/ides/WINDSURF.md +36 -36
  128. package/templates/ides/WINDSURF_RULES.md +14 -14
  129. package/templates/ides/ZED.md +32 -32
  130. package/templates/ides/cursor-mdc/go.mdc +24 -24
  131. package/templates/ides/cursor-mdc/python.mdc +24 -24
  132. package/templates/ides/cursor-mdc/quality.mdc +25 -25
  133. package/templates/ides/cursor-mdc/ralph.mdc +39 -39
  134. package/templates/ides/cursor-mdc/rulebook.mdc +38 -38
  135. package/templates/ides/cursor-mdc/rust.mdc +24 -24
  136. package/templates/ides/cursor-mdc/typescript.mdc +25 -25
  137. package/templates/languages/C.md +333 -333
  138. package/templates/languages/CPP.md +743 -743
  139. package/templates/languages/CSHARP.md +417 -417
  140. package/templates/languages/ELIXIR.md +454 -454
  141. package/templates/languages/ERLANG.md +361 -361
  142. package/templates/languages/GO.md +645 -645
  143. package/templates/languages/HASKELL.md +177 -177
  144. package/templates/languages/JAVA.md +607 -607
  145. package/templates/languages/JAVASCRIPT.md +631 -631
  146. package/templates/languages/JULIA.md +97 -97
  147. package/templates/languages/KOTLIN.md +511 -511
  148. package/templates/languages/LISP.md +100 -100
  149. package/templates/languages/LUA.md +74 -74
  150. package/templates/languages/OBJECTIVEC.md +90 -90
  151. package/templates/languages/PHP.md +416 -416
  152. package/templates/languages/PYTHON.md +682 -682
  153. package/templates/languages/RUBY.md +421 -421
  154. package/templates/languages/RUST.md +477 -477
  155. package/templates/languages/SAS.md +73 -73
  156. package/templates/languages/SCALA.md +348 -348
  157. package/templates/languages/SOLIDITY.md +580 -580
  158. package/templates/languages/SQL.md +137 -137
  159. package/templates/languages/SWIFT.md +466 -466
  160. package/templates/languages/TYPESCRIPT.md +591 -591
  161. package/templates/languages/ZIG.md +265 -265
  162. package/templates/modules/ATLASSIAN.md +255 -255
  163. package/templates/modules/CONTEXT7.md +54 -54
  164. package/templates/modules/FIGMA.md +267 -267
  165. package/templates/modules/GITHUB_MCP.md +64 -64
  166. package/templates/modules/GRAFANA.md +328 -328
  167. package/templates/modules/MEMORY.md +126 -126
  168. package/templates/modules/NOTION.md +247 -247
  169. package/templates/modules/PLAYWRIGHT.md +90 -90
  170. package/templates/modules/RULEBOOK_MCP.md +156 -156
  171. package/templates/modules/SERENA.md +337 -337
  172. package/templates/modules/SUPABASE.md +223 -223
  173. package/templates/modules/SYNAP.md +69 -69
  174. package/templates/modules/VECTORIZER.md +63 -63
  175. package/templates/modules/sequential-thinking.md +42 -42
  176. package/templates/ralph/ralph-history.bat +4 -4
  177. package/templates/ralph/ralph-history.sh +5 -5
  178. package/templates/ralph/ralph-init.bat +5 -5
  179. package/templates/ralph/ralph-init.sh +5 -5
  180. package/templates/ralph/ralph-pause.bat +5 -5
  181. package/templates/ralph/ralph-pause.sh +5 -5
  182. package/templates/ralph/ralph-run.bat +5 -5
  183. package/templates/ralph/ralph-run.sh +5 -5
  184. package/templates/ralph/ralph-status.bat +4 -4
  185. package/templates/ralph/ralph-status.sh +5 -5
  186. package/templates/services/AZURE_BLOB.md +184 -184
  187. package/templates/services/CASSANDRA.md +239 -239
  188. package/templates/services/DATADOG.md +26 -26
  189. package/templates/services/DOCKER.md +124 -124
  190. package/templates/services/DOCKER_COMPOSE.md +168 -168
  191. package/templates/services/DYNAMODB.md +308 -308
  192. package/templates/services/ELASTICSEARCH.md +347 -347
  193. package/templates/services/GCS.md +178 -178
  194. package/templates/services/HELM.md +194 -194
  195. package/templates/services/INFLUXDB.md +265 -265
  196. package/templates/services/KAFKA.md +341 -341
  197. package/templates/services/KUBERNETES.md +208 -208
  198. package/templates/services/MARIADB.md +183 -183
  199. package/templates/services/MEMCACHED.md +242 -242
  200. package/templates/services/MINIO.md +201 -201
  201. package/templates/services/MONGODB.md +268 -268
  202. package/templates/services/MYSQL.md +358 -358
  203. package/templates/services/NEO4J.md +247 -247
  204. package/templates/services/OPENTELEMETRY.md +25 -25
  205. package/templates/services/ORACLE.md +290 -290
  206. package/templates/services/PINO.md +24 -24
  207. package/templates/services/POSTGRESQL.md +326 -326
  208. package/templates/services/PROMETHEUS.md +33 -33
  209. package/templates/services/RABBITMQ.md +286 -286
  210. package/templates/services/REDIS.md +292 -292
  211. package/templates/services/S3.md +298 -298
  212. package/templates/services/SENTRY.md +23 -23
  213. package/templates/services/SQLITE.md +294 -294
  214. package/templates/services/SQLSERVER.md +294 -294
  215. package/templates/services/WINSTON.md +30 -30
  216. package/templates/skills/cli/aider/SKILL.md +59 -59
  217. package/templates/skills/cli/amazon-q/SKILL.md +35 -35
  218. package/templates/skills/cli/auggie/SKILL.md +42 -42
  219. package/templates/skills/cli/claude/SKILL.md +42 -42
  220. package/templates/skills/cli/cline/SKILL.md +42 -42
  221. package/templates/skills/cli/codebuddy/SKILL.md +30 -30
  222. package/templates/skills/cli/codeium/SKILL.md +30 -30
  223. package/templates/skills/cli/codex/SKILL.md +31 -31
  224. package/templates/skills/cli/continue/SKILL.md +44 -44
  225. package/templates/skills/cli/cursor-cli/SKILL.md +38 -38
  226. package/templates/skills/cli/factory/SKILL.md +28 -28
  227. package/templates/skills/cli/gemini/SKILL.md +45 -45
  228. package/templates/skills/cli/kilocode/SKILL.md +28 -28
  229. package/templates/skills/cli/opencode/SKILL.md +28 -28
  230. package/templates/skills/core/agent-automation/SKILL.md +194 -194
  231. package/templates/skills/core/dag/SKILL.md +314 -314
  232. package/templates/skills/core/documentation-rules/SKILL.md +46 -46
  233. package/templates/skills/core/quality-enforcement/SKILL.md +78 -78
  234. package/templates/skills/core/rulebook/SKILL.md +176 -176
  235. package/templates/skills/dev/accessibility/SKILL.md +17 -0
  236. package/templates/skills/dev/api-design/SKILL.md +15 -0
  237. package/templates/skills/dev/architect/SKILL.md +17 -0
  238. package/templates/skills/dev/build-fix/SKILL.md +17 -0
  239. package/templates/skills/dev/db-design/SKILL.md +15 -0
  240. package/templates/skills/dev/debug/SKILL.md +16 -0
  241. package/templates/skills/dev/deploy/SKILL.md +17 -0
  242. package/templates/skills/dev/docs/SKILL.md +17 -0
  243. package/templates/skills/dev/migrate/SKILL.md +15 -0
  244. package/templates/skills/dev/perf/SKILL.md +17 -0
  245. package/templates/skills/dev/refactor/SKILL.md +17 -0
  246. package/templates/skills/dev/research/SKILL.md +14 -0
  247. package/templates/skills/dev/review/SKILL.md +18 -0
  248. package/templates/skills/dev/security-audit/SKILL.md +17 -0
  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,100 +1,100 @@
1
- <!-- LISP:START -->
2
- # Common Lisp Project Rules
3
-
4
- ## Agent Automation Commands
5
-
6
- **CRITICAL**: Execute these commands after EVERY implementation (see AGENT_AUTOMATION module for full workflow).
7
-
8
- ```bash
9
- # Complete quality check sequence:
10
- sbcl --eval '(ql:quickload :sblint)' --eval '(sblint:run-lint "src/")' # Linting
11
- sbcl --load tests/run-tests.lisp # All tests
12
- sbcl --eval '(asdf:make :your-system)' # Build with ASDF
13
- ```
14
-
15
- ## Common Lisp Configuration
16
-
17
- **CRITICAL**: Use SBCL 2.3+ or CCL with ASDF3 and modern tooling.
18
-
19
- - **Implementation**: SBCL 2.3+ (recommended) or CCL
20
- - **Build System**: ASDF3
21
- - **Testing**: FiveAM or Prove
22
- - **Linter**: sblint
23
-
24
- ### System Definition (your-system.asd)
25
-
26
- ```lisp
27
- (defsystem "your-system"
28
- :description "Your system description"
29
- :version "0.1.0"
30
- :author "Your Name <you@example.com>"
31
- :license "MIT"
32
- :depends-on (:alexandria
33
- :cl-ppcre
34
- :str)
35
- :components ((:module "src"
36
- :components
37
- ((:file "package")
38
- (:file "main" :depends-on ("package")))))
39
- :in-order-to ((test-op (test-op "your-system/tests"))))
40
-
41
- (defsystem "your-system/tests"
42
- :depends-on ("your-system"
43
- "fiveam")
44
- :components ((:module "tests"
45
- :components
46
- ((:file "package")
47
- (:file "main-tests" :depends-on ("package")))))
48
- :perform (test-op (o c) (symbol-call :fiveam :run! :your-system-tests)))
49
- ```
50
-
51
- ## Code Quality Standards
52
-
53
- ### Mandatory Quality Checks
54
-
55
- **IMPORTANT**: These commands MUST match your GitHub Actions workflows!
56
-
57
- ```bash
58
- # Pre-Commit Checklist (MUST match .github/workflows/*.yml)
59
-
60
- # 1. Lint (matches workflow)
61
- sblint your-system.asd
62
-
63
- # 2. Load system (check for errors - matches workflow)
64
- sbcl --non-interactive --load your-system.asd \
65
- --eval '(ql:quickload :your-system)' \
66
- --eval '(quit)'
67
-
68
- # 3. Run tests (matches workflow)
69
- sbcl --non-interactive \
70
- --eval '(ql:quickload :your-system/tests)' \
71
- --eval '(asdf:test-system :your-system)' \
72
- --eval '(quit)'
73
-
74
- # If ANY fails: ❌ DO NOT COMMIT - Fix first!
75
- ```
76
-
77
- ### Testing Example (FiveAM)
78
-
79
- ```lisp
80
- (in-package :your-system/tests)
81
-
82
- (def-suite your-system-tests
83
- :description "Main test suite")
84
-
85
- (in-suite your-system-tests)
86
-
87
- (test process-data-test
88
- "Test data processing"
89
- (is (equal '(2 4 6) (process-data '(1 2 3))))
90
- (is (null (process-data '())))
91
- (signals error (process-data nil)))
92
-
93
- (test validate-input-test
94
- "Test input validation"
95
- (is-true (validate-input "test"))
96
- (is-false (validate-input "")))
97
- ```
98
-
99
- <!-- LISP:END -->
100
-
1
+ <!-- LISP:START -->
2
+ # Common Lisp Project Rules
3
+
4
+ ## Agent Automation Commands
5
+
6
+ **CRITICAL**: Execute these commands after EVERY implementation (see AGENT_AUTOMATION module for full workflow).
7
+
8
+ ```bash
9
+ # Complete quality check sequence:
10
+ sbcl --eval '(ql:quickload :sblint)' --eval '(sblint:run-lint "src/")' # Linting
11
+ sbcl --load tests/run-tests.lisp # All tests
12
+ sbcl --eval '(asdf:make :your-system)' # Build with ASDF
13
+ ```
14
+
15
+ ## Common Lisp Configuration
16
+
17
+ **CRITICAL**: Use SBCL 2.3+ or CCL with ASDF3 and modern tooling.
18
+
19
+ - **Implementation**: SBCL 2.3+ (recommended) or CCL
20
+ - **Build System**: ASDF3
21
+ - **Testing**: FiveAM or Prove
22
+ - **Linter**: sblint
23
+
24
+ ### System Definition (your-system.asd)
25
+
26
+ ```lisp
27
+ (defsystem "your-system"
28
+ :description "Your system description"
29
+ :version "0.1.0"
30
+ :author "Your Name <you@example.com>"
31
+ :license "MIT"
32
+ :depends-on (:alexandria
33
+ :cl-ppcre
34
+ :str)
35
+ :components ((:module "src"
36
+ :components
37
+ ((:file "package")
38
+ (:file "main" :depends-on ("package")))))
39
+ :in-order-to ((test-op (test-op "your-system/tests"))))
40
+
41
+ (defsystem "your-system/tests"
42
+ :depends-on ("your-system"
43
+ "fiveam")
44
+ :components ((:module "tests"
45
+ :components
46
+ ((:file "package")
47
+ (:file "main-tests" :depends-on ("package")))))
48
+ :perform (test-op (o c) (symbol-call :fiveam :run! :your-system-tests)))
49
+ ```
50
+
51
+ ## Code Quality Standards
52
+
53
+ ### Mandatory Quality Checks
54
+
55
+ **IMPORTANT**: These commands MUST match your GitHub Actions workflows!
56
+
57
+ ```bash
58
+ # Pre-Commit Checklist (MUST match .github/workflows/*.yml)
59
+
60
+ # 1. Lint (matches workflow)
61
+ sblint your-system.asd
62
+
63
+ # 2. Load system (check for errors - matches workflow)
64
+ sbcl --non-interactive --load your-system.asd \
65
+ --eval '(ql:quickload :your-system)' \
66
+ --eval '(quit)'
67
+
68
+ # 3. Run tests (matches workflow)
69
+ sbcl --non-interactive \
70
+ --eval '(ql:quickload :your-system/tests)' \
71
+ --eval '(asdf:test-system :your-system)' \
72
+ --eval '(quit)'
73
+
74
+ # If ANY fails: ❌ DO NOT COMMIT - Fix first!
75
+ ```
76
+
77
+ ### Testing Example (FiveAM)
78
+
79
+ ```lisp
80
+ (in-package :your-system/tests)
81
+
82
+ (def-suite your-system-tests
83
+ :description "Main test suite")
84
+
85
+ (in-suite your-system-tests)
86
+
87
+ (test process-data-test
88
+ "Test data processing"
89
+ (is (equal '(2 4 6) (process-data '(1 2 3))))
90
+ (is (null (process-data '())))
91
+ (signals error (process-data nil)))
92
+
93
+ (test validate-input-test
94
+ "Test input validation"
95
+ (is-true (validate-input "test"))
96
+ (is-false (validate-input "")))
97
+ ```
98
+
99
+ <!-- LISP:END -->
100
+
@@ -1,74 +1,74 @@
1
- <!-- LUA:START -->
2
- # Lua Project Rules
3
-
4
- ## Agent Automation Commands
5
-
6
- **CRITICAL**: Execute these commands after EVERY implementation (see AGENT_AUTOMATION module for full workflow).
7
-
8
- ```bash
9
- # Complete quality check sequence:
10
- stylua --check . # Format check
11
- luacheck . # Linting
12
- busted # All tests (100% pass)
13
-
14
- # No standard security audit for Lua
15
- ```
16
-
17
- ## Lua Configuration
18
-
19
- **CRITICAL**: Use Lua 5.4 or LuaJIT with linting.
20
-
21
- - **Version**: Lua 5.4 or LuaJIT 2.1+
22
- - **Linter**: luacheck
23
- - **Formatter**: StyLua
24
- - **Testing**: busted or luaunit
25
-
26
- ## Code Quality Standards
27
-
28
- ### Mandatory Quality Checks
29
-
30
- **IMPORTANT**: These commands MUST match your GitHub Actions workflows!
31
-
32
- ```bash
33
- # Pre-Commit Checklist (MUST match .github/workflows/*.yml)
34
-
35
- # 1. Format check (matches workflow)
36
- stylua --check src/ tests/
37
-
38
- # 2. Lint (matches workflow)
39
- luacheck src/ tests/ --std luajit --no-unused-args
40
-
41
- # 3. Run tests (matches workflow)
42
- busted tests/
43
-
44
- # If ANY fails: ❌ DO NOT COMMIT - Fix first!
45
- ```
46
-
47
- **Why This Matters:**
48
- - Example: Using `stylua` (writes) locally but `stylua --check` in CI = failure
49
-
50
- ### Testing Example (busted)
51
-
52
- ```lua
53
- describe("DataProcessor", function()
54
- local processor
55
-
56
- before_each(function()
57
- processor = require("data_processor").new()
58
- end)
59
-
60
- it("processes valid input", function()
61
- local result = processor:process({1, 2, 3})
62
- assert.are.same({2, 4, 6}, result)
63
- end)
64
-
65
- it("handles empty input", function()
66
- assert.has_no.errors(function()
67
- processor:process({})
68
- end)
69
- end)
70
- end)
71
- ```
72
-
73
- <!-- LUA:END -->
74
-
1
+ <!-- LUA:START -->
2
+ # Lua Project Rules
3
+
4
+ ## Agent Automation Commands
5
+
6
+ **CRITICAL**: Execute these commands after EVERY implementation (see AGENT_AUTOMATION module for full workflow).
7
+
8
+ ```bash
9
+ # Complete quality check sequence:
10
+ stylua --check . # Format check
11
+ luacheck . # Linting
12
+ busted # All tests (100% pass)
13
+
14
+ # No standard security audit for Lua
15
+ ```
16
+
17
+ ## Lua Configuration
18
+
19
+ **CRITICAL**: Use Lua 5.4 or LuaJIT with linting.
20
+
21
+ - **Version**: Lua 5.4 or LuaJIT 2.1+
22
+ - **Linter**: luacheck
23
+ - **Formatter**: StyLua
24
+ - **Testing**: busted or luaunit
25
+
26
+ ## Code Quality Standards
27
+
28
+ ### Mandatory Quality Checks
29
+
30
+ **IMPORTANT**: These commands MUST match your GitHub Actions workflows!
31
+
32
+ ```bash
33
+ # Pre-Commit Checklist (MUST match .github/workflows/*.yml)
34
+
35
+ # 1. Format check (matches workflow)
36
+ stylua --check src/ tests/
37
+
38
+ # 2. Lint (matches workflow)
39
+ luacheck src/ tests/ --std luajit --no-unused-args
40
+
41
+ # 3. Run tests (matches workflow)
42
+ busted tests/
43
+
44
+ # If ANY fails: ❌ DO NOT COMMIT - Fix first!
45
+ ```
46
+
47
+ **Why This Matters:**
48
+ - Example: Using `stylua` (writes) locally but `stylua --check` in CI = failure
49
+
50
+ ### Testing Example (busted)
51
+
52
+ ```lua
53
+ describe("DataProcessor", function()
54
+ local processor
55
+
56
+ before_each(function()
57
+ processor = require("data_processor").new()
58
+ end)
59
+
60
+ it("processes valid input", function()
61
+ local result = processor:process({1, 2, 3})
62
+ assert.are.same({2, 4, 6}, result)
63
+ end)
64
+
65
+ it("handles empty input", function()
66
+ assert.has_no.errors(function()
67
+ processor:process({})
68
+ end)
69
+ end)
70
+ end)
71
+ ```
72
+
73
+ <!-- LUA:END -->
74
+
@@ -1,90 +1,90 @@
1
- <!-- OBJECTIVEC:START -->
2
- # Objective-C Project Rules
3
-
4
- ## Agent Automation Commands
5
-
6
- **CRITICAL**: Execute these commands after EVERY implementation (see AGENT_AUTOMATION module for full workflow).
7
-
8
- ```bash
9
- # Complete quality check sequence:
10
- xcodebuild clean build # Build verification
11
- xcodebuild test -scheme YourScheme # All tests
12
- # clang static analyzer runs automatically in Xcode builds
13
-
14
- # Security audit:
15
- # Use Xcode's built-in analyzer or third-party tools
16
- ```
17
-
18
- ## Objective-C Configuration
19
-
20
- **CRITICAL**: Use Modern Objective-C with ARC and strict warnings.
21
-
22
- - **Version**: Xcode 15+
23
- - **ARC**: Automatic Reference Counting required
24
- - **Formatter**: clang-format
25
- - **Testing**: XCTest
26
- - **Analyzer**: clang static analyzer
27
-
28
- ## Code Quality Standards
29
-
30
- ### Mandatory Quality Checks
31
-
32
- **IMPORTANT**: These commands MUST match your GitHub Actions workflows!
33
-
34
- ```bash
35
- # Pre-Commit Checklist (MUST match .github/workflows/*.yml)
36
-
37
- # 1. Format check (matches workflow)
38
- clang-format --dry-run --Werror **/*.{h,m}
39
-
40
- # 2. Static analysis (matches workflow)
41
- xcodebuild analyze -scheme YourScheme -sdk iphonesimulator
42
-
43
- # 3. Build (matches workflow)
44
- xcodebuild build -scheme YourScheme -sdk iphonesimulator \
45
- ONLY_ACTIVE_ARCH=NO CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO
46
-
47
- # 4. Run tests (matches workflow)
48
- xcodebuild test -scheme YourScheme -sdk iphonesimulator \
49
- -destination 'platform=iOS Simulator,name=iPhone 15'
50
-
51
- # If ANY fails: ❌ DO NOT COMMIT - Fix first!
52
- ```
53
-
54
- **Why This Matters:**
55
- - Example: Using `clang-format -i` locally but `--dry-run` in CI = failure
56
-
57
- ### Testing Example (XCTest)
58
-
59
- ```objective-c
60
- @import XCTest;
61
- #import "DataProcessor.h"
62
-
63
- @interface DataProcessorTests : XCTestCase
64
- @property (nonatomic, strong) DataProcessor *processor;
65
- @end
66
-
67
- @implementation DataProcessorTests
68
-
69
- - (void)setUp {
70
- [super setUp];
71
- self.processor = [[DataProcessor alloc] initWithThreshold:0.5];
72
- }
73
-
74
- - (void)testProcessValidInput {
75
- NSArray *input = @[@1, @2, @3];
76
- NSArray *result = [self.processor process:input];
77
-
78
- XCTAssertNotNil(result);
79
- XCTAssertGreaterThan(result.count, 0);
80
- }
81
-
82
- - (void)testProcessHandlesNil {
83
- XCTAssertThrows([self.processor process:nil]);
84
- }
85
-
86
- @end
87
- ```
88
-
89
- <!-- OBJECTIVEC:END -->
90
-
1
+ <!-- OBJECTIVEC:START -->
2
+ # Objective-C Project Rules
3
+
4
+ ## Agent Automation Commands
5
+
6
+ **CRITICAL**: Execute these commands after EVERY implementation (see AGENT_AUTOMATION module for full workflow).
7
+
8
+ ```bash
9
+ # Complete quality check sequence:
10
+ xcodebuild clean build # Build verification
11
+ xcodebuild test -scheme YourScheme # All tests
12
+ # clang static analyzer runs automatically in Xcode builds
13
+
14
+ # Security audit:
15
+ # Use Xcode's built-in analyzer or third-party tools
16
+ ```
17
+
18
+ ## Objective-C Configuration
19
+
20
+ **CRITICAL**: Use Modern Objective-C with ARC and strict warnings.
21
+
22
+ - **Version**: Xcode 15+
23
+ - **ARC**: Automatic Reference Counting required
24
+ - **Formatter**: clang-format
25
+ - **Testing**: XCTest
26
+ - **Analyzer**: clang static analyzer
27
+
28
+ ## Code Quality Standards
29
+
30
+ ### Mandatory Quality Checks
31
+
32
+ **IMPORTANT**: These commands MUST match your GitHub Actions workflows!
33
+
34
+ ```bash
35
+ # Pre-Commit Checklist (MUST match .github/workflows/*.yml)
36
+
37
+ # 1. Format check (matches workflow)
38
+ clang-format --dry-run --Werror **/*.{h,m}
39
+
40
+ # 2. Static analysis (matches workflow)
41
+ xcodebuild analyze -scheme YourScheme -sdk iphonesimulator
42
+
43
+ # 3. Build (matches workflow)
44
+ xcodebuild build -scheme YourScheme -sdk iphonesimulator \
45
+ ONLY_ACTIVE_ARCH=NO CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO
46
+
47
+ # 4. Run tests (matches workflow)
48
+ xcodebuild test -scheme YourScheme -sdk iphonesimulator \
49
+ -destination 'platform=iOS Simulator,name=iPhone 15'
50
+
51
+ # If ANY fails: ❌ DO NOT COMMIT - Fix first!
52
+ ```
53
+
54
+ **Why This Matters:**
55
+ - Example: Using `clang-format -i` locally but `--dry-run` in CI = failure
56
+
57
+ ### Testing Example (XCTest)
58
+
59
+ ```objective-c
60
+ @import XCTest;
61
+ #import "DataProcessor.h"
62
+
63
+ @interface DataProcessorTests : XCTestCase
64
+ @property (nonatomic, strong) DataProcessor *processor;
65
+ @end
66
+
67
+ @implementation DataProcessorTests
68
+
69
+ - (void)setUp {
70
+ [super setUp];
71
+ self.processor = [[DataProcessor alloc] initWithThreshold:0.5];
72
+ }
73
+
74
+ - (void)testProcessValidInput {
75
+ NSArray *input = @[@1, @2, @3];
76
+ NSArray *result = [self.processor process:input];
77
+
78
+ XCTAssertNotNil(result);
79
+ XCTAssertGreaterThan(result.count, 0);
80
+ }
81
+
82
+ - (void)testProcessHandlesNil {
83
+ XCTAssertThrows([self.processor process:nil]);
84
+ }
85
+
86
+ @end
87
+ ```
88
+
89
+ <!-- OBJECTIVEC:END -->
90
+