@the-bearded-bear/claude-craft 9.2.0 → 9.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 (557) hide show
  1. package/Dev/i18n/base/Angular/rules/00-project-context.md.template +1 -1
  2. package/Dev/i18n/base/Angular/rules/03-coding-standards.md +17 -16
  3. package/Dev/i18n/base/Angular/rules/06-tooling.md +2 -2
  4. package/Dev/i18n/base/CSharp/rules/06-tooling.md +8 -6
  5. package/Dev/i18n/base/Common/hooks/scripts/block-dangerous-commands.sh +93 -48
  6. package/Dev/i18n/base/Common/hooks/scripts/guard-network.sh +58 -0
  7. package/Dev/i18n/base/Common/hooks/scripts/lib/hook-io.sh +181 -0
  8. package/Dev/i18n/base/Common/hooks/scripts/notify-slack.sh +21 -32
  9. package/Dev/i18n/base/Common/hooks/scripts/output-filter.sh +23 -0
  10. package/Dev/i18n/base/Common/hooks/scripts/output-size-hint.sh +19 -0
  11. package/Dev/i18n/base/Common/hooks/scripts/post-edit-lint.sh +29 -53
  12. package/Dev/i18n/base/Common/hooks/scripts/post-tool-failure.sh +50 -0
  13. package/Dev/i18n/base/Common/hooks/scripts/pre-commit-check.sh +59 -63
  14. package/Dev/i18n/base/Common/hooks/scripts/pre-compact.sh +52 -0
  15. package/Dev/i18n/base/Common/hooks/scripts/protect-sensitive-files.sh +16 -0
  16. package/Dev/i18n/base/Common/hooks/scripts/quality-gate.sh +49 -92
  17. package/Dev/i18n/base/Common/hooks/scripts/session-end.sh +51 -0
  18. package/Dev/i18n/base/Common/hooks/scripts/session-init.sh +45 -69
  19. package/Dev/i18n/base/Common/hooks/templates/examples/README.md +59 -0
  20. package/Dev/i18n/base/Common/hooks/templates/examples/auto-format.json +18 -0
  21. package/Dev/i18n/base/Common/hooks/templates/examples/block-dangerous-commands.json +18 -0
  22. package/Dev/i18n/base/Common/hooks/templates/examples/context-reinject.json +28 -0
  23. package/Dev/i18n/base/Common/hooks/templates/examples/output-filter.json +18 -0
  24. package/Dev/i18n/base/Common/hooks/templates/examples/pre-compact.json +18 -0
  25. package/Dev/i18n/base/Common/hooks/templates/examples/protect-files.json +18 -0
  26. package/Dev/i18n/base/Common/hooks/templates/examples/security-block.json +18 -0
  27. package/Dev/i18n/base/Common/hooks/templates/examples/stop-hook.json +16 -0
  28. package/Dev/i18n/base/Common/hooks/templates/examples/user-prompt-submit.json +16 -0
  29. package/Dev/i18n/base/Common/hooks/templates/hooks.default.json +72 -0
  30. package/Dev/i18n/base/Common/hooks/templates/{settings-hooks.json → hooks.full.json} +22 -23
  31. package/Dev/i18n/base/Common/hooks/templates/hooks.memory.json +62 -0
  32. package/Dev/i18n/base/Common/templates/AGENTS.md.template +1 -1
  33. package/Dev/i18n/base/Common/templates/settings.json.template +46 -0
  34. package/Dev/i18n/base/Flutter/rules/00-project-context.md.template +9 -9
  35. package/Dev/i18n/base/Laravel/checks/code-quality.md +1 -1
  36. package/Dev/i18n/base/Laravel/rules/00-project-context.md.template +2 -2
  37. package/Dev/i18n/base/Laravel/rules/06-tooling.md +10 -8
  38. package/Dev/i18n/base/Laravel/rules/07-testing-laravel.md +2 -0
  39. package/Dev/i18n/base/Laravel/rules/08-quality-tools.md +2 -2
  40. package/Dev/i18n/base/PHP/rules/00-project-context.md.template +2 -2
  41. package/Dev/i18n/base/Tauri/rules/02-architecture-tauri.md +1 -0
  42. package/Dev/i18n/base/Vercel/checks/all.md +1 -1
  43. package/Dev/i18n/base/Vercel/checks/architecture.md +1 -1
  44. package/Dev/i18n/base/Vercel/rules/02-architecture-vercel.md +4 -2
  45. package/Dev/i18n/base/Vercel/rules/06-tooling.md +7 -5
  46. package/Dev/i18n/base/Vercel/rules/11-security-vercel.md +1 -1
  47. package/Dev/i18n/base/Vite/rules/06-tooling.md +2 -1
  48. package/Dev/i18n/base/Vite/rules/08-quality-tools.md +1 -1
  49. package/Dev/i18n/base/VueJS/rules/06-tooling.md +3 -3
  50. package/Dev/i18n/base/VueJS/rules/07-testing-vuejs.md +9 -8
  51. package/Dev/i18n/base/VueJS/rules/08-quality-tools.md +1 -1
  52. package/Dev/i18n/base/WordPress/checklists/new-feature.md +59 -0
  53. package/Dev/i18n/base/WordPress/checklists/pre-commit.md +125 -0
  54. package/Dev/i18n/base/WordPress/checks/all.md +257 -0
  55. package/Dev/i18n/base/WordPress/checks/architecture.md +157 -0
  56. package/Dev/i18n/base/WordPress/checks/code-quality.md +158 -0
  57. package/Dev/i18n/base/WordPress/checks/security.md +158 -0
  58. package/Dev/i18n/base/WordPress/checks/testing.md +157 -0
  59. package/Dev/i18n/base/WordPress/commands/check.md +28 -0
  60. package/Dev/i18n/base/WordPress/rules/00-project-context.md.template +169 -0
  61. package/Dev/i18n/base/WordPress/rules/02-architecture-wordpress.md +174 -0
  62. package/Dev/i18n/base/WordPress/rules/03-coding-standards.md +98 -0
  63. package/Dev/i18n/base/WordPress/rules/06-tooling.md +146 -0
  64. package/Dev/i18n/base/WordPress/rules/07-testing-wordpress.md +150 -0
  65. package/Dev/i18n/base/WordPress/rules/08-quality-tools.md +161 -0
  66. package/Dev/i18n/base/WordPress/rules/11-security-wordpress.md +175 -0
  67. package/Dev/i18n/base/WordPress/skills/woocommerce/REFERENCE.md +214 -0
  68. package/Dev/i18n/base/WordPress/skills/woocommerce/SKILL.md +40 -0
  69. package/Dev/i18n/base/WordPress/skills/woocommerce/checklist.md +66 -0
  70. package/Dev/i18n/base/WordPress/templates/block.md +235 -0
  71. package/Dev/i18n/base/WordPress/templates/plugin-bootstrap.md +215 -0
  72. package/Dev/i18n/base/WordPress/templates/rest-endpoint.md +246 -0
  73. package/Dev/i18n/de/Angular/CLAUDE.md.template +2 -1
  74. package/Dev/i18n/de/Angular/agents/angular-reviewer.md +23 -7
  75. package/Dev/i18n/de/Common/agents/devops-engineer.md +1 -1
  76. package/Dev/i18n/de/Common/agents/migration-specialist.md +1 -1
  77. package/Dev/i18n/de/Common/commands/ralph-run.md +3 -3
  78. package/Dev/i18n/de/Common/commands/setup-rtk.md +2 -9
  79. package/Dev/i18n/de/Common/hooks/HOOKS-QUICKSTART.md +33 -45
  80. package/Dev/i18n/de/Common/rules/04-solid-principles.md +2 -2
  81. package/Dev/i18n/de/Common/rules/09-git-workflow.md +7 -1
  82. package/Dev/i18n/de/Common/rules/10-documentation.md +2 -2
  83. package/Dev/i18n/de/Common/rules/11-security.md +12 -12
  84. package/Dev/i18n/de/Common/rules/12-context-management.md +5 -3
  85. package/Dev/i18n/de/Flutter/commands/analyze-performance.md +1 -1
  86. package/Dev/i18n/de/Flutter/rules/06-tooling.md +6 -2
  87. package/Dev/i18n/de/Flutter/rules/11-security-flutter.md +1 -1
  88. package/Dev/i18n/de/PHP/rules/03-coding-standards.md +10 -0
  89. package/Dev/i18n/de/PHP/rules/06-tooling.md +7 -3
  90. package/Dev/i18n/de/Paperclip/CLAUDE.md.template +2 -2
  91. package/Dev/i18n/de/Paperclip/README.md +1 -1
  92. package/Dev/i18n/de/Paperclip/checks/security.md +1 -0
  93. package/Dev/i18n/de/Paperclip/rules/11-security-paperclip.md +3 -1
  94. package/Dev/i18n/de/Python/agents/python-reviewer.md +1 -1
  95. package/Dev/i18n/de/Python/checks/code-quality.md +4 -4
  96. package/Dev/i18n/de/Python/checks/security.md +2 -2
  97. package/Dev/i18n/de/Python/checks/testing.md +2 -2
  98. package/Dev/i18n/de/Python/rules/02-architecture.md +1 -8
  99. package/Dev/i18n/de/Python/rules/03-coding-standards.md +16 -5
  100. package/Dev/i18n/de/Python/templates/repository.md +2 -2
  101. package/Dev/i18n/de/React/rules/02-architecture.md +17 -20
  102. package/Dev/i18n/de/React/rules/03-coding-standards.md +15 -16
  103. package/Dev/i18n/de/React/templates/component.md +11 -9
  104. package/Dev/i18n/de/ReactNative/agents/reactnative-reviewer.md +4 -4
  105. package/Dev/i18n/de/ReactNative/rules/06-tooling.md +15 -14
  106. package/Dev/i18n/de/ReactNative/rules/14-navigation.md +2 -0
  107. package/Dev/i18n/de/Ruby/agents/ruby-reviewer.md +1 -1
  108. package/Dev/i18n/de/Ruby/rules/06-tooling.md +2 -2
  109. package/Dev/i18n/de/Ruby/rules/11-security-ruby.md +13 -1
  110. package/Dev/i18n/de/Rust/rules/03-coding-standards.md +1 -1
  111. package/Dev/i18n/de/Rust/rules/11-security-rust.md +1 -1
  112. package/Dev/i18n/de/Symfony/adr/README.md +1 -1
  113. package/Dev/i18n/de/Symfony/checks/code-quality.md +2 -2
  114. package/Dev/i18n/de/Symfony/rules/03-coding-standards.md +15 -0
  115. package/Dev/i18n/de/Symfony/rules/06-docker-hadolint.md +1 -1
  116. package/Dev/i18n/de/Symfony/rules/08-quality-tools.md +1 -3
  117. package/Dev/i18n/de/Symfony/rules/15-doctrine-extensions.md +5 -5
  118. package/Dev/i18n/de/Symfony/rules/16-i18n.md +1 -1
  119. package/Dev/i18n/de/Symfony/templates/README.md +1 -1
  120. package/Dev/i18n/de/Tauri/agents/tauri-reviewer.md +3 -0
  121. package/Dev/i18n/de/Vercel/agents/vercel-reviewer.md +1 -0
  122. package/Dev/i18n/de/Vercel/checks/all.md +1 -1
  123. package/Dev/i18n/de/Vite/agents/vite-reviewer.md +11 -11
  124. package/Dev/i18n/de/WordPress/CLAUDE.md.template +100 -0
  125. package/Dev/i18n/de/WordPress/agents/wordpress-reviewer.md +350 -0
  126. package/Dev/i18n/de/WordPress/checks/all.md +242 -0
  127. package/Dev/i18n/de/WordPress/commands/check.md +28 -0
  128. package/Dev/i18n/en/Angular/CLAUDE.md.template +3 -2
  129. package/Dev/i18n/en/Angular/agents/angular-reviewer.md +23 -7
  130. package/Dev/i18n/en/Common/agents/devops-engineer.md +1 -1
  131. package/Dev/i18n/en/Common/agents/migration-specialist.md +1 -1
  132. package/Dev/i18n/en/Common/commands/ralph-run.md +3 -3
  133. package/Dev/i18n/en/Common/commands/setup-rtk.md +2 -9
  134. package/Dev/i18n/en/Common/hooks/HOOKS-QUICKSTART.md +31 -43
  135. package/Dev/i18n/en/Common/rules/04-solid-principles.md +2 -2
  136. package/Dev/i18n/en/Common/rules/09-git-workflow.md +7 -1
  137. package/Dev/i18n/en/Common/rules/10-documentation.md +2 -2
  138. package/Dev/i18n/en/Common/rules/11-security.md +12 -12
  139. package/Dev/i18n/en/Common/rules/12-context-management.md +5 -3
  140. package/Dev/i18n/en/Flutter/commands/analyze-performance.md +1 -1
  141. package/Dev/i18n/en/Flutter/rules/06-tooling.md +6 -2
  142. package/Dev/i18n/en/Flutter/rules/11-security-flutter.md +1 -1
  143. package/Dev/i18n/en/Laravel/CLAUDE.md.template +1 -1
  144. package/Dev/i18n/en/Laravel/agents/laravel-reviewer.md +3 -3
  145. package/Dev/i18n/en/PHP/rules/03-coding-standards.md +10 -0
  146. package/Dev/i18n/en/PHP/rules/06-tooling.md +7 -3
  147. package/Dev/i18n/en/Paperclip/CLAUDE.md.template +2 -2
  148. package/Dev/i18n/en/Paperclip/README.md +1 -1
  149. package/Dev/i18n/en/Paperclip/checks/security.md +1 -0
  150. package/Dev/i18n/en/Paperclip/rules/11-security-paperclip.md +3 -1
  151. package/Dev/i18n/en/Python/agents/python-reviewer.md +1 -1
  152. package/Dev/i18n/en/Python/checks/code-quality.md +4 -4
  153. package/Dev/i18n/en/Python/checks/security.md +2 -2
  154. package/Dev/i18n/en/Python/checks/testing.md +2 -2
  155. package/Dev/i18n/en/Python/rules/02-architecture.md +1 -8
  156. package/Dev/i18n/en/Python/rules/03-coding-standards.md +16 -5
  157. package/Dev/i18n/en/Python/templates/repository.md +2 -2
  158. package/Dev/i18n/en/React/rules/02-architecture.md +17 -20
  159. package/Dev/i18n/en/React/rules/03-coding-standards.md +15 -16
  160. package/Dev/i18n/en/React/templates/component.md +11 -9
  161. package/Dev/i18n/en/ReactNative/agents/reactnative-reviewer.md +4 -4
  162. package/Dev/i18n/en/ReactNative/rules/02-architecture.md +4 -4
  163. package/Dev/i18n/en/ReactNative/rules/06-tooling.md +15 -14
  164. package/Dev/i18n/en/ReactNative/rules/07-testing-reactnative.md +1 -1
  165. package/Dev/i18n/en/ReactNative/rules/14-navigation.md +2 -0
  166. package/Dev/i18n/en/Ruby/agents/ruby-reviewer.md +1 -1
  167. package/Dev/i18n/en/Ruby/rules/06-tooling.md +2 -2
  168. package/Dev/i18n/en/Ruby/rules/11-security-ruby.md +13 -1
  169. package/Dev/i18n/en/Rust/rules/03-coding-standards.md +1 -1
  170. package/Dev/i18n/en/Rust/rules/11-security-rust.md +1 -1
  171. package/Dev/i18n/en/Symfony/adr/README.md +1 -1
  172. package/Dev/i18n/en/Symfony/checks/code-quality.md +2 -2
  173. package/Dev/i18n/en/Symfony/rules/03-coding-standards.md +15 -0
  174. package/Dev/i18n/en/Symfony/rules/06-docker-hadolint.md +1 -1
  175. package/Dev/i18n/en/Symfony/rules/08-quality-tools.md +1 -3
  176. package/Dev/i18n/en/Symfony/rules/15-doctrine-extensions.md +5 -5
  177. package/Dev/i18n/en/Symfony/rules/16-i18n.md +1 -1
  178. package/Dev/i18n/en/Symfony/templates/README.md +1 -1
  179. package/Dev/i18n/en/Tauri/agents/tauri-reviewer.md +3 -0
  180. package/Dev/i18n/en/Vercel/agents/vercel-reviewer.md +1 -0
  181. package/Dev/i18n/en/Vercel/checks/all.md +1 -1
  182. package/Dev/i18n/en/Vite/agents/vite-reviewer.md +11 -11
  183. package/Dev/i18n/en/WordPress/CLAUDE.md.template +100 -0
  184. package/Dev/i18n/en/WordPress/agents/wordpress-reviewer.md +350 -0
  185. package/Dev/i18n/en/WordPress/checks/all.md +241 -0
  186. package/Dev/i18n/en/WordPress/commands/check.md +28 -0
  187. package/Dev/i18n/es/Angular/CLAUDE.md.template +3 -2
  188. package/Dev/i18n/es/Angular/agents/angular-reviewer.md +23 -7
  189. package/Dev/i18n/es/Common/agents/devops-engineer.md +1 -1
  190. package/Dev/i18n/es/Common/agents/migration-specialist.md +1 -1
  191. package/Dev/i18n/es/Common/commands/ralph-run.md +3 -3
  192. package/Dev/i18n/es/Common/commands/setup-rtk.md +2 -9
  193. package/Dev/i18n/es/Common/hooks/HOOKS-QUICKSTART.md +33 -45
  194. package/Dev/i18n/es/Common/rules/04-solid-principles.md +2 -2
  195. package/Dev/i18n/es/Common/rules/09-git-workflow.md +7 -1
  196. package/Dev/i18n/es/Common/rules/10-documentation.md +2 -2
  197. package/Dev/i18n/es/Common/rules/11-security.md +12 -12
  198. package/Dev/i18n/es/Common/rules/12-context-management.md +5 -3
  199. package/Dev/i18n/es/Flutter/commands/analyze-performance.md +1 -1
  200. package/Dev/i18n/es/Flutter/rules/06-tooling.md +6 -2
  201. package/Dev/i18n/es/Flutter/rules/11-security-flutter.md +1 -1
  202. package/Dev/i18n/es/Laravel/agents/laravel-reviewer.md +2 -2
  203. package/Dev/i18n/es/PHP/rules/03-coding-standards.md +10 -0
  204. package/Dev/i18n/es/PHP/rules/06-tooling.md +7 -3
  205. package/Dev/i18n/es/Paperclip/CLAUDE.md.template +2 -2
  206. package/Dev/i18n/es/Paperclip/README.md +1 -1
  207. package/Dev/i18n/es/Paperclip/checks/security.md +1 -0
  208. package/Dev/i18n/es/Paperclip/rules/11-security-paperclip.md +3 -1
  209. package/Dev/i18n/es/Python/agents/python-reviewer.md +1 -1
  210. package/Dev/i18n/es/Python/checks/code-quality.md +4 -4
  211. package/Dev/i18n/es/Python/checks/security.md +2 -2
  212. package/Dev/i18n/es/Python/checks/testing.md +2 -2
  213. package/Dev/i18n/es/Python/rules/02-architecture.md +1 -8
  214. package/Dev/i18n/es/Python/rules/03-coding-standards.md +16 -5
  215. package/Dev/i18n/es/Python/templates/repository.md +2 -2
  216. package/Dev/i18n/es/React/rules/03-coding-standards.md +15 -16
  217. package/Dev/i18n/es/React/templates/component.md +11 -9
  218. package/Dev/i18n/es/ReactNative/agents/reactnative-reviewer.md +4 -4
  219. package/Dev/i18n/es/ReactNative/rules/06-tooling.md +15 -14
  220. package/Dev/i18n/es/ReactNative/rules/14-navigation.md +2 -0
  221. package/Dev/i18n/es/Ruby/agents/ruby-reviewer.md +1 -1
  222. package/Dev/i18n/es/Ruby/rules/06-tooling.md +2 -2
  223. package/Dev/i18n/es/Ruby/rules/11-security-ruby.md +13 -1
  224. package/Dev/i18n/es/Rust/rules/03-coding-standards.md +1 -1
  225. package/Dev/i18n/es/Rust/rules/11-security-rust.md +1 -1
  226. package/Dev/i18n/es/Symfony/adr/README.md +1 -1
  227. package/Dev/i18n/es/Symfony/checks/code-quality.md +2 -2
  228. package/Dev/i18n/es/Symfony/rules/03-coding-standards.md +15 -0
  229. package/Dev/i18n/es/Symfony/rules/06-docker-hadolint.md +1 -1
  230. package/Dev/i18n/es/Symfony/rules/08-quality-tools.md +1 -3
  231. package/Dev/i18n/es/Symfony/rules/15-doctrine-extensions.md +5 -5
  232. package/Dev/i18n/es/Symfony/rules/16-i18n.md +1 -1
  233. package/Dev/i18n/es/Symfony/templates/README.md +1 -1
  234. package/Dev/i18n/es/Tauri/agents/tauri-reviewer.md +3 -0
  235. package/Dev/i18n/es/Vercel/agents/vercel-reviewer.md +2 -1
  236. package/Dev/i18n/es/Vercel/checks/all.md +1 -1
  237. package/Dev/i18n/es/Vite/agents/vite-reviewer.md +11 -11
  238. package/Dev/i18n/es/WordPress/CLAUDE.md.template +100 -0
  239. package/Dev/i18n/es/WordPress/agents/wordpress-reviewer.md +350 -0
  240. package/Dev/i18n/es/WordPress/checks/all.md +241 -0
  241. package/Dev/i18n/es/WordPress/commands/check.md +28 -0
  242. package/Dev/i18n/fr/Angular/CLAUDE.md.template +3 -2
  243. package/Dev/i18n/fr/Angular/agents/angular-reviewer.md +23 -7
  244. package/Dev/i18n/fr/Common/agents/devops-engineer.md +1 -1
  245. package/Dev/i18n/fr/Common/agents/migration-specialist.md +1 -1
  246. package/Dev/i18n/fr/Common/commands/ralph-run.md +3 -3
  247. package/Dev/i18n/fr/Common/commands/setup-rtk.md +2 -9
  248. package/Dev/i18n/fr/Common/hooks/HOOKS-QUICKSTART.md +32 -44
  249. package/Dev/i18n/fr/Common/rules/04-solid-principles.md +2 -2
  250. package/Dev/i18n/fr/Common/rules/09-git-workflow.md +7 -1
  251. package/Dev/i18n/fr/Common/rules/10-documentation.md +2 -2
  252. package/Dev/i18n/fr/Common/rules/11-security.md +12 -12
  253. package/Dev/i18n/fr/Common/rules/12-context-management.md +5 -3
  254. package/Dev/i18n/fr/Flutter/commands/analyze-performance.md +1 -1
  255. package/Dev/i18n/fr/Flutter/rules/02-architecture.md +4 -4
  256. package/Dev/i18n/fr/Flutter/rules/06-tooling.md +6 -2
  257. package/Dev/i18n/fr/Flutter/rules/11-security-flutter.md +1 -1
  258. package/Dev/i18n/fr/Laravel/CLAUDE.md.template +1 -1
  259. package/Dev/i18n/fr/Laravel/agents/laravel-reviewer.md +3 -3
  260. package/Dev/i18n/fr/PHP/rules/03-coding-standards.md +10 -0
  261. package/Dev/i18n/fr/PHP/rules/06-tooling.md +7 -3
  262. package/Dev/i18n/fr/Paperclip/CLAUDE.md.template +2 -2
  263. package/Dev/i18n/fr/Paperclip/README.md +1 -1
  264. package/Dev/i18n/fr/Paperclip/checks/security.md +1 -0
  265. package/Dev/i18n/fr/Paperclip/rules/11-security-paperclip.md +3 -1
  266. package/Dev/i18n/fr/Python/agents/python-reviewer.md +1 -1
  267. package/Dev/i18n/fr/Python/checks/code-quality.md +4 -4
  268. package/Dev/i18n/fr/Python/checks/security.md +2 -2
  269. package/Dev/i18n/fr/Python/checks/testing.md +2 -2
  270. package/Dev/i18n/fr/Python/commands/dependency-audit.md +1 -2
  271. package/Dev/i18n/fr/Python/commands/generate-endpoint.md +7 -11
  272. package/Dev/i18n/fr/Python/commands/generate-model.md +6 -6
  273. package/Dev/i18n/fr/Python/rules/02-architecture.md +9 -24
  274. package/Dev/i18n/fr/Python/rules/03-coding-standards.md +19 -7
  275. package/Dev/i18n/fr/Python/templates/repository.md +9 -10
  276. package/Dev/i18n/fr/React/commands/generate-component.md +52 -51
  277. package/Dev/i18n/fr/React/rules/02-architecture.md +17 -20
  278. package/Dev/i18n/fr/React/rules/03-coding-standards.md +15 -16
  279. package/Dev/i18n/fr/React/templates/component.md +11 -9
  280. package/Dev/i18n/fr/ReactNative/agents/reactnative-reviewer.md +4 -4
  281. package/Dev/i18n/fr/ReactNative/rules/06-tooling.md +15 -14
  282. package/Dev/i18n/fr/ReactNative/rules/14-navigation.md +2 -0
  283. package/Dev/i18n/fr/Ruby/agents/ruby-reviewer.md +1 -1
  284. package/Dev/i18n/fr/Ruby/rules/06-tooling.md +2 -2
  285. package/Dev/i18n/fr/Ruby/rules/11-security-ruby.md +13 -1
  286. package/Dev/i18n/fr/Rust/rules/03-coding-standards.md +1 -1
  287. package/Dev/i18n/fr/Rust/rules/11-security-rust.md +1 -1
  288. package/Dev/i18n/fr/Symfony/adr/README.md +1 -1
  289. package/Dev/i18n/fr/Symfony/checks/code-quality.md +2 -2
  290. package/Dev/i18n/fr/Symfony/rules/03-coding-standards.md +15 -0
  291. package/Dev/i18n/fr/Symfony/rules/06-docker-hadolint.md +1 -1
  292. package/Dev/i18n/fr/Symfony/rules/08-quality-tools.md +1 -3
  293. package/Dev/i18n/fr/Symfony/rules/15-doctrine-extensions.md +5 -5
  294. package/Dev/i18n/fr/Symfony/rules/16-i18n.md +1 -1
  295. package/Dev/i18n/fr/Symfony/templates/README.md +1 -1
  296. package/Dev/i18n/fr/Tauri/agents/tauri-reviewer.md +3 -0
  297. package/Dev/i18n/fr/Vercel/agents/vercel-reviewer.md +1 -0
  298. package/Dev/i18n/fr/Vercel/checks/all.md +1 -1
  299. package/Dev/i18n/fr/Vite/agents/vite-reviewer.md +11 -11
  300. package/Dev/i18n/fr/WordPress/CLAUDE.md.template +100 -0
  301. package/Dev/i18n/fr/WordPress/agents/wordpress-reviewer.md +350 -0
  302. package/Dev/i18n/fr/WordPress/checks/all.md +242 -0
  303. package/Dev/i18n/fr/WordPress/commands/check.md +28 -0
  304. package/Dev/i18n/pt/Angular/CLAUDE.md.template +3 -2
  305. package/Dev/i18n/pt/Angular/agents/angular-reviewer.md +23 -7
  306. package/Dev/i18n/pt/Common/agents/devops-engineer.md +1 -1
  307. package/Dev/i18n/pt/Common/agents/migration-specialist.md +1 -1
  308. package/Dev/i18n/pt/Common/commands/ralph-run.md +3 -3
  309. package/Dev/i18n/pt/Common/commands/setup-rtk.md +2 -9
  310. package/Dev/i18n/pt/Common/hooks/HOOKS-QUICKSTART.md +33 -45
  311. package/Dev/i18n/pt/Common/rules/04-solid-principles.md +2 -2
  312. package/Dev/i18n/pt/Common/rules/09-git-workflow.md +7 -1
  313. package/Dev/i18n/pt/Common/rules/10-documentation.md +2 -2
  314. package/Dev/i18n/pt/Common/rules/11-security.md +12 -12
  315. package/Dev/i18n/pt/Common/rules/12-context-management.md +5 -3
  316. package/Dev/i18n/pt/Flutter/commands/analyze-performance.md +1 -1
  317. package/Dev/i18n/pt/Flutter/rules/06-tooling.md +6 -2
  318. package/Dev/i18n/pt/Flutter/rules/11-security-flutter.md +1 -1
  319. package/Dev/i18n/pt/Laravel/agents/laravel-reviewer.md +2 -2
  320. package/Dev/i18n/pt/PHP/rules/03-coding-standards.md +10 -0
  321. package/Dev/i18n/pt/PHP/rules/06-tooling.md +7 -3
  322. package/Dev/i18n/pt/Paperclip/CLAUDE.md.template +2 -2
  323. package/Dev/i18n/pt/Paperclip/README.md +1 -1
  324. package/Dev/i18n/pt/Paperclip/checks/security.md +1 -0
  325. package/Dev/i18n/pt/Paperclip/rules/11-security-paperclip.md +3 -1
  326. package/Dev/i18n/pt/Python/agents/python-reviewer.md +1 -1
  327. package/Dev/i18n/pt/Python/checks/code-quality.md +4 -4
  328. package/Dev/i18n/pt/Python/checks/security.md +2 -2
  329. package/Dev/i18n/pt/Python/checks/testing.md +2 -2
  330. package/Dev/i18n/pt/Python/rules/02-architecture.md +1 -8
  331. package/Dev/i18n/pt/Python/rules/03-coding-standards.md +16 -5
  332. package/Dev/i18n/pt/Python/templates/repository.md +2 -2
  333. package/Dev/i18n/pt/React/rules/02-architecture.md +17 -20
  334. package/Dev/i18n/pt/React/rules/03-coding-standards.md +15 -16
  335. package/Dev/i18n/pt/React/templates/component.md +12 -10
  336. package/Dev/i18n/pt/ReactNative/agents/reactnative-reviewer.md +4 -4
  337. package/Dev/i18n/pt/ReactNative/rules/06-tooling.md +15 -14
  338. package/Dev/i18n/pt/ReactNative/rules/14-navigation.md +2 -0
  339. package/Dev/i18n/pt/Ruby/agents/ruby-reviewer.md +1 -1
  340. package/Dev/i18n/pt/Ruby/rules/06-tooling.md +2 -2
  341. package/Dev/i18n/pt/Ruby/rules/11-security-ruby.md +13 -1
  342. package/Dev/i18n/pt/Rust/rules/03-coding-standards.md +1 -1
  343. package/Dev/i18n/pt/Rust/rules/11-security-rust.md +1 -1
  344. package/Dev/i18n/pt/Symfony/adr/README.md +1 -1
  345. package/Dev/i18n/pt/Symfony/checks/code-quality.md +2 -2
  346. package/Dev/i18n/pt/Symfony/rules/03-coding-standards.md +15 -0
  347. package/Dev/i18n/pt/Symfony/rules/06-docker-hadolint.md +1 -1
  348. package/Dev/i18n/pt/Symfony/rules/08-quality-tools.md +1 -3
  349. package/Dev/i18n/pt/Symfony/rules/15-doctrine-extensions.md +5 -5
  350. package/Dev/i18n/pt/Symfony/rules/16-i18n.md +1 -1
  351. package/Dev/i18n/pt/Symfony/templates/README.md +1 -1
  352. package/Dev/i18n/pt/Tauri/agents/tauri-reviewer.md +3 -0
  353. package/Dev/i18n/pt/Vercel/agents/vercel-reviewer.md +1 -0
  354. package/Dev/i18n/pt/Vercel/checks/all.md +1 -1
  355. package/Dev/i18n/pt/Vite/agents/vite-reviewer.md +11 -11
  356. package/Dev/i18n/pt/WordPress/CLAUDE.md.template +100 -0
  357. package/Dev/i18n/pt/WordPress/agents/wordpress-reviewer.md +350 -0
  358. package/Dev/i18n/pt/WordPress/checks/all.md +241 -0
  359. package/Dev/i18n/pt/WordPress/commands/check.md +28 -0
  360. package/Dev/scripts/check-config.sh +1 -1
  361. package/Dev/scripts/install-common-rules.sh +65 -0
  362. package/Dev/scripts/install-from-config.sh +3 -0
  363. package/Dev/scripts/install-paperclip-rules.sh +1 -1
  364. package/Dev/scripts/install-wordpress-rules.sh +153 -0
  365. package/Dev/scripts/lib/merge-hooks.mjs +110 -0
  366. package/Dev/scripts/memory-lifecycle/README.md +10 -9
  367. package/Dev/scripts/memory-lifecycle/_db.sh +1 -1
  368. package/Dev/scripts/memory-lifecycle/post-tool.sh +1 -1
  369. package/Dev/scripts/memory-lifecycle/pre-compact.sh +5 -5
  370. package/Dev/scripts/memory-lifecycle/prompt-submit.sh +1 -1
  371. package/Dev/scripts/memory-lifecycle/session-end.sh +1 -1
  372. package/Dev/scripts/memory-lifecycle/session-start.sh +5 -4
  373. package/Dev/stack-profiles/wordpress/permissions.txt +10 -0
  374. package/Dev/stack-profiles/wordpress/quality.md +4 -0
  375. package/Dev/stack-profiles/wordpress/stack.txt +2 -0
  376. package/Infra/i18n/de/Ansible/agents/ansible-architect.md +3 -1
  377. package/Infra/i18n/de/Ansible/agents/ansible-debug.md +1 -0
  378. package/Infra/i18n/de/Ansible/agents/ansible-deployment.md +3 -0
  379. package/Infra/i18n/de/Ansible/agents/ansible-security.md +2 -0
  380. package/Infra/i18n/de/Ansible/commands/security-audit.md +1 -1
  381. package/Infra/i18n/de/Coolify/agents/coolify-debug.md +1 -0
  382. package/Infra/i18n/de/Coolify/agents/coolify-deployment.md +5 -1
  383. package/Infra/i18n/de/Coolify/commands/coolify-debug.md +1 -0
  384. package/Infra/i18n/de/Coolify/commands/coolify-deploy.md +1 -0
  385. package/Infra/i18n/de/FrankenPHP/agents/frankenphp-architect.md +4 -2
  386. package/Infra/i18n/de/FrankenPHP/agents/frankenphp-deployment.md +2 -2
  387. package/Infra/i18n/de/FrankenPHP/agents/frankenphp-security.md +1 -1
  388. package/Infra/i18n/de/FrankenPHP/commands/deploy-setup.md +1 -1
  389. package/Infra/i18n/de/Hcloud/agents/hcloud-architect.md +16 -14
  390. package/Infra/i18n/de/Hcloud/agents/hcloud-cost.md +11 -9
  391. package/Infra/i18n/de/Hcloud/agents/hcloud-deployment.md +1 -1
  392. package/Infra/i18n/de/Hcloud/agents/hcloud-security.md +1 -1
  393. package/Infra/i18n/de/Hcloud/commands/architecture.md +2 -2
  394. package/Infra/i18n/de/Hcloud/commands/debug.md +3 -3
  395. package/Infra/i18n/de/Kubernetes/agents/kubernetes-architect.md +4 -0
  396. package/Infra/i18n/de/Kubernetes/agents/kubernetes-deployment.md +31 -0
  397. package/Infra/i18n/de/Kubernetes/agents/kubernetes-security.md +5 -1
  398. package/Infra/i18n/de/OpenTofu/agents/opentofu-architect.md +3 -1
  399. package/Infra/i18n/de/OpenTofu/agents/opentofu-deployment.md +2 -2
  400. package/Infra/i18n/de/OpenTofu/agents/opentofu-security.md +5 -5
  401. package/Infra/i18n/de/OpenTofu/commands/security-audit.md +1 -1
  402. package/Infra/i18n/de/PgBouncer/agents/pgbouncer-architect.md +1 -0
  403. package/Infra/i18n/de/PgBouncer/agents/pgbouncer-deployment.md +3 -3
  404. package/Infra/i18n/de/PgBouncer/agents/pgbouncer-monitoring.md +1 -1
  405. package/Infra/i18n/de/PgBouncer/commands/deploy-setup.md +1 -1
  406. package/Infra/i18n/en/Ansible/agents/ansible-architect.md +3 -1
  407. package/Infra/i18n/en/Ansible/agents/ansible-debug.md +1 -0
  408. package/Infra/i18n/en/Ansible/agents/ansible-deployment.md +3 -0
  409. package/Infra/i18n/en/Ansible/agents/ansible-security.md +2 -0
  410. package/Infra/i18n/en/Ansible/commands/security-audit.md +1 -1
  411. package/Infra/i18n/en/Coolify/agents/coolify-debug.md +1 -0
  412. package/Infra/i18n/en/Coolify/agents/coolify-deployment.md +5 -1
  413. package/Infra/i18n/en/Coolify/commands/coolify-debug.md +1 -0
  414. package/Infra/i18n/en/Coolify/commands/coolify-deploy.md +1 -0
  415. package/Infra/i18n/en/FrankenPHP/agents/frankenphp-architect.md +4 -2
  416. package/Infra/i18n/en/FrankenPHP/agents/frankenphp-deployment.md +2 -2
  417. package/Infra/i18n/en/FrankenPHP/agents/frankenphp-security.md +1 -1
  418. package/Infra/i18n/en/FrankenPHP/commands/deploy-setup.md +1 -1
  419. package/Infra/i18n/en/Hcloud/agents/hcloud-architect.md +10 -8
  420. package/Infra/i18n/en/Hcloud/agents/hcloud-cost.md +11 -9
  421. package/Infra/i18n/en/Hcloud/agents/hcloud-deployment.md +1 -1
  422. package/Infra/i18n/en/Kubernetes/agents/kubernetes-architect.md +4 -0
  423. package/Infra/i18n/en/Kubernetes/agents/kubernetes-deployment.md +31 -0
  424. package/Infra/i18n/en/Kubernetes/agents/kubernetes-security.md +5 -1
  425. package/Infra/i18n/en/OpenTofu/agents/opentofu-architect.md +3 -1
  426. package/Infra/i18n/en/OpenTofu/agents/opentofu-deployment.md +2 -2
  427. package/Infra/i18n/en/OpenTofu/agents/opentofu-security.md +5 -5
  428. package/Infra/i18n/en/OpenTofu/commands/security-audit.md +1 -1
  429. package/Infra/i18n/en/PgBouncer/agents/pgbouncer-architect.md +1 -0
  430. package/Infra/i18n/en/PgBouncer/agents/pgbouncer-deployment.md +3 -3
  431. package/Infra/i18n/en/PgBouncer/agents/pgbouncer-monitoring.md +1 -1
  432. package/Infra/i18n/en/PgBouncer/commands/deploy-setup.md +1 -1
  433. package/Infra/i18n/es/Ansible/agents/ansible-architect.md +3 -1
  434. package/Infra/i18n/es/Ansible/agents/ansible-debug.md +1 -0
  435. package/Infra/i18n/es/Ansible/agents/ansible-deployment.md +3 -0
  436. package/Infra/i18n/es/Ansible/agents/ansible-security.md +2 -0
  437. package/Infra/i18n/es/Ansible/commands/security-audit.md +1 -1
  438. package/Infra/i18n/es/Coolify/agents/coolify-debug.md +1 -0
  439. package/Infra/i18n/es/Coolify/agents/coolify-deployment.md +5 -1
  440. package/Infra/i18n/es/Coolify/commands/coolify-debug.md +1 -0
  441. package/Infra/i18n/es/Coolify/commands/coolify-deploy.md +1 -0
  442. package/Infra/i18n/es/FrankenPHP/agents/frankenphp-architect.md +4 -2
  443. package/Infra/i18n/es/FrankenPHP/agents/frankenphp-deployment.md +2 -2
  444. package/Infra/i18n/es/FrankenPHP/agents/frankenphp-security.md +1 -1
  445. package/Infra/i18n/es/FrankenPHP/commands/deploy-setup.md +1 -1
  446. package/Infra/i18n/es/Hcloud/agents/hcloud-architect.md +11 -9
  447. package/Infra/i18n/es/Hcloud/agents/hcloud-cost.md +11 -9
  448. package/Infra/i18n/es/Hcloud/agents/hcloud-deployment.md +1 -1
  449. package/Infra/i18n/es/Hcloud/commands/debug.md +1 -1
  450. package/Infra/i18n/es/Kubernetes/agents/kubernetes-architect.md +4 -0
  451. package/Infra/i18n/es/Kubernetes/agents/kubernetes-deployment.md +31 -0
  452. package/Infra/i18n/es/Kubernetes/agents/kubernetes-security.md +5 -1
  453. package/Infra/i18n/es/OpenTofu/agents/opentofu-architect.md +3 -1
  454. package/Infra/i18n/es/OpenTofu/agents/opentofu-deployment.md +2 -2
  455. package/Infra/i18n/es/OpenTofu/agents/opentofu-security.md +5 -5
  456. package/Infra/i18n/es/OpenTofu/commands/security-audit.md +1 -1
  457. package/Infra/i18n/es/PgBouncer/agents/pgbouncer-architect.md +1 -0
  458. package/Infra/i18n/es/PgBouncer/agents/pgbouncer-deployment.md +3 -3
  459. package/Infra/i18n/es/PgBouncer/agents/pgbouncer-monitoring.md +1 -1
  460. package/Infra/i18n/es/PgBouncer/commands/deploy-setup.md +1 -1
  461. package/Infra/i18n/fr/Ansible/agents/ansible-architect.md +3 -1
  462. package/Infra/i18n/fr/Ansible/agents/ansible-debug.md +1 -0
  463. package/Infra/i18n/fr/Ansible/agents/ansible-deployment.md +3 -0
  464. package/Infra/i18n/fr/Ansible/agents/ansible-security.md +2 -0
  465. package/Infra/i18n/fr/Ansible/commands/security-audit.md +1 -1
  466. package/Infra/i18n/fr/Coolify/agents/coolify-debug.md +1 -0
  467. package/Infra/i18n/fr/Coolify/agents/coolify-deployment.md +5 -1
  468. package/Infra/i18n/fr/Coolify/commands/coolify-debug.md +1 -0
  469. package/Infra/i18n/fr/Coolify/commands/coolify-deploy.md +1 -0
  470. package/Infra/i18n/fr/FrankenPHP/agents/frankenphp-architect.md +4 -2
  471. package/Infra/i18n/fr/FrankenPHP/agents/frankenphp-deployment.md +2 -2
  472. package/Infra/i18n/fr/FrankenPHP/agents/frankenphp-security.md +1 -1
  473. package/Infra/i18n/fr/FrankenPHP/commands/deploy-setup.md +1 -1
  474. package/Infra/i18n/fr/Hcloud/agents/hcloud-architect.md +7 -5
  475. package/Infra/i18n/fr/Hcloud/agents/hcloud-cost.md +11 -9
  476. package/Infra/i18n/fr/Hcloud/agents/hcloud-deployment.md +1 -1
  477. package/Infra/i18n/fr/Kubernetes/agents/kubernetes-architect.md +4 -0
  478. package/Infra/i18n/fr/Kubernetes/agents/kubernetes-deployment.md +31 -0
  479. package/Infra/i18n/fr/Kubernetes/agents/kubernetes-security.md +5 -1
  480. package/Infra/i18n/fr/OpenTofu/agents/opentofu-architect.md +3 -1
  481. package/Infra/i18n/fr/OpenTofu/agents/opentofu-deployment.md +2 -2
  482. package/Infra/i18n/fr/OpenTofu/agents/opentofu-security.md +5 -5
  483. package/Infra/i18n/fr/OpenTofu/commands/security-audit.md +1 -1
  484. package/Infra/i18n/fr/PgBouncer/agents/pgbouncer-architect.md +1 -0
  485. package/Infra/i18n/fr/PgBouncer/agents/pgbouncer-deployment.md +3 -3
  486. package/Infra/i18n/fr/PgBouncer/agents/pgbouncer-monitoring.md +1 -1
  487. package/Infra/i18n/fr/PgBouncer/commands/deploy-setup.md +1 -1
  488. package/Infra/i18n/pt/Ansible/agents/ansible-architect.md +3 -1
  489. package/Infra/i18n/pt/Ansible/agents/ansible-debug.md +1 -0
  490. package/Infra/i18n/pt/Ansible/agents/ansible-deployment.md +3 -0
  491. package/Infra/i18n/pt/Ansible/agents/ansible-security.md +2 -0
  492. package/Infra/i18n/pt/Ansible/commands/security-audit.md +1 -1
  493. package/Infra/i18n/pt/Coolify/agents/coolify-debug.md +1 -0
  494. package/Infra/i18n/pt/Coolify/agents/coolify-deployment.md +5 -1
  495. package/Infra/i18n/pt/Coolify/commands/coolify-debug.md +1 -0
  496. package/Infra/i18n/pt/Coolify/commands/coolify-deploy.md +1 -0
  497. package/Infra/i18n/pt/FrankenPHP/agents/frankenphp-architect.md +4 -2
  498. package/Infra/i18n/pt/FrankenPHP/agents/frankenphp-deployment.md +2 -2
  499. package/Infra/i18n/pt/FrankenPHP/agents/frankenphp-security.md +1 -1
  500. package/Infra/i18n/pt/FrankenPHP/commands/deploy-setup.md +1 -1
  501. package/Infra/i18n/pt/Hcloud/agents/hcloud-architect.md +9 -7
  502. package/Infra/i18n/pt/Hcloud/agents/hcloud-cost.md +11 -9
  503. package/Infra/i18n/pt/Hcloud/agents/hcloud-deployment.md +1 -1
  504. package/Infra/i18n/pt/Hcloud/commands/architecture.md +1 -1
  505. package/Infra/i18n/pt/Hcloud/commands/debug.md +1 -1
  506. package/Infra/i18n/pt/Kubernetes/agents/kubernetes-architect.md +4 -0
  507. package/Infra/i18n/pt/Kubernetes/agents/kubernetes-deployment.md +31 -0
  508. package/Infra/i18n/pt/Kubernetes/agents/kubernetes-security.md +5 -1
  509. package/Infra/i18n/pt/OpenTofu/agents/opentofu-architect.md +3 -1
  510. package/Infra/i18n/pt/OpenTofu/agents/opentofu-deployment.md +2 -2
  511. package/Infra/i18n/pt/OpenTofu/agents/opentofu-security.md +5 -5
  512. package/Infra/i18n/pt/OpenTofu/commands/security-audit.md +1 -1
  513. package/Infra/i18n/pt/PgBouncer/agents/pgbouncer-architect.md +1 -0
  514. package/Infra/i18n/pt/PgBouncer/agents/pgbouncer-deployment.md +3 -3
  515. package/Infra/i18n/pt/PgBouncer/agents/pgbouncer-monitoring.md +1 -1
  516. package/Infra/i18n/pt/PgBouncer/commands/deploy-setup.md +1 -1
  517. package/README.md +27 -15
  518. package/Tools/PluginExport/export-plugin.sh +15 -17
  519. package/Tools/Ralph/README.md +17 -7
  520. package/Tools/Ralph/hooks/lib/ralph-common.sh +101 -0
  521. package/Tools/Ralph/hooks/pre-tool-context.sh +28 -0
  522. package/Tools/Ralph/hooks/session-restore.sh +94 -0
  523. package/Tools/Ralph/hooks/stop-dod-gate.sh +60 -0
  524. package/Tools/Ralph/lib/hooks-generator.sh +109 -93
  525. package/bundles/cursor/.cursorrules +11 -10
  526. package/bundles/windsurf/.windsurfrules +11 -10
  527. package/cli/index.js +1 -0
  528. package/cli/lib/doctor.js +4 -3
  529. package/cli/lib/help.js +1 -0
  530. package/cli/lib/installer.js +1 -1
  531. package/cli/lib/parse-args.js +12 -0
  532. package/cli/lib/tech-registry.js +15 -5
  533. package/package.json +2 -1
  534. package/Dev/i18n/de/Common/hooks/scripts/post-tool-failure.sh +0 -89
  535. package/Dev/i18n/de/Common/hooks/scripts/pre-compact.sh +0 -53
  536. package/Dev/i18n/de/Common/hooks/scripts/session-end.sh +0 -98
  537. package/Dev/i18n/de/Common/templates/settings.json.template +0 -128
  538. package/Dev/i18n/en/Common/hooks/scripts/post-tool-failure.sh +0 -89
  539. package/Dev/i18n/en/Common/hooks/scripts/pre-compact.sh +0 -53
  540. package/Dev/i18n/en/Common/hooks/scripts/session-end.sh +0 -98
  541. package/Dev/i18n/en/Common/templates/settings.json.template +0 -128
  542. package/Dev/i18n/es/Common/hooks/scripts/post-tool-failure.sh +0 -89
  543. package/Dev/i18n/es/Common/hooks/scripts/pre-compact.sh +0 -53
  544. package/Dev/i18n/es/Common/hooks/scripts/session-end.sh +0 -98
  545. package/Dev/i18n/es/Common/templates/settings.json.template +0 -128
  546. package/Dev/i18n/fr/Common/hooks/scripts/post-tool-failure.sh +0 -88
  547. package/Dev/i18n/fr/Common/hooks/scripts/pre-compact.sh +0 -53
  548. package/Dev/i18n/fr/Common/hooks/scripts/session-end.sh +0 -98
  549. package/Dev/i18n/fr/Common/templates/settings.json.template +0 -128
  550. package/Dev/i18n/pt/Common/hooks/scripts/post-tool-failure.sh +0 -89
  551. package/Dev/i18n/pt/Common/hooks/scripts/pre-compact.sh +0 -53
  552. package/Dev/i18n/pt/Common/hooks/scripts/session-end.sh +0 -98
  553. package/Dev/i18n/pt/Common/templates/settings.json.template +0 -128
  554. package/Tools/Ralph/.ralph/hooks/pre-tool-context.sh +0 -100
  555. package/Tools/Ralph/.ralph/hooks/session-restore.sh +0 -118
  556. package/Tools/Ralph/.ralph/hooks/status-injector.sh +0 -147
  557. package/Tools/Ralph/.ralph/hooks/stop-dod-gate.sh +0 -137
