@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,242 @@
1
+ # Vérification complète de la conformité WordPress
2
+
3
+ ## Arguments
4
+
5
+ $ARGUMENTS (optionnel : chemin du plugin/thème à analyser)
6
+
7
+ ## Mode Plan
8
+
9
+ > Le mode plan est activé automatiquement lorsque le périmètre couvre plusieurs modules ou nécessite une investigation transverse.
10
+
11
+ ## MISSION
12
+
13
+ Réaliser un audit de conformité complet du plugin ou du thème WordPress en orchestrant les 4 vérifications majeures : Architecture, Qualité du code, Tests et Sécurité. Produire un rapport consolidé avec un score global sur 100 points.
14
+
15
+ ### Étape 1 : Préparation de l'audit
16
+
17
+ Préparer l'environnement d'audit :
18
+ - [ ] Identifier le chemin du projet à auditer
19
+ - [ ] Vérifier la présence des fichiers clés (fichier d'en-tête du plugin ou `style.css`/`theme.json`, `composer.json`, `package.json`, `.wp-env.json`, `phpcs.xml*`, `phpstan.neon*`, `uninstall.php`, fichiers `block.json`)
20
+ - [ ] Lister les répertoires principaux (`src/` ou `includes/`, `blocks/`, `languages/`, `tests/`, workflows CI)
21
+ - [ ] Identifier les valeurs déclarées `Requires at least`, `Requires PHP`, `Requires Plugins`, et les versions de l'outillage dans les lockfiles
22
+ - [ ] Déterminer le type : plugin, thème classique, thème de blocs ou mixte ; noter si le projet dépend de WooCommerce
23
+
24
+ **Note** : Si $ARGUMENTS est fourni, l'utiliser comme chemin du projet, sinon utiliser le répertoire courant.
25
+
26
+ ### Étape 2 : Audit de l'architecture (25 points)
27
+
28
+ **Commande** : Utiliser la slash command `/wordpress:check architecture` ou suivre manuellement les étapes de `.claude/references/wordpress/checks/architecture.md`
29
+
30
+ **Critères évalués** :
31
+ - En-tête du plugin, fichier de bootstrap, garde ABSPATH, autoload Composer (5 pts)
32
+ - Préfixes et namespaces pour les fonctions, classes, options, hooks, handles (5 pts)
33
+ - Organisation des hooks et callbacks légers (5 pts)
34
+ - Blocs (`block.json` apiVersion 3, `render.php`) et structure d'un thème de blocs (`theme.json`, templates, parts) (5 pts)
35
+ - Conception REST et cycle de vie (activation, désactivation, désinstallation) (5 pts)
36
+
37
+ **Référence** : `.claude/references/wordpress/checks/architecture.md`
38
+
39
+ ### Étape 3 : Audit de la qualité du code (25 points)
40
+
41
+ **Commande** : Utiliser la slash command `/wordpress:check code-quality` ou suivre manuellement les étapes de `.claude/references/wordpress/checks/code-quality.md`
42
+
43
+ **Critères évalués** :
44
+ - WPCS (PHPCS) passe (7 pts)
45
+ - i18n : text domain, commentaires pour traducteurs, traductions JS (5 pts)
46
+ - PHPStan (phpstan-wordpress) et ESLint (`@wordpress/eslint-plugin`) (5 pts)
47
+ - Principes KISS/DRY/YAGNI (4 pts)
48
+ - Taille des fonctions et complexité cognitive (4 pts)
49
+
50
+ **Référence** : `.claude/references/wordpress/checks/code-quality.md`
51
+
52
+ ### Étape 4 : Audit des tests (25 points)
53
+
54
+ **Commande** : Utiliser la slash command `/wordpress:check testing` ou suivre manuellement les étapes de `.claude/references/wordpress/checks/testing.md`
55
+
56
+ **Critères évalués** :
57
+ - Couverture de code (cible >= 80 %) en PHP et en JS (7 pts)
58
+ - PHPUnit avec `WP_UnitTestCase` via wp-env, `yoast/phpunit-polyfills` (6 pts)
59
+ - Jest via `@wordpress/scripts` pour les blocs et le JS (4 pts)
60
+ - Tests de bout en bout Playwright avec `@wordpress/e2e-test-utils-playwright` (3 pts)
61
+ - Qualité des tests : AAA, nommage, absence de flakiness, exécution en CI (3 pts)
62
+ - Isolation des tests et usage de factories (2 pts)
63
+
64
+ **Référence** : `.claude/references/wordpress/checks/testing.md`
65
+
66
+ ### Étape 5 : Audit de la sécurité (25 points)
67
+
68
+ **Commande** : Utiliser la slash command `/wordpress:check security` ou suivre manuellement les étapes de `.claude/references/wordpress/checks/security.md`
69
+
70
+ **Critères évalués** :
71
+ - Vérifications de capabilities et nonces sur chaque changement d'état (6 pts)
72
+ - `permission_callback` REST et validation des arguments (5 pts)
73
+ - Échappement en sortie (`esc_*`, `wp_kses_post`) (5 pts)
74
+ - Assainissement des entrées et `$wpdb->prepare()` (4 pts)
75
+ - Gestion des secrets et des identifiants, protections OWASP Top 10:2025 (3 pts)
76
+ - Vulnérabilités des dépendances et chaîne d'approvisionnement (`composer audit`, `npm audit`) (2 pts)
77
+
78
+ **Référence** : `.claude/references/wordpress/checks/security.md`
79
+
80
+ ### Étape 6 : WooCommerce (uniquement si le projet en dépend)
81
+
82
+ Appliquer `.claude/skills/woocommerce/checklist.md` : compatibilité HPOS déclarée, `wc_get_order()` / objets CRUD au lieu des post meta, compatibilité `cart_checkout_blocks`. Intégrer les constats dans les scores Architecture et Sécurité ; ignorer entièrement cette étape pour les projets sans WooCommerce.
83
+
84
+ ### Étape 7 : Consolidation et notation globale
85
+
86
+ Calculer le score global et produire le rapport consolidé :
87
+ - [ ] Additionner les 4 scores (maximum 100 points)
88
+ - [ ] Identifier les catégories critiques (<50 %)
89
+ - [ ] Lister tous les problèmes critiques transverses
90
+ - [ ] Prioriser les actions par impact/effort
91
+ - [ ] Produire le rapport consolidé final
92
+
93
+ **Barème de notation** :
94
+ - 90-100 : Excellent - Projet de référence
95
+ - 75-89 : Très bien - Quelques améliorations mineures
96
+ - 60-74 : Acceptable - Des améliorations sont nécessaires
97
+ - 40-59 : Insuffisant - Refactoring majeur nécessaire
98
+ - 0-39 : Critique - Refonte complète nécessaire
99
+
100
+ ### Étape 8 : Recommandations et plan d'action
101
+
102
+ - [ ] Identifier les 3 actions prioritaires toutes catégories confondues
103
+ - [ ] Estimer l'effort et l'impact (Faible/Moyen/Élevé) de chacune
104
+ - [ ] Proposer un ordre d'implémentation
105
+ - [ ] Suggérer des quick wins (fort ratio impact/effort)
106
+
107
+ ## FORMAT DE SORTIE
108
+
109
+ ```
110
+ AUDIT DE CONFORMITÉ WORDPRESS - RAPPORT COMPLET
111
+ ================================================
112
+
113
+ SCORE GLOBAL : XX/100
114
+
115
+ NIVEAU DE CONFORMITÉ : [Excellent/Très bien/Acceptable/Insuffisant/Critique]
116
+
117
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
118
+
119
+ SCORES PAR CATÉGORIE :
120
+
121
+ ARCHITECTURE : XX/25 [██████████░░░░░░░░░░] XX%
122
+ QUALITÉ DU CODE : XX/25 [██████████░░░░░░░░░░] XX%
123
+ TESTS : XX/25 [██████████░░░░░░░░░░] XX%
124
+ SÉCURITÉ : XX/25 [██████████░░░░░░░░░░] XX%
125
+
126
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
127
+
128
+ POINTS FORTS GLOBAUX :
129
+ 1. [Point fort identifié dans plusieurs catégories]
130
+ 2. [Autre point fort majeur]
131
+ 3. [Troisième point fort]
132
+
133
+ AMÉLIORATIONS GLOBALES :
134
+ 1. [Amélioration transverse mineure]
135
+ 2. [Autre amélioration recommandée]
136
+ 3. [Troisième amélioration]
137
+
138
+ PROBLÈMES CRITIQUES :
139
+ 1. [Problème critique n°1 - catégorie concernée]
140
+ 2. [Problème critique n°2 - catégorie concernée]
141
+ 3. [Problème critique n°3 - catégorie concernée]
142
+
143
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
144
+
145
+ DÉTAILS PAR CATÉGORIE :
146
+
147
+ ┌─────────────────────────────────────────────┐
148
+ │ ARCHITECTURE (XX/25) │
149
+ └─────────────────────────────────────────────┘
150
+
151
+ Sous-scores :
152
+ • En-tête / bootstrap / autoload : XX/5
153
+ • Préfixes / namespaces : XX/5
154
+ • Organisation des hooks : XX/5
155
+ • Blocs / structure du thème : XX/5
156
+ • REST / cycle de vie : XX/5
157
+
158
+ Points forts :
159
+ - [Points forts de l'architecture]
160
+
161
+ Problèmes :
162
+ - [Problèmes d'architecture]
163
+
164
+ [Sections similaires pour Qualité du code, Tests et Sécurité...]
165
+
166
+ WOOCOMMERCE (le cas échéant) : [constats HPOS / CRUD / blocs de paiement]
167
+
168
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
169
+
170
+ TOP 3 DES ACTIONS PRIORITAIRES (TOUTES CATÉGORIES) :
171
+
172
+ 1. CRITIQUE - [Action n°1]
173
+ Catégorie : [Architecture/Qualité/Tests/Sécurité]
174
+ Impact : [Élevé/Moyen/Faible]
175
+ Effort : [Élevé/Moyen/Faible]
176
+ Priorité : IMMÉDIATE
177
+
178
+ Description détaillée :
179
+ [Explication du problème et de la solution proposée]
180
+
181
+ Fichiers concernés :
182
+ - [fichier:ligne]
183
+
184
+ Exemple de correction :
185
+ [Code ou commande de correction]
186
+
187
+ 2. IMPORTANT - [Action n°2]
188
+ [Même format...]
189
+
190
+ 3. RECOMMANDÉ - [Action n°3]
191
+ [Même format...]
192
+
193
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
194
+
195
+ QUICK WINS (Fort impact / Faible effort) :
196
+
197
+ - [Quick win n°1] - Catégorie : [X] - Impact : [X] - Effort : [X]
198
+ - [Quick win n°2] - Catégorie : [X] - Impact : [X] - Effort : [X]
199
+ - [Quick win n°3] - Catégorie : [X] - Impact : [X] - Effort : [X]
200
+
201
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
202
+
203
+ PLAN D'ACTION RECOMMANDÉ :
204
+
205
+ SEMAINE 1 (Immédiat) :
206
+ - [ ] [Action critique n°1]
207
+ - [ ] [Quick win prioritaire]
208
+
209
+ SEMAINES 2-4 (Court terme) :
210
+ - [ ] [Action importante n°2]
211
+ - [ ] [Autres quick wins]
212
+
213
+ MOIS 2-3 (Moyen terme) :
214
+ - [ ] [Action recommandée n°3]
215
+ - [ ] [Améliorations progressives]
216
+
217
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
218
+
219
+ RÉSUMÉ EXÉCUTIF :
220
+
221
+ [Paragraphe de synthèse sur l'état global du projet, ses principaux
222
+ points forts, ses principales faiblesses et la trajectoire recommandée.
223
+ Indiquer si le projet est prêt pour la production, nécessite des
224
+ corrections ou doit être refactoré.]
225
+
226
+ Recommandation générale : [Prêt pour la production / Corrections mineures /
227
+ Refactoring majeur / Refonte nécessaire]
228
+
229
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
230
+ ```
231
+
232
+ ## NOTES IMPORTANTES
233
+
234
+ - Cette commande orchestre les 4 audits spécialisés
235
+ - Utiliser Docker pour tous les outils d'analyse (`docker compose exec app ...` ou `npx wp-env run ...`)
236
+ - Fournir des exemples concrets avec fichier:ligne pour chaque problème
237
+ - Prioriser les actions selon la matrice Impact/Effort
238
+ - Les problèmes de sécurité sont TOUJOURS la priorité absolue
239
+ - Proposer des corrections automatisables (scripts, hooks pre-commit, étapes CI)
240
+ - Le rapport doit être actionnable, pas seulement descriptif
241
+ - Pragmatisme avant tout : ne pas pénaliser un petit plugin à fichier unique pour l'absence de couches lorsque les responsabilités sont séparées
242
+ - Hors périmètre : règles PHP générales (voir le stack `php`), hébergement et déploiements de type Bedrock, développement du cœur de WordPress
@@ -0,0 +1,28 @@
1
+ ---
2
+ description: "Audit WordPress par axe : architecture, code-quality, security, testing, ou all (agrégat noté)"
3
+ argument-hint: "<architecture|code-quality|security|testing|all> [chemin]"
4
+ ---
5
+
6
+ # Vérification WordPress
7
+
8
+ ## Arguments
9
+
10
+ $ARGUMENTS
11
+
12
+ Le premier argument est l'axe ; le reste (par exemple un chemin de projet) est transmis tel quel. Sans axe, exécutez `all`.
13
+
14
+ | Axe | Checklist à suivre |
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` : les 4 axes, puis un rapport consolidé noté sur 100 |
21
+
22
+ ## MISSION
23
+
24
+ 1. Lisez le premier argument. S'il ne correspond à aucun des 5 axes ci-dessus, listez-les avec un exemple (`/wordpress:check security wp-content/plugins/my-plugin`) et arrêtez-vous.
25
+ 2. Lisez le fichier de checklist de cet axe et suivez-le étape par étape. Dans ce fichier, `$ARGUMENTS` désigne les arguments qui suivent l'axe.
26
+ 3. Produisez le rapport au format de sortie défini par la checklist.
27
+
28
+ Exemples : `/wordpress:check architecture`, `/wordpress:check testing ./my-plugin`, `/wordpress:check all`.
@@ -27,7 +27,8 @@ src/app/
27
27
  ### Arquitetura: Feature-Based + Standalone
28
28
  - **Standalone Components**: Sem NgModules, imports explicitos
29
29
  - **Signals First**: Estado reativo com Angular Signals
30
- - **OnPush**: Todas componentes com ChangeDetectionStrategy.OnPush
30
+ - **OnPush**: Padrão desde o Angular 22.0.0 (omitir `changeDetection`; `ChangeDetectionStrategy.Eager` apenas para desativar)
31
+ - **Signal I/O**: `input()`, `output()`, `model()` em vez de `@Input`/`@Output`/`EventEmitter`; sem `standalone: true` (padrão)
31
32
  - **Control Flow**: @if, @for, @switch (nao *ngIf, *ngFor)
32
33
 
33
34
  Ver `rules/02-architecture.md` para padroes.
@@ -46,7 +47,7 @@ Ver `rules/02-architecture.md` para padroes.
46
47
  ### Comandos de desenvolvimento
47
48
  ```bash
48
49
  ng serve # Servidor de desenvolvimento
49
- ng generate component features/... --standalone # Gerar componente
50
+ ng generate component features/... # Gerar componente
50
51
  ng build --configuration=production # Build producao
51
52
  ```
52
53
 
@@ -55,17 +55,31 @@ O estado e sincrono e usado para renderizacao?
55
55
  - Importar de `@angular/forms/signals`
56
56
  - Interoperabilidade com Reactive Forms existentes via ponte `SignalFormControl`
57
57
 
58
- **OnPush por padrao :**
59
- - Todos os novos componentes gerados com `ChangeDetectionStrategy.OnPush` por padrao
60
- - Angular CLI aplica OnPush automaticamente no scaffolding
58
+ **OnPush por padrão (22.0.0, breaking change) :**
59
+ - Componentes com `changeDetection` indefinido agora são `OnPush`; não é mais necessário declará-lo
60
+ - Para manter o comportamento anterior, declarar `changeDetection: ChangeDetectionStrategy.Eager`; a migração `ng update` `change-detection-eager` adiciona `Eager` a todos os componentes existentes
61
61
 
62
62
  **HttpClient Fetch por padrao :**
63
- - XHR depreciado — API Fetch e o transporte padrao
63
+ - a API Fetch é o transporte padrão (XHR deixou de ser o padrão; apenas `ServerXhr` do `platform-server` está depreciado)
64
64
  - Melhor compatibilidade SSR e suporte a streaming
65
65
 
66
66
  **TypeScript 6 obrigatorio :**
67
67
  - TypeScript 5.x nao e mais suportado — atualizacao obrigatoria antes de migrar para Angular 22
68
68
 
69
+ **Outros breaking changes 22.0.0** (https://github.com/angular/angular/blob/main/CHANGELOG.md) **:**
70
+ - Router: `paramsInheritanceStrategy` agora é `'always'` por padrão (usar `'emptyOnly'` para restaurar o comportamento anterior); `provideRoutes()` removido (usar `provideRouter()` ou `ROUTES`); `currentSnapshot` agora é obrigatório em `CanMatchFn` / `CanMatch.canMatch` (migração fornecida)
71
+ - Forms: as regras de validação `min` e `max` não aceitam mais strings (apenas números ou null)
72
+ - HttpClient: o relatório de progresso de upload exige `provideHttpClient(withXhr())` (schematic fornecido); `withFetch` deprecado; `reportProgress` deprecado em favor de `reportUploadProgress` / `reportDownloadProgress`
73
+ - Core: `ComponentFactoryResolver`, `ComponentFactory`, `createNgModuleRef` e `ChangeDetectorRef.checkNoChanges` removidos
74
+ - Plataforma: integração do Hammer.js removida; a hidratação incremental agora é o comportamento padrão
75
+ - Compilador: os diagnósticos `nullishCoalescingNotNullable` e `optionalChainNotNullable` agora disparam em projetos existentes; atributos com prefixo `data-` não vinculam mais inputs/outputs; vinculações input/output duplicadas lançam erro
76
+
77
+ **Novidades do Angular 22.2 :**
78
+ - Core: APIs programáticas de `ErrorBoundary` (blocos `@boundary` suportados pelo language service)
79
+ - Router: `containsTree` como API pública; lançar um `RedirectCommand` dispara um redirecionamento; recursos do router expostos
80
+ - Signal Forms: campos ocultos permanentes permitidos
81
+ - Compilador: templates podem acessar membros privados; a opção `strictUnclaimedEventNames` detecta outputs com erro de digitação
82
+
69
83
  **Resource API estavel (v20+) :**
70
84
  - `httpResource()`: carregamento declarativo com estados automaticos (loading, error)
71
85
  - Streaming resources (WebSockets, SSE) via `resource()` com leituras cancelaveis
@@ -143,7 +157,6 @@ export class CounterComponent {
143
157
  // CORRETO: standalone + @if/@for control flow
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 sincrono |
181
194
  | RxJS para fluxos complexos | debounce, switchMap, websockets | RxJS para um simples boolean |
182
- | Standalone components | standalone: true, imports locais | NgModule para novos componentes |
195
+ | Standalone components | Standalone (padrão desde a v19, `standalone: true` desnecessário), imports locais | NgModule para novos componentes |
196
+ | Inputs/outputs com signals | `input()`, `output()`, `model()` | `@Input()`, `@Output()`, `EventEmitter` |
183
197
  | Smart/Dumb pattern | Container gerencia a logica, Presentational exibe | Logica de negocio nos templates |
184
198
  | inject() | Injecao no nivel da classe | Construtor sobrecarregado |
185
199
 
@@ -365,6 +379,8 @@ O componente utiliza OnPush?
365
379
  NAO --> MAIOR: documentar a razao
366
380
  ```
367
381
 
382
+ Desde a 22.0.0 o OnPush é o padrão: sinalizar os componentes que declaram `ChangeDetectionStrategy.Eager` sem justificativa.
383
+
368
384
  ### Arvore de decisao: @defer
369
385
 
370
386
  ```
@@ -625,7 +641,7 @@ import { signal, computed } from '@angular/core';
625
641
  - **Standalone por padrao**: todos os novos componentes devem ser standalone
626
642
  - **Novo control flow**: @if/@for/@switch substituem *ngIf/*ngFor/*ngSwitch
627
643
  - **inject() preferido**: injecao funcional ao inves do construtor sobrecarregado
628
- - **OnPush obrigatorio**: change detection otimizada em todos os componentes de apresentacao
644
+ - **OnPush por padrão (22.0.0+)**: não desativar com `ChangeDetectionStrategy.Eager` sem razão documentada
629
645
  - **@defer estrategico**: lazy loading granular para conteudo secundario
630
646
 
631
647
  ---
@@ -31,7 +31,7 @@ Você é um **Engenheiro DevOps Sênior** com mais de 10 anos de experiência em
31
31
  | Docker | Multi-stage builds, otimização de imagem, security scanning |
32
32
  | Docker Compose | Orquestração local, profiles, extensions |
33
33
  | Kubernetes | Deployments, Services, Ingress, ConfigMaps, Secrets |
34
- | Helm | Charts, values, templating | 4.2.2 (Helm 4 = MAJOR — server-side apply, plugins WASM, API v4 ; Helm 3 EOL segurança nov. 2026) |
34
+ | Helm | Charts, values, templating | 4.3.1 (Helm 4 = MAJOR — server-side apply, plugins WASM, API v4 ; Helm 3 EOL segurança nov. 2026) |
35
35
 
36
36
  ### Provedores de Nuvem
37
37
  | Provedor | Serviços |
@@ -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 destrutivo (DROP DATABASE/SCHEMA/TABLE, TRUNCATE). Propor o comando ao usuário para que ele mesmo o execute.\" >&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 destrutivo (DROP DATABASE/SCHEMA/TABLE, TRUNCATE). Propor o comando ao usuário para que ele mesmo o execute.\" >&2; exit 2; } || exit 0"
16
16
  ---
17
17
 
18
18
  # Agente Migration Specialist
@@ -126,13 +126,13 @@ Seleciona automaticamente o perfil com base nas palavras-chave da tarefa:
126
126
  ### 5. Integração de Hooks (Claude Code 2.1.23+)
127
127
 
128
128
  ```
129
- SessionStart → session-restore.sh → Injetar contexto Ralph
129
+ SessionStart → session-restore.sh → Injetar contexto Ralph + listar a DoD (sem executá-la)
130
130
  ↓
131
- PreToolUse (uma vez) → status-injector.sh → Injetar status DoD
131
+ PreToolUse (Agent|Task) → pre-tool-context.sh → Lembrar a tarefa de sprint atual
132
132
  ↓
133
133
  Claude trabalha...
134
134
  ↓
135
- Stop → stop-dod-gate.sh → Bloquear se DoD não satisfeito (exit 2)
135
+ Stop → stop-dod-gate.sh → Bloquear se DoD não satisfeito (decision: block)
136
136
  ```
137
137
 
138
138
  ## /goal (interativo) ou Ralph (autônomo/CI)?
@@ -112,17 +112,10 @@ Para hooks em falta, referenciar os templates em `.claude/templates/hooks/`:
112
112
  - `output-filter.json` — PostToolUse para filtragem de outputs grandes
113
113
  - `pre-compact.json` — PreCompact para preservação de contexto
114
114
  - `context-reinject.json` — SessionStart para reinjection pós-compaction
115
- - `post-compact.json` — PostCompact para restauração de contexto após compaction
116
115
 
117
- #### Hook PostCompact — Restauração de Contexto
116
+ #### Restauração de contexto após a compactação
118
117
 
119
- O hook **PostCompact** (Claude Code v2.1.76+) reinjecta contexto crítico após um evento de compaction automático. Sem ele, o Claude pode perder o rasto de tarefas ativas, caminhos de ficheiros e decisões tomadas anteriormente na sessão.
120
-
121
- Template: `.claude/templates/hooks/post-compact.json`
122
-
123
- O hook lê `context-essentials.md` (um ficheiro mantido com o estado da sessão atual) e injeta-o como mensagem de sistema após a compaction. Combinar com o hook **PreCompact** (`pre-compact.json`) que guarda os essenciais antes da compaction.
124
-
125
- Economia estimada: evita 5-15 turnos de re-explicação por sessão longa (~3-8K tokens).
118
+ Não existe um hook PostCompact útil: a sua saída nunca chega ao modelo. Restaure o essencial com `SessionStart` (matcher `compact`, template `context-reinject.json`), cujo stdout é adicionado ao contexto, e oriente o resumo com `PreCompact` (`pre-compact.json`, saída em texto simples).
126
119
 
127
120
  ### 5. Resumo
128
121
 
@@ -1,58 +1,46 @@
1
- # Hooks Quick Start Guide
1
+ # Guia de início rápido dos hooks
2
2
 
3
- This directory contains Claude Code hooks for automated quality control and workflow enhancement.
3
+ Hooks do Claude Code para controlo de qualidade e segurança automatizados, instalados no seu projeto pelo claude-craft.
4
4
 
5
- ## Setup
5
+ ## Instalação
6
6
 
7
- 1. **Copy hooks to your project:**
7
+ 1. **Instalar com o instalador** (copia os scripts para `.claude/hooks/` e funde os hooks em `.claude/settings.json` sem substituir os seus):
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 /caminho/do/projeto
10
+ # ou através do CLI: npx @the-bearded-bear/claude-craft install . --hooks=default
11
11
  ```
12
+ - `--hooks=default` (predefinição): guardas de segurança, verificação de segredos, avisos sobre saídas volumosas, reinjeção do contexto após a compactação.
13
+ - `--hooks=full`: `default` mais a barreira de testes Stop, o lint após edição, a notificação Slack, as métricas de sessão e as pistas de recuperação após falha de ferramenta.
14
+ - `--hooks=none`: sem hooks. Acrescente `,memory` (ex.: `--hooks=default,memory`) para o add-on de memória SQLite entre sessões (requer `sqlite3` e `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 os scripts em `.claude/hooks/` conforme as suas ferramentas. Voltar a executar o instalador nunca remove nem reescreve os seus próprios hooks.
15
17
 
16
- 3. **Customize as needed** - Edit the scripts to match your project's tooling.
18
+ 3. **Fundir à mão** se preferir: os fragmentos são `hooks.default.json`, `hooks.full.json` e `hooks.memory.json` (`node <claude-craft>/Dev/scripts/lib/merge-hooks.mjs add --settings .claude/settings.json --fragment <fragmento>`). Exemplos para adaptar são copiados para `.claude/templates/hooks/`.
17
19
 
18
- ## Available Hooks
20
+ ## Hooks disponíveis
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 | Função | Evento | Perfil |
23
+ |------|--------|--------|--------|
24
+ | `guard-network.sh` | Bloqueia descarregar e executar (`curl \| sh`) | PreToolUse | default |
25
+ | `block-dangerous-commands.sh` | Bloqueia `rm -rf /`, `sudo`, `chmod 777`... | PreToolUse | default |
26
+ | `pre-commit-check.sh` | Bloqueia segredos nos commits | PreToolUse | default |
27
+ | `protect-sensitive-files.sh` | Bloqueia a edição de `.env`, chaves... | PreToolUse | default |
28
+ | `output-size-hint.sh` | Aconselha resumir as saídas grandes | PostToolUse | default |
29
+ | `post-edit-lint.sh` | Lint automático após editar | PostToolUse | full |
30
+ | `quality-gate.sh` | Executa os testes antes de terminar | Stop | full |
31
+ | `notify-slack.sh` | Notificações Slack | Notification | full |
32
+ | `session-init.sh` | Deteta a stack, exporta variáveis seguras de `.env.local` | SessionStart | full |
33
+ | `session-end.sh` | Registo e métricas de sessão | SessionEnd | full |
34
+ | `post-tool-failure.sh` | Pistas de recuperação após falha de ferramenta | PostToolUseFailure | full |
35
+ | `pre-compact.sh` | Guarda o estado BMAD antes da compactação | PreCompact | opcional (não ligado) |
36
+ | `output-filter.sh` | Trunca as saídas com mais de 50 KB | PostToolUse | opcional (exemplo) |
29
37
 
30
- ## Hook Events (11 total)
38
+ ## Convém 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
+ - O payload chega como **JSON no stdin**; só o **código de saída 2** bloqueia (qualquer outro código diferente de zero é um erro não bloqueante).
41
+ - Só `hookSpecificOutput.additionalContext` chega ao modelo; o stdout em texto simples do PreCompact é lido como instruções de compactação.
42
+ - Os scripts precisam de `jq` ou `node` para ler o payload: as guardas de segurança bloqueiam se nenhum estiver disponível, os hooks informativos não fazem nada.
40
43
 
41
- ## Quick Enable
44
+ ## Mais informações
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
+ Documentação completa: [docs/HOOKS.md](/docs/HOOKS.md) e a referência oficial <https://code.claude.com/docs/en/hooks>.
@@ -372,7 +372,7 @@ A logica de negocio e isolada dos detalhes tecnicos
372
372
  - [ ] Sem excecoes novas nao documentadas
373
373
 
374
374
  #### ISP
375
- - [ ] As interfaces sao pequenas e focadas (< 5 metodos)
375
+ - [ ] As interfaces sao pequenas e focadas (heuristica interna: < 5 metodos)
376
376
  - [ ] Os clientes dependem apenas dos metodos que utilizam
377
377
  - [ ] Sem metodos `throw NotImplementedException()`
378
378
 
@@ -387,7 +387,7 @@ A logica de negocio e isolada dos detalhes tecnicos
387
387
 
388
388
  - **Livro:** *Clean Architecture* - Robert C. Martin
389
389
  - **Livro:** *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 obrigatorios
68
+ ### Tipos
69
+
70
+ A especificação Conventional Commits 1.0.0 exige apenas `feat` e `fix`; os demais tipos são uma convenção de equipe (`@commitlint/config-conventional`).
69
71
 
70
72
  | Tipo | Descricao | Exemplo |
71
73
  |------|-----------|---------|
@@ -80,6 +82,10 @@ main (production-ready)
80
82
  | `ci` | Configuracao CI/CD | `ci: add lint step to pipeline` |
81
83
  | `chore` | Outros (sem codigo de producao) | `chore: update .gitignore` |
82
84
 
85
+ ### Breaking changes
86
+
87
+ Adicionar `!` antes dos dois pontos (`feat(api)!: remove v1 endpoints`) e/ou um rodapé `BREAKING CHANGE: <descrição>` (maiúsculas, com dois pontos). Corresponde a um incremento MAJOR do SemVer.
88
+
83
89
  ### Scopes recomendados
84
90
 
85
91
  Utilize os bounded contexts ou modulos do seu projeto:
@@ -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 documentacao)
550
550
 
551
551
  ---