@@ -0,0 +1,241 @@
1
+ # Check Complete WordPress Compliance
2
+
3
+ ## Arguments
4
+
5
+ $ARGUMENTS (optional: path to plugin/theme to analyze)
6
+
7
+ ## Plan Mode
8
+
9
+ > Plan mode is activated automatically when the scope spans multiple modules or requires cross-cutting investigation.
10
+
11
+ ## MISSION
12
+
13
+ Perform a complete compliance audit of the WordPress plugin or theme by orchestrating the 4 major checks: Architecture, Code Quality, Tests, and Security. Produce a consolidated report with an overall score out of 100 points.
14
+
15
+ ### Step 1: Audit Preparation
16
+
17
+ Prepare audit environment:
18
+ - [ ] Identify project path to audit
19
+ - [ ] Verify presence of key files (plugin header file or `style.css`/`theme.json`, `composer.json`, `package.json`, `.wp-env.json`, `phpcs.xml*`, `phpstan.neon*`, `uninstall.php`, `block.json` files)
20
+ - [ ] List main directories (`src/` or `includes/`, `blocks/`, `languages/`, `tests/`, CI workflows)
21
+ - [ ] Identify declared `Requires at least`, `Requires PHP`, `Requires Plugins`, and the tooling versions in lockfiles
22
+ - [ ] Determine the type: plugin, classic theme, block theme, or mixed; note whether the project depends on WooCommerce
23
+
24
+ **Note**: If $ARGUMENTS provided, use it as project path, otherwise use current directory.
25
+
26
+ ### Step 2: Architecture Audit (25 points)
27
+
28
+ **Command**: Use slash command `/wordpress:check architecture` or manually follow steps in `.claude/references/wordpress/checks/architecture.md`
29
+
30
+ **Evaluated Criteria**:
31
+ - Plugin header, bootstrap file, ABSPATH guard, Composer autoload (5 pts)
32
+ - Prefixing and namespaces for functions, classes, options, hooks, handles (5 pts)
33
+ - Hooks organization and thin callbacks (5 pts)
34
+ - Blocks (`block.json` apiVersion 3, `render.php`) and block theme structure (`theme.json`, templates, parts) (5 pts)
35
+ - REST design and lifecycle (activation, deactivation, uninstall) (5 pts)
36
+
37
+ **Reference**: `.claude/references/wordpress/checks/architecture.md`
38
+
39
+ ### Step 3: Code Quality Audit (25 points)
40
+
41
+ **Command**: Use slash command `/wordpress:check code-quality` or manually follow steps in `.claude/references/wordpress/checks/code-quality.md`
42
+
43
+ **Evaluated Criteria**:
44
+ - WPCS (PHPCS) passes (7 pts)
45
+ - i18n: text domain, translator comments, JS translations (5 pts)
46
+ - PHPStan (phpstan-wordpress) and ESLint (`@wordpress/eslint-plugin`) (5 pts)
47
+ - KISS/DRY/YAGNI principles (4 pts)
48
+ - Function size and cognitive complexity (4 pts)
49
+
50
+ **Reference**: `.claude/references/wordpress/checks/code-quality.md`
51
+
52
+ ### Step 4: Testing Audit (25 points)
53
+
54
+ **Command**: Use slash command `/wordpress:check testing` or manually follow steps in `.claude/references/wordpress/checks/testing.md`
55
+
56
+ **Evaluated Criteria**:
57
+ - Code coverage (target >= 80%) across PHP and JS (7 pts)
58
+ - PHPUnit with `WP_UnitTestCase` through wp-env, `yoast/phpunit-polyfills` (6 pts)
59
+ - Jest via `@wordpress/scripts` for blocks and JS (4 pts)
60
+ - Playwright end-to-end with `@wordpress/e2e-test-utils-playwright` (3 pts)
61
+ - Test quality: AAA, naming, no flakiness, CI execution (3 pts)
62
+ - Test isolation and use of factories (2 pts)
63
+
64
+ **Reference**: `.claude/references/wordpress/checks/testing.md`
65
+
66
+ ### Step 5: Security Audit (25 points)
67
+
68
+ **Command**: Use slash command `/wordpress:check security` or manually follow steps in `.claude/references/wordpress/checks/security.md`
69
+
70
+ **Evaluated Criteria**:
71
+ - Capability checks and nonces on every state change (6 pts)
72
+ - REST `permission_callback` and argument validation (5 pts)
73
+ - Output escaping (`esc_*`, `wp_kses_post`) (5 pts)
74
+ - Input sanitization and `$wpdb->prepare()` (4 pts)
75
+ - Secrets and credentials management, OWASP Top 10:2025 protections (3 pts)
76
+ - Dependency vulnerabilities and supply chain (`composer audit`, `npm audit`) (2 pts)
77
+
78
+ **Reference**: `.claude/references/wordpress/checks/security.md`
79
+
80
+ ### Step 6: WooCommerce (only if the project depends on it)
81
+
82
+ Apply `.claude/skills/woocommerce/checklist.md`: HPOS compatibility declared, `wc_get_order()` / CRUD objects instead of post meta, `cart_checkout_blocks` compatibility. Fold findings into the Architecture and Security scores; skip this step entirely for projects without WooCommerce.
83
+
84
+ ### Step 7: Consolidation and Global Scoring
85
+
86
+ Calculate overall score and produce consolidated report:
87
+ - [ ] Sum the 4 scores (max 100 points)
88
+ - [ ] Identify critical categories (<50%)
89
+ - [ ] List all critical cross-cutting issues
90
+ - [ ] Prioritize actions by impact/effort
91
+ - [ ] Produce final consolidated report
92
+
93
+ **Grading Scale**:
94
+ - 90-100: Excellent - Reference project
95
+ - 75-89: Very Good - Some minor improvements
96
+ - 60-74: Acceptable - Requires improvements
97
+ - 40-59: Insufficient - Major refactoring required
98
+ - 0-39: Critical - Complete overhaul necessary
99
+
100
+ ### Step 8: Recommendations and Action Plan
101
+
102
+ - [ ] Identify top 3 priority actions across all categories
103
+ - [ ] Estimate effort and impact (Low/Medium/High) for each
104
+ - [ ] Propose implementation order
105
+ - [ ] Suggest quick wins (high impact/effort ratio)
106
+
107
+ ## OUTPUT FORMAT
108
+
109
+ ```
110
+ WORDPRESS COMPLIANCE AUDIT - COMPLETE REPORT
111
+ =============================================
112
+
113
+ OVERALL SCORE: XX/100
114
+
115
+ COMPLIANCE LEVEL: [Excellent/Very Good/Acceptable/Insufficient/Critical]
116
+
117
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
118
+
119
+ SCORES BY CATEGORY:
120
+
121
+ ARCHITECTURE : XX/25 [██████████░░░░░░░░░░] XX%
122
+ CODE QUALITY : XX/25 [██████████░░░░░░░░░░] XX%
123
+ TESTS : XX/25 [██████████░░░░░░░░░░] XX%
124
+ SECURITY : XX/25 [██████████░░░░░░░░░░] XX%
125
+
126
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
127
+
128
+ OVERALL STRENGTHS:
129
+ 1. [Strength identified in multiple categories]
130
+ 2. [Other major strength]
131
+ 3. [Third strength]
132
+
133
+ OVERALL IMPROVEMENTS:
134
+ 1. [Minor cross-cutting improvement]
135
+ 2. [Other recommended improvement]
136
+ 3. [Third improvement]
137
+
138
+ CRITICAL ISSUES:
139
+ 1. [Critical issue #1 - affected category]
140
+ 2. [Critical issue #2 - affected category]
141
+ 3. [Critical issue #3 - affected category]
142
+
143
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
144
+
145
+ DETAILS BY CATEGORY:
146
+
147
+ ┌─────────────────────────────────────────────┐
148
+ │ ARCHITECTURE (XX/25) │
149
+ └─────────────────────────────────────────────┘
150
+
151
+ Sub-scores:
152
+ • Header / bootstrap / autoload : XX/5
153
+ • Prefixing / namespaces : XX/5
154
+ • Hooks organization : XX/5
155
+ • Blocks / theme structure : XX/5
156
+ • REST / lifecycle : XX/5
157
+
158
+ Strengths:
159
+ - [Architecture strengths]
160
+
161
+ Issues:
162
+ - [Architecture issues]
163
+
164
+ [Similar sections for Code Quality, Tests, and Security...]
165
+
166
+ WOOCOMMERCE (if applicable): [HPOS / CRUD / checkout blocks findings]
167
+
168
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
169
+
170
+ TOP 3 PRIORITY ACTIONS (ALL CATEGORIES):
171
+
172
+ 1. CRITICAL - [Action #1]
173
+ Category : [Architecture/Quality/Tests/Security]
174
+ Impact : [High/Medium/Low]
175
+ Effort : [High/Medium/Low]
176
+ Priority : IMMEDIATE
177
+
178
+ Detailed description:
179
+ [Explanation of problem and proposed solution]
180
+
181
+ Affected files:
182
+ - [file:line]
183
+
184
+ Correction example:
185
+ [Code or correction command]
186
+
187
+ 2. IMPORTANT - [Action #2]
188
+ [Same format...]
189
+
190
+ 3. RECOMMENDED - [Action #3]
191
+ [Same format...]
192
+
193
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
194
+
195
+ QUICK WINS (High Impact / Low Effort):
196
+
197
+ - [Quick win #1] - Category: [X] - Impact: [X] - Effort: [X]
198
+ - [Quick win #2] - Category: [X] - Impact: [X] - Effort: [X]
199
+ - [Quick win #3] - Category: [X] - Impact: [X] - Effort: [X]
200
+
201
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
202
+
203
+ RECOMMENDED ACTION PLAN:
204
+
205
+ WEEK 1 (Immediate):
206
+ - [ ] [Critical action #1]
207
+ - [ ] [Priority quick win]
208
+
209
+ WEEK 2-4 (Short term):
210
+ - [ ] [Important action #2]
211
+ - [ ] [Other quick wins]
212
+
213
+ MONTH 2-3 (Medium term):
214
+ - [ ] [Recommended action #3]
215
+ - [ ] [Progressive improvements]
216
+
217
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
218
+
219
+ EXECUTIVE SUMMARY:
220
+
221
+ [Summary paragraph on overall project state, major strengths,
222
+ major weaknesses, and recommended trajectory. Mention if the
223
+ project is production-ready, requires corrections, or needs refactoring.]
224
+
225
+ General Recommendation: [Production-ready / Minor corrections /
226
+ Major refactoring / Overhaul necessary]
227
+
228
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
229
+ ```
230
+
231
+ ## IMPORTANT NOTES
232
+
233
+ - This command orchestrates the 4 specialized audits
234
+ - Use Docker for all analysis tools (`docker compose exec app ...` or `npx wp-env run ...`)
235
+ - Provide concrete examples with file:line for each problem
236
+ - Prioritize actions based on Impact/Effort matrix
237
+ - Security problems are ALWAYS top priority
238
+ - Propose automatable corrections (scripts, pre-commit hooks, CI steps)
239
+ - Report must be actionable, not just descriptive
240
+ - Pragmatism first: do not penalize a small single-file plugin for lacking layers when responsibilities are separated
241
+ - Out of scope: generic PHP rules (see the `php` stack), hosting and Bedrock-style deployments, WordPress core development
@@ -0,0 +1,28 @@
1
+ ---
2
+ description: "WordPress audit by axis: architecture, code-quality, security, testing, or all (scored aggregate)"
3
+ argument-hint: "<architecture|code-quality|security|testing|all> [path]"
4
+ ---
5
+
6
+ # WordPress Check
7
+
8
+ ## Arguments
9
+
10
+ $ARGUMENTS
11
+
12
+ The first argument is the axis; the rest (for example a project path) is passed on. Without an axis, run `all`.
13
+
14
+ | Axis | Checklist to follow |
15
+ |------|---------------------|
16
+ | `architecture` | `.claude/references/wordpress/checks/architecture.md` |
17
+ | `code-quality` | `.claude/references/wordpress/checks/code-quality.md` |
18
+ | `security` | `.claude/references/wordpress/checks/security.md` |
19
+ | `testing` | `.claude/references/wordpress/checks/testing.md` |
20
+ | `all` | `.claude/references/wordpress/checks/all.md`: the 4 axes, then a consolidated report scored out of 100 |
21
+
22
+ ## MISSION
23
+
24
+ 1. Read the first argument. If it is not one of the 5 axes above, list them with an example (`/wordpress:check security wp-content/plugins/my-plugin`) and stop.
25
+ 2. Read the checklist file of that axis and follow it step by step. In that file, `$ARGUMENTS` stands for the arguments that follow the axis.
26
+ 3. Produce the report in the output format the checklist defines.
27
+
28
+ Examples: `/wordpress:check architecture`, `/wordpress:check testing ./my-plugin`, `/wordpress:check all`.
@@ -27,7 +27,8 @@ src/app/
27
27
  ### Arquitectura: Feature-Based con Standalone Components
28
28
  - **Standalone Components**: Todos los componentes sin NgModules
29
29
  - **Signals First**: Estado reactivo con Angular Signals
30
- - **OnPush Strategy**: Todos los componentes con OnPush
30
+ - **OnPush Strategy**: Por defecto desde Angular 22.0.0 (omitir `changeDetection`; `ChangeDetectionStrategy.Eager` solo para desactivarlo)
31
+ - **Signal I/O**: `input()`, `output()`, `model()` en lugar de `@Input`/`@Output`/`EventEmitter`; sin `standalone: true` (por defecto)
31
32
  - **Modern Control Flow**: @if, @for, @switch (no *ngIf, *ngFor)
32
33
 
33
34
  Ver `rules/02-architecture.md` para patrones detallados.
@@ -47,7 +48,7 @@ Ver `rules/02-architecture.md` para patrones detallados.
47
48
  ```bash
48
49
  ng serve # Servidor desarrollo
49
50
  ng build # Build produccion
50
- ng generate component [name] --standalone # Generar componente
51
+ ng generate component [name] # Generar componente
51
52
  ```
52
53
 
53
54
  ### Pipeline de calidad
@@ -55,17 +55,31 @@ Soy un especialista en revisión de código Angular 22 y TypeScript. Mi enfoque
55
55
  - Importar desde `@angular/forms/signals`
56
56
  - Interoperabilidad con Reactive Forms existentes mediante el puente `SignalFormControl`
57
57
 
58
- **OnPush por defecto :**
59
- - Todos los nuevos componentes generados con `ChangeDetectionStrategy.OnPush` por defecto
60
- - El Angular CLI aplica OnPush automáticamente en el scaffolding
58
+ **OnPush por defecto (22.0.0, breaking change) :**
59
+ - Los componentes con `changeDetection` indefinido son ahora `OnPush`; ya no es necesario declararlo
60
+ - Para conservar el comportamiento anterior, declarar `changeDetection: ChangeDetectionStrategy.Eager`; la migración `ng update` `change-detection-eager` añade `Eager` a todos los componentes existentes
61
61
 
62
62
  **HttpClient Fetch por defecto :**
63
- - XHR deprecado — la API Fetch es el transporte por defecto
63
+ - la API Fetch es el transporte por defecto (XHR ya no es el predeterminado; solo `ServerXhr` de `platform-server` está deprecado)
64
64
  - Mejor compatibilidad SSR y soporte de streaming
65
65
 
66
66
  **TypeScript 6 requerido :**
67
67
  - TypeScript 5.x ya no es compatible — actualización obligatoria antes de migrar a Angular 22
68
68
 
69
+ **Otros breaking changes 22.0.0** (https://github.com/angular/angular/blob/main/CHANGELOG.md) **:**
70
+ - Router: `paramsInheritanceStrategy` es ahora `'always'` por defecto (usar `'emptyOnly'` para restaurar el comportamiento anterior); `provideRoutes()` eliminado (usar `provideRouter()` o `ROUTES`); `currentSnapshot` es ahora obligatorio en `CanMatchFn` / `CanMatch.canMatch` (migración incluida)
71
+ - Forms: las reglas de validación `min` y `max` ya no aceptan cadenas (solo números o null)
72
+ - HttpClient: el seguimiento del progreso de subida requiere `provideHttpClient(withXhr())` (schematic incluido); `withFetch` deprecado; `reportProgress` deprecado en favor de `reportUploadProgress` / `reportDownloadProgress`
73
+ - Core: `ComponentFactoryResolver`, `ComponentFactory`, `createNgModuleRef` y `ChangeDetectorRef.checkNoChanges` eliminados
74
+ - Plataforma: integración de Hammer.js eliminada; la hidratación incremental es ahora el comportamiento por defecto
75
+ - Compilador: los diagnósticos `nullishCoalescingNotNullable` y `optionalChainNotNullable` se activan ahora en proyectos existentes; los atributos con prefijo `data-` ya no enlazan inputs/outputs; los enlaces input/output duplicados lanzan un error
76
+
77
+ **Novedades de Angular 22.2 :**
78
+ - Core: APIs programáticas de `ErrorBoundary` (bloques `@boundary` soportados por el language service)
79
+ - Router: `containsTree` como API pública; lanzar un `RedirectCommand` provoca una redirección; recursos del router expuestos
80
+ - Signal Forms: se permiten campos ocultos permanentes
81
+ - Compilador: las plantillas pueden acceder a miembros privados; la opción `strictUnclaimedEventNames` detecta outputs mal escritos
82
+
69
83
  **Resource API estable (v20+) :**
70
84
  - `httpResource()`: carga declarativa con estados automáticos (loading, error)
71
85
  - Streaming resources (WebSockets, SSE) mediante `resource()` con lecturas cancelables
@@ -143,7 +157,6 @@ export class CounterComponent {
143
157
  // CORRECTO: standalone + @if/@for flujo de control
144
158
  @Component({
145
159
  selector: 'app-user-list',
146
- standalone: true,
147
160
  template: `
148
161
  @if (loading()) {
149
162
  <spinner />
@@ -179,7 +192,8 @@ private readonly destroyRef = inject(DestroyRef);
179
192
  |--------|----------|-------------|
180
193
  | Signals para estado local | signal(), computed(), effect() | BehaviorSubject para estado síncrono |
181
194
  | RxJS para flujos complejos | debounce, switchMap, websockets | RxJS para un simple booleano |
182
- | Componentes standalone | standalone: true, imports locales | NgModule para nuevos componentes |
195
+ | Componentes standalone | Standalone (por defecto desde v19, `standalone: true` innecesario), imports locales | NgModule para nuevos componentes |
196
+ | Inputs/outputs con signals | `input()`, `output()`, `model()` | `@Input()`, `@Output()`, `EventEmitter` |
183
197
  | Patrón Smart/Dumb | Container gestiona la lógica, Presentational muestra | Lógica de negocio en los templates |
184
198
  | inject() | Inyección a nivel de clase | Constructor sobrecargado |
185
199
 
@@ -365,6 +379,8 @@ it('should load users on init', () => {
365
379
  NO --> MAYOR: documentar la razón
366
380
  ```
367
381
 
382
+ Desde la 22.0.0 OnPush es el valor por defecto: señalar los componentes que declaran `ChangeDetectionStrategy.Eager` sin justificación.
383
+
368
384
  ### Árbol de decisión: @defer
369
385
 
370
386
  ```
@@ -625,7 +641,7 @@ import { signal, computed } from '@angular/core';
625
641
  - **Standalone por defecto**: todos los nuevos componentes deben ser standalone
626
642
  - **Nuevo flujo de control**: @if/@for/@switch reemplazan *ngIf/*ngFor/*ngSwitch
627
643
  - **inject() preferido**: inyección funcional en lugar de constructor sobrecargado
628
- - **OnPush obligatorio**: detección de cambios optimizada en todos los componentes presentacionales
644
+ - **OnPush por defecto (22.0.0+)**: no desactivarlo con `ChangeDetectionStrategy.Eager` sin una razón documentada
629
645
  - **@defer estratégico**: carga diferida granular para contenido secundario
630
646
 
631
647
  ---
@@ -31,7 +31,7 @@ Eres un **Ingeniero DevOps Senior** con más de 10 años de experiencia en CI/CD
31
31
  | Docker | Builds multi-etapa, optimización de imágenes, escaneo de seguridad |
32
32
  | Docker Compose | Orquestación local, perfiles, extensiones |
33
33
  | Kubernetes | Deployments, Services, Ingress, ConfigMaps, Secrets |
34
- | Helm | Charts, values, templating | 4.2.2 (Helm 4 = MAJOR — server-side apply, WASM plugins, API v4 ; Helm 3 EOL seguridad nov. 2026) |
34
+ | Helm | Charts, values, templating | 4.3.1 (Helm 4 = MAJOR — server-side apply, WASM plugins, API v4 ; Helm 3 EOL seguridad nov. 2026) |
35
35
 
36
36
  ### Proveedores Cloud
37
37
  | Proveedor | Servicios |
@@ -12,7 +12,7 @@ hooks:
12
12
  - matcher: "Bash"
13
13
  hooks:
14
14
  - type: command
15
- command: "grep -qiE '(^|[^A-Za-z_])(DROP[[:space:]]+(DATABASE|SCHEMA|TABLE)|TRUNCATE)([^A-Za-z_]|$)' && { echo \"BLOQUEADO: SQL destructivo (DROP DATABASE/SCHEMA/TABLE, TRUNCATE). Proponer el comando al usuario para que lo ejecute él mismo.\" >&2; exit 2; } || exit 0"
15
+ command: "grep -qiE '(^|[^A-Za-z_])(DROP[[:space:]]+(DATABASE|SCHEMA|TABLE)([^A-Za-z_]|$)|TRUNCATE[[:space:]]+[^[:space:]-])' && { echo \"BLOQUEADO: SQL destructivo (DROP DATABASE/SCHEMA/TABLE, TRUNCATE). Proponer el comando al usuario para que lo ejecute él mismo.\" >&2; exit 2; } || exit 0"
16
16
  ---
17
17
 
18
18
  # Agente Migration Specialist
@@ -126,13 +126,13 @@ Selecciona automáticamente el perfil basándose en palabras clave de la tarea:
126
126
  ### 5. Integración de Hooks (Claude Code 2.1.23+)
127
127
 
128
128
  ```
129
- SessionStart → session-restore.sh → Inyectar contexto Ralph
129
+ SessionStart → session-restore.sh → Inyectar contexto Ralph + listar la DoD (sin ejecutarla)
130
130
  ↓
131
- PreToolUse (una vez) → status-injector.sh → Inyectar estado DoD
131
+ PreToolUse (Agent|Task) → pre-tool-context.sh → Recordar la tarea de sprint actual
132
132
  ↓
133
133
  Claude trabaja...
134
134
  ↓
135
- Stop → stop-dod-gate.sh → Bloquear si DoD no satisfecho (exit 2)
135
+ Stop → stop-dod-gate.sh → Bloquear si DoD no satisfecho (decision: block)
136
136
  ```
137
137
 
138
138
  ## ¿/goal (interactivo) o Ralph (autónomo/CI)?
@@ -112,17 +112,10 @@ Para hooks ausentes, referenciar los templates en `.claude/templates/hooks/`:
112
112
  - `output-filter.json` — PostToolUse para filtrado de salidas grandes
113
113
  - `pre-compact.json` — PreCompact para preservación del contexto
114
114
  - `context-reinject.json` — SessionStart para reinyección post-compactación
115
- - `post-compact.json` — PostCompact para restauración del contexto tras compactación
116
115
 
117
- #### Hook PostCompact — Restauración del contexto
116
+ #### Restauración del contexto tras la compactación
118
117
 
119
- El hook **PostCompact** (Claude Code v2.1.76+) reinyecta el contexto crítico después de un evento de compactación automática. Sin él, Claude puede perder el hilo de las tareas activas, rutas de archivos y decisiones tomadas antes en la sesión.
120
-
121
- Template: `.claude/templates/hooks/post-compact.json`
122
-
123
- El hook lee `context-essentials.md` (un archivo que mantienes con el estado de la sesión actual) y lo inyecta como mensaje del sistema después de la compactación. Combinarlo con el hook **PreCompact** (`pre-compact.json`) que guarda los elementos esenciales antes de que ocurra la compactación.
124
-
125
- Ahorro estimado: evita 5-15 turnos de re-explicación por sesión larga (~3-8K tokens).
118
+ No existe un hook PostCompact útil: su salida nunca llega al modelo. Restaure lo esencial con `SessionStart` (matcher `compact`, template `context-reinject.json`), cuyo stdout se añade al contexto, y guíe el resumen con `PreCompact` (`pre-compact.json`, salida en texto plano).
126
119
 
127
120
  ### 5. Resumen
128
121
 
@@ -1,58 +1,46 @@
1
- # Hooks Quick Start Guide
1
+ # Guía de inicio rápido de hooks
2
2
 
3
- This directory contains Claude Code hooks for automated quality control and workflow enhancement.
3
+ Hooks de Claude Code para el control de calidad y la seguridad automatizados, instalados en su proyecto por claude-craft.
4
4
 
5
- ## Setup
5
+ ## Instalación
6
6
 
7
- 1. **Copy hooks to your project:**
7
+ 1. **Instalar con el instalador** (copia los scripts en `.claude/hooks/` y fusiona los hooks en `.claude/settings.json` sin sobrescribir los suyos):
8
8
  ```bash
9
- cp -r .claude/hooks/scripts/* .claude/hooks/
10
- chmod +x .claude/hooks/*.sh
9
+ bash Dev/scripts/install-common-rules.sh --hooks=default /ruta/del/proyecto
10
+ # o mediante el CLI: npx @the-bearded-bear/claude-craft install . --hooks=default
11
11
  ```
12
+ - `--hooks=default` (por defecto): guardas de seguridad, control de secretos, avisos sobre salidas voluminosas, reinyección del contexto tras la compactación.
13
+ - `--hooks=full`: `default` más la puerta de tests Stop, el lint posterior a la edición, la notificación de Slack, las métricas de sesión y las pistas de recuperación tras un fallo de herramienta.
14
+ - `--hooks=none`: sin hooks. Añada `,memory` (p. ej. `--hooks=default,memory`) para el add-on de memoria SQLite entre sesiones (requiere `sqlite3` y `jq`).
12
15
 
13
- 2. **Enable hooks in settings.json:**
14
- Copy the configuration from `hooks/templates/settings-hooks.json` to your `.claude/settings.json`.
16
+ 2. **Personalizar**: edite los scripts de `.claude/hooks/` según sus herramientas. Volver a ejecutar el instalador nunca elimina ni reescribe sus propios hooks.
15
17
 
16
- 3. **Customize as needed** - Edit the scripts to match your project's tooling.
18
+ 3. **Fusionar a mano** si lo prefiere: los fragmentos son `hooks.default.json`, `hooks.full.json` y `hooks.memory.json` (`node <claude-craft>/Dev/scripts/lib/merge-hooks.mjs add --settings .claude/settings.json --fragment <fragmento>`). Se copian ejemplos para adaptar en `.claude/templates/hooks/`.
17
19
 
18
- ## Available Hooks
20
+ ## Hooks disponibles
19
21
 
20
- | Hook | Purpose | Event |
21
- |------|---------|-------|
22
- | `pre-commit-check.sh` | Block secrets in commits | PreToolUse |
23
- | `post-edit-lint.sh` | Auto-lint on file save | PostToolUse |
24
- | `quality-gate.sh` | Run tests before completion | Stop |
25
- | `session-init.sh` | Load project context | SessionStart |
26
- | `notify-slack.sh` | Slack notifications | Notification |
27
- | `block-dangerous-commands.sh` | Block rm -rf, sudo, etc. | PreToolUse |
28
- | `setup-init.sh` | Initialize project on first run | Setup |
22
+ | Hook | Función | Evento | Perfil |
23
+ |------|---------|--------|--------|
24
+ | `guard-network.sh` | Bloquea descargar y ejecutar (`curl \| sh`) | PreToolUse | default |
25
+ | `block-dangerous-commands.sh` | Bloquea `rm -rf /`, `sudo`, `chmod 777`... | PreToolUse | default |
26
+ | `pre-commit-check.sh` | Bloquea secretos en los commits | PreToolUse | default |
27
+ | `protect-sensitive-files.sh` | Bloquea la edición de `.env`, claves... | PreToolUse | default |
28
+ | `output-size-hint.sh` | Aconseja resumir las salidas grandes | PostToolUse | default |
29
+ | `post-edit-lint.sh` | Lint automático tras editar | PostToolUse | full |
30
+ | `quality-gate.sh` | Ejecuta los tests antes de terminar | Stop | full |
31
+ | `notify-slack.sh` | Notificaciones de Slack | Notification | full |
32
+ | `session-init.sh` | Detecta el stack, exporta variables seguras de `.env.local` | SessionStart | full |
33
+ | `session-end.sh` | Registro y métricas de sesión | SessionEnd | full |
34
+ | `post-tool-failure.sh` | Pistas de recuperación tras un fallo de herramienta | PostToolUseFailure | full |
35
+ | `pre-compact.sh` | Respalda el estado BMAD antes de compactar | PreCompact | opcional (no conectado) |
36
+ | `output-filter.sh` | Trunca las salidas de más de 50 KB | PostToolUse | opcional (ejemplo) |
29
37
 
30
- ## Hook Events (11 total)
38
+ ## Conviene saber
31
39
 
32
- - **PreToolUse / PostToolUse** - Before/after tool execution
33
- - **Stop / SubagentStop** - When agent finishes
34
- - **SessionStart / SessionEnd** - Session lifecycle
35
- - **Setup** - On `--init`, `--init-only`, `--maintenance` (v2.1.20+)
36
- - **PermissionRequest** - Permission dialogs
37
- - **UserPromptSubmit** - User input
38
- - **Notification** - Notifications
39
- - **PreCompact** - Before context compaction
40
+ - El payload llega como **JSON por stdin**; solo el **código de salida 2** bloquea (cualquier otro código distinto de cero es un error no bloqueante).
41
+ - Solo `hookSpecificOutput.additionalContext` llega al modelo; el stdout en texto plano de PreCompact se lee como instrucciones de compactación.
42
+ - Los scripts necesitan `jq` o `node` para leer el payload: las guardas de seguridad bloquean si no hay ninguno, los hooks informativos no hacen nada.
40
43
 
41
- ## Quick Enable
44
+ ## Más información
42
45
 
43
- Add to your `.claude/settings.json`:
44
-
45
- ```json
46
- {
47
- "hooks": {
48
- "Stop": [{
49
- "matcher": "",
50
- "hooks": [{"type": "command", "command": ".claude/hooks/quality-gate.sh"}]
51
- }]
52
- }
53
- }
54
- ```
55
-
56
- ## More Information
57
-
58
- See the full documentation: [docs/HOOKS.md](/docs/HOOKS.md)
46
+ Documentación completa: [docs/HOOKS.md](/docs/HOOKS.md) y la referencia oficial <https://code.claude.com/docs/en/hooks>.
@@ -372,7 +372,7 @@ Es mejor tener varias interfaces especificas que una interfaz general.
372
372
  - [ ] Sin excepciones nuevas no documentadas
373
373
 
374
374
  #### ISP
375
- - [ ] Las interfaces son pequenas y focalizadas (< 5 metodos)
375
+ - [ ] Las interfaces son pequenas y focalizadas (heuristica interna: < 5 metodos)
376
376
  - [ ] Los clientes solo dependen de los metodos que utilizan
377
377
  - [ ] Sin metodos `throw NotImplementedException()`
378
378
 
@@ -387,7 +387,7 @@ Es mejor tener varias interfaces especificas que una interfaz general.
387
387
 
388
388
  - **Libro:** *Clean Architecture* - Robert C. Martin
389
389
  - **Libro:** *SOLID Principles* - Uncle Bob
390
- - **Video:** [SOLID Principles Explained](https://www.youtube.com/watch?v=pTB30aXS77U)
390
+ - **Article:** [The Relevance of SOLID — Robert C. Martin](https://blog.cleancoder.com/uncle-bob/2020/10/18/Solid-Relevance.html)
391
391
 
392
392
  ---
393
393
 
@@ -65,7 +65,9 @@ main (production-ready)
65
65
  [optional footer(s)]
66
66
  ```
67
67
 
68
- ### Tipos obligatorios
68
+ ### Tipos
69
+
70
+ La especificación Conventional Commits 1.0.0 solo exige `feat` y `fix`; los demás tipos son una convención de equipo (`@commitlint/config-conventional`).
69
71
 
70
72
  | Tipo | Descripcion | Ejemplo |
71
73
  |------|-------------|---------|
@@ -80,6 +82,10 @@ main (production-ready)
80
82
  | `ci` | Configuracion CI/CD | `ci: add lint step to pipeline` |
81
83
  | `chore` | Otros (sin codigo prod) | `chore: update .gitignore` |
82
84
 
85
+ ### Breaking changes
86
+
87
+ Añadir `!` antes de los dos puntos (`feat(api)!: remove v1 endpoints`) y/o un pie `BREAKING CHANGE: <descripción>` (mayúsculas, con dos puntos). Corresponde a un incremento MAJOR de SemVer.
88
+
83
89
  ### Scopes recomendados
84
90
 
85
91
  Utiliza los bounded contexts o modulos de tu proyecto:
@@ -544,8 +544,8 @@ flowchart TD
544
544
  ## Recursos
545
545
 
546
546
  - **Keep a Changelog:** [keepachangelog.com](https://keepachangelog.com/)
547
- - **ADR:** [adr.github.io](https://adr.github.io/)
548
- - **OpenAPI:** [swagger.io/specification](https://swagger.io/specification/)
547
+ - **ADR:** [adr.github.io](https://adr.github.io/) (MADR 4.0.0)
548
+ - **OpenAPI:** [spec.openapis.org/oas/latest.html](https://spec.openapis.org/oas/latest.html)
549
549
  - **Diataxis:** [diataxis.fr](https://diataxis.fr/) (framework de documentacion)
550
550
 
551
551
  ---