bigpowers 2.86.4 → 2.86.6

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 (568) hide show
  1. package/.agents/skills/commit-message/SKILL.md +1 -1
  2. package/.agents/skills/craft-skill/SKILL.md +2 -2
  3. package/.agents/skills/define-success/SKILL.md +6 -59
  4. package/.agents/skills/deploy/SKILL.md +1 -1
  5. package/.agents/skills/elaborate-spec/SKILL.md +1 -1
  6. package/.agents/skills/evolve-skill/SKILL.md +1 -1
  7. package/.agents/skills/harden-vps/SKILL.md +63 -60
  8. package/.agents/skills/investigate-bug/SKILL.md +2 -2
  9. package/.agents/skills/orchestrate-project/SKILL.md +1 -1
  10. package/.agents/skills/plan-refactor/SKILL.md +2 -2
  11. package/.agents/skills/plan-release/SKILL.md +2 -2
  12. package/.agents/skills/plan-work/SKILL.md +1 -1
  13. package/.agents/skills/using-bigpowers/SKILL.md +2 -2
  14. package/.agents/skills/wire-ci/SKILL.md +11 -14
  15. package/.agents/skills/write-document/SKILL.md +1 -1
  16. package/.cline/skills/align-grid/SKILL.md +110 -0
  17. package/.cline/skills/assess-impact/SKILL.md +91 -0
  18. package/.cline/skills/audit-code/SKILL.md +184 -0
  19. package/.cline/skills/audit-plan/SKILL.md +89 -0
  20. package/.cline/skills/build-epic/SKILL.md +105 -0
  21. package/.cline/skills/change-request/SKILL.md +121 -0
  22. package/.cline/skills/commit-message/SKILL.md +140 -0
  23. package/.cline/skills/compose-workflow/SKILL.md +82 -0
  24. package/.cline/skills/context7-mcp/SKILL.md +55 -0
  25. package/.cline/skills/craft-skill/SKILL.md +196 -0
  26. package/.cline/skills/deepen-architecture/SKILL.md +260 -0
  27. package/.cline/skills/define-language/SKILL.md +80 -0
  28. package/.cline/skills/define-success/SKILL.md +12 -0
  29. package/.cline/skills/delegate-task/SKILL.md +91 -0
  30. package/.cline/skills/deploy/SKILL.md +198 -0
  31. package/.cline/skills/design-interface/SKILL.md +97 -0
  32. package/.cline/skills/develop-tdd/SKILL.md +416 -0
  33. package/.cline/skills/diagnose-root/SKILL.md +24 -0
  34. package/.cline/skills/diagnose-stall/SKILL.md +54 -0
  35. package/.cline/skills/dispatch-agents/SKILL.md +118 -0
  36. package/.cline/skills/edit-document/SKILL.md +23 -0
  37. package/.cline/skills/elaborate-spec/SKILL.md +101 -0
  38. package/.cline/skills/enforce-first/SKILL.md +45 -0
  39. package/.cline/skills/evolve-skill/SKILL.md +55 -0
  40. package/.cline/skills/execute-plan/SKILL.md +61 -0
  41. package/.cline/skills/extract-design/SKILL.md +132 -0
  42. package/.cline/skills/find-way/SKILL.md +191 -0
  43. package/.cline/skills/fix-bug/SKILL.md +67 -0
  44. package/.cline/skills/gate-trace/SKILL.md +92 -0
  45. package/.cline/skills/generate-allure-report/SKILL.md +285 -0
  46. package/.cline/skills/grill-me/SKILL.md +108 -0
  47. package/.cline/skills/grill-with-docs/SKILL.md +53 -0
  48. package/.cline/skills/guard-git/SKILL.md +231 -0
  49. package/.cline/skills/harden-vps/SKILL.md +291 -0
  50. package/.cline/skills/hook-commits/SKILL.md +94 -0
  51. package/.cline/skills/inspect-quality/SKILL.md +106 -0
  52. package/.cline/skills/investigate-bug/SKILL.md +127 -0
  53. package/.cline/skills/kickoff-branch/SKILL.md +143 -0
  54. package/.cline/skills/maintain-wiki/SKILL.md +64 -0
  55. package/.cline/skills/map-codebase/SKILL.md +71 -0
  56. package/.cline/skills/migrate-spec/SKILL.md +862 -0
  57. package/.cline/skills/model-domain/SKILL.md +232 -0
  58. package/.cline/skills/orchestrate-project/SKILL.md +174 -0
  59. package/.cline/skills/organize-workspace/SKILL.md +164 -0
  60. package/.cline/skills/plan-refactor/SKILL.md +87 -0
  61. package/.cline/skills/plan-release/SKILL.md +145 -0
  62. package/.cline/skills/plan-tests/SKILL.md +75 -0
  63. package/.cline/skills/plan-work/SKILL.md +260 -0
  64. package/.cline/skills/publish-package/SKILL.md +328 -0
  65. package/.cline/skills/quick-fix/SKILL.md +114 -0
  66. package/.cline/skills/release-branch/SKILL.md +298 -0
  67. package/.cline/skills/request-review/SKILL.md +113 -0
  68. package/.cline/skills/research-first/SKILL.md +87 -0
  69. package/.cline/skills/reset-baseline/SKILL.md +21 -0
  70. package/.cline/skills/respond-review/SKILL.md +71 -0
  71. package/.cline/skills/run-benchmark/SKILL.md +85 -0
  72. package/.cline/skills/run-evals/SKILL.md +80 -0
  73. package/.cline/skills/run-planning/SKILL.md +101 -0
  74. package/.cline/skills/scope-work/SKILL.md +63 -0
  75. package/.cline/skills/search-skills/SKILL.md +73 -0
  76. package/.cline/skills/security-review/SKILL.md +384 -0
  77. package/.cline/skills/seed-conventions/SKILL.md +302 -0
  78. package/.cline/skills/session-state/SKILL.md +146 -0
  79. package/.cline/skills/setup-environment/SKILL.md +39 -0
  80. package/.cline/skills/simulate-agents/SKILL.md +26 -0
  81. package/.cline/skills/slice-tasks/SKILL.md +68 -0
  82. package/.cline/skills/smoke-test/SKILL.md +257 -0
  83. package/.cline/skills/spike-prototype/SKILL.md +95 -0
  84. package/.cline/skills/stocktake-skills/SKILL.md +74 -0
  85. package/.cline/skills/survey-context/SKILL.md +135 -0
  86. package/.cline/skills/terse-mode/SKILL.md +42 -0
  87. package/.cline/skills/trace-requirement/SKILL.md +69 -0
  88. package/.cline/skills/using-bigpowers/SKILL.md +111 -0
  89. package/.cline/skills/validate-contracts/SKILL.md +277 -0
  90. package/.cline/skills/validate-fix/SKILL.md +147 -0
  91. package/.cline/skills/verify-work/SKILL.md +191 -0
  92. package/.cline/skills/visual-dashboard/SKILL.md +50 -0
  93. package/.cline/skills/wire-ci/SKILL.md +374 -0
  94. package/.cline/skills/wire-observability/SKILL.md +97 -0
  95. package/.cline/skills/write-document/SKILL.md +255 -0
  96. package/.codebuddy/skills/commit-message/SKILL.md +1 -1
  97. package/.codebuddy/skills/craft-skill/SKILL.md +2 -2
  98. package/.codebuddy/skills/define-success/SKILL.md +6 -59
  99. package/.codebuddy/skills/deploy/SKILL.md +1 -1
  100. package/.codebuddy/skills/elaborate-spec/SKILL.md +1 -1
  101. package/.codebuddy/skills/evolve-skill/SKILL.md +1 -1
  102. package/.codebuddy/skills/harden-vps/SKILL.md +63 -60
  103. package/.codebuddy/skills/investigate-bug/SKILL.md +2 -2
  104. package/.codebuddy/skills/orchestrate-project/SKILL.md +1 -1
  105. package/.codebuddy/skills/plan-refactor/SKILL.md +2 -2
  106. package/.codebuddy/skills/plan-release/SKILL.md +2 -2
  107. package/.codebuddy/skills/plan-work/SKILL.md +1 -1
  108. package/.codebuddy/skills/using-bigpowers/SKILL.md +2 -2
  109. package/.codebuddy/skills/wire-ci/SKILL.md +11 -14
  110. package/.codebuddy/skills/write-document/SKILL.md +1 -1
  111. package/.codex/skills/commit-message/SKILL.md +1 -1
  112. package/.codex/skills/craft-skill/SKILL.md +2 -2
  113. package/.codex/skills/define-success/SKILL.md +6 -59
  114. package/.codex/skills/deploy/SKILL.md +1 -1
  115. package/.codex/skills/elaborate-spec/SKILL.md +1 -1
  116. package/.codex/skills/evolve-skill/SKILL.md +1 -1
  117. package/.codex/skills/harden-vps/SKILL.md +63 -60
  118. package/.codex/skills/investigate-bug/SKILL.md +2 -2
  119. package/.codex/skills/orchestrate-project/SKILL.md +1 -1
  120. package/.codex/skills/plan-refactor/SKILL.md +2 -2
  121. package/.codex/skills/plan-release/SKILL.md +2 -2
  122. package/.codex/skills/plan-work/SKILL.md +1 -1
  123. package/.codex/skills/using-bigpowers/SKILL.md +2 -2
  124. package/.codex/skills/wire-ci/SKILL.md +11 -14
  125. package/.codex/skills/write-document/SKILL.md +1 -1
  126. package/.copilot/skills/align-grid/SKILL.md +110 -0
  127. package/.copilot/skills/assess-impact/SKILL.md +91 -0
  128. package/.copilot/skills/audit-code/SKILL.md +184 -0
  129. package/.copilot/skills/audit-plan/SKILL.md +89 -0
  130. package/.copilot/skills/build-epic/SKILL.md +105 -0
  131. package/.copilot/skills/change-request/SKILL.md +121 -0
  132. package/.copilot/skills/commit-message/SKILL.md +140 -0
  133. package/.copilot/skills/compose-workflow/SKILL.md +82 -0
  134. package/.copilot/skills/context7-mcp/SKILL.md +55 -0
  135. package/.copilot/skills/craft-skill/SKILL.md +196 -0
  136. package/.copilot/skills/deepen-architecture/SKILL.md +260 -0
  137. package/.copilot/skills/define-language/SKILL.md +80 -0
  138. package/.copilot/skills/define-success/SKILL.md +12 -0
  139. package/.copilot/skills/delegate-task/SKILL.md +91 -0
  140. package/.copilot/skills/deploy/SKILL.md +198 -0
  141. package/.copilot/skills/design-interface/SKILL.md +97 -0
  142. package/.copilot/skills/develop-tdd/SKILL.md +416 -0
  143. package/.copilot/skills/diagnose-root/SKILL.md +24 -0
  144. package/.copilot/skills/diagnose-stall/SKILL.md +54 -0
  145. package/.copilot/skills/dispatch-agents/SKILL.md +118 -0
  146. package/.copilot/skills/edit-document/SKILL.md +23 -0
  147. package/.copilot/skills/elaborate-spec/SKILL.md +101 -0
  148. package/.copilot/skills/enforce-first/SKILL.md +45 -0
  149. package/.copilot/skills/evolve-skill/SKILL.md +55 -0
  150. package/.copilot/skills/execute-plan/SKILL.md +61 -0
  151. package/.copilot/skills/extract-design/SKILL.md +132 -0
  152. package/.copilot/skills/find-way/SKILL.md +191 -0
  153. package/.copilot/skills/fix-bug/SKILL.md +67 -0
  154. package/.copilot/skills/gate-trace/SKILL.md +92 -0
  155. package/.copilot/skills/generate-allure-report/SKILL.md +285 -0
  156. package/.copilot/skills/grill-me/SKILL.md +108 -0
  157. package/.copilot/skills/grill-with-docs/SKILL.md +53 -0
  158. package/.copilot/skills/guard-git/SKILL.md +231 -0
  159. package/.copilot/skills/harden-vps/SKILL.md +291 -0
  160. package/.copilot/skills/hook-commits/SKILL.md +94 -0
  161. package/.copilot/skills/inspect-quality/SKILL.md +106 -0
  162. package/.copilot/skills/investigate-bug/SKILL.md +127 -0
  163. package/.copilot/skills/kickoff-branch/SKILL.md +143 -0
  164. package/.copilot/skills/maintain-wiki/SKILL.md +64 -0
  165. package/.copilot/skills/map-codebase/SKILL.md +71 -0
  166. package/.copilot/skills/migrate-spec/SKILL.md +862 -0
  167. package/.copilot/skills/model-domain/SKILL.md +232 -0
  168. package/.copilot/skills/orchestrate-project/SKILL.md +174 -0
  169. package/.copilot/skills/organize-workspace/SKILL.md +164 -0
  170. package/.copilot/skills/plan-refactor/SKILL.md +87 -0
  171. package/.copilot/skills/plan-release/SKILL.md +145 -0
  172. package/.copilot/skills/plan-tests/SKILL.md +75 -0
  173. package/.copilot/skills/plan-work/SKILL.md +260 -0
  174. package/.copilot/skills/publish-package/SKILL.md +328 -0
  175. package/.copilot/skills/quick-fix/SKILL.md +114 -0
  176. package/.copilot/skills/release-branch/SKILL.md +298 -0
  177. package/.copilot/skills/request-review/SKILL.md +113 -0
  178. package/.copilot/skills/research-first/SKILL.md +87 -0
  179. package/.copilot/skills/reset-baseline/SKILL.md +21 -0
  180. package/.copilot/skills/respond-review/SKILL.md +71 -0
  181. package/.copilot/skills/run-benchmark/SKILL.md +85 -0
  182. package/.copilot/skills/run-evals/SKILL.md +80 -0
  183. package/.copilot/skills/run-planning/SKILL.md +101 -0
  184. package/.copilot/skills/scope-work/SKILL.md +63 -0
  185. package/.copilot/skills/search-skills/SKILL.md +73 -0
  186. package/.copilot/skills/security-review/SKILL.md +384 -0
  187. package/.copilot/skills/seed-conventions/SKILL.md +302 -0
  188. package/.copilot/skills/session-state/SKILL.md +146 -0
  189. package/.copilot/skills/setup-environment/SKILL.md +39 -0
  190. package/.copilot/skills/simulate-agents/SKILL.md +26 -0
  191. package/.copilot/skills/slice-tasks/SKILL.md +68 -0
  192. package/.copilot/skills/smoke-test/SKILL.md +257 -0
  193. package/.copilot/skills/spike-prototype/SKILL.md +95 -0
  194. package/.copilot/skills/stocktake-skills/SKILL.md +74 -0
  195. package/.copilot/skills/survey-context/SKILL.md +135 -0
  196. package/.copilot/skills/terse-mode/SKILL.md +42 -0
  197. package/.copilot/skills/trace-requirement/SKILL.md +69 -0
  198. package/.copilot/skills/using-bigpowers/SKILL.md +111 -0
  199. package/.copilot/skills/validate-contracts/SKILL.md +277 -0
  200. package/.copilot/skills/validate-fix/SKILL.md +147 -0
  201. package/.copilot/skills/verify-work/SKILL.md +191 -0
  202. package/.copilot/skills/visual-dashboard/SKILL.md +50 -0
  203. package/.copilot/skills/wire-ci/SKILL.md +374 -0
  204. package/.copilot/skills/wire-observability/SKILL.md +97 -0
  205. package/.copilot/skills/write-document/SKILL.md +255 -0
  206. package/.hermes/skills/commit-message/SKILL.md +1 -1
  207. package/.hermes/skills/craft-skill/SKILL.md +2 -2
  208. package/.hermes/skills/define-success/SKILL.md +6 -59
  209. package/.hermes/skills/deploy/SKILL.md +1 -1
  210. package/.hermes/skills/elaborate-spec/SKILL.md +1 -1
  211. package/.hermes/skills/evolve-skill/SKILL.md +1 -1
  212. package/.hermes/skills/harden-vps/SKILL.md +63 -60
  213. package/.hermes/skills/investigate-bug/SKILL.md +2 -2
  214. package/.hermes/skills/orchestrate-project/SKILL.md +1 -1
  215. package/.hermes/skills/plan-refactor/SKILL.md +2 -2
  216. package/.hermes/skills/plan-release/SKILL.md +2 -2
  217. package/.hermes/skills/plan-work/SKILL.md +1 -1
  218. package/.hermes/skills/using-bigpowers/SKILL.md +2 -2
  219. package/.hermes/skills/wire-ci/SKILL.md +11 -14
  220. package/.hermes/skills/write-document/SKILL.md +1 -1
  221. package/.kilocode/rules/commit-message.md +1 -1
  222. package/.kilocode/rules/craft-skill.md +2 -2
  223. package/.kilocode/rules/define-success.md +6 -59
  224. package/.kilocode/rules/deploy.md +1 -1
  225. package/.kilocode/rules/elaborate-spec.md +1 -1
  226. package/.kilocode/rules/evolve-skill.md +1 -1
  227. package/.kilocode/rules/harden-vps.md +63 -60
  228. package/.kilocode/rules/investigate-bug.md +2 -2
  229. package/.kilocode/rules/orchestrate-project.md +1 -1
  230. package/.kilocode/rules/plan-refactor.md +2 -2
  231. package/.kilocode/rules/plan-release.md +2 -2
  232. package/.kilocode/rules/plan-work.md +1 -1
  233. package/.kilocode/rules/using-bigpowers.md +2 -2
  234. package/.kilocode/rules/wire-ci.md +11 -14
  235. package/.kilocode/rules/write-document.md +1 -1
  236. package/.mimocode/skills/commit-message/SKILL.md +1 -1
  237. package/.mimocode/skills/craft-skill/SKILL.md +2 -2
  238. package/.mimocode/skills/define-success/SKILL.md +6 -59
  239. package/.mimocode/skills/deploy/SKILL.md +1 -1
  240. package/.mimocode/skills/elaborate-spec/SKILL.md +1 -1
  241. package/.mimocode/skills/evolve-skill/SKILL.md +1 -1
  242. package/.mimocode/skills/harden-vps/SKILL.md +63 -60
  243. package/.mimocode/skills/investigate-bug/SKILL.md +2 -2
  244. package/.mimocode/skills/orchestrate-project/SKILL.md +1 -1
  245. package/.mimocode/skills/plan-refactor/SKILL.md +2 -2
  246. package/.mimocode/skills/plan-release/SKILL.md +2 -2
  247. package/.mimocode/skills/plan-work/SKILL.md +1 -1
  248. package/.mimocode/skills/using-bigpowers/SKILL.md +2 -2
  249. package/.mimocode/skills/wire-ci/SKILL.md +11 -14
  250. package/.mimocode/skills/write-document/SKILL.md +1 -1
  251. package/.opencode/skills/align-grid/SKILL.md +110 -0
  252. package/.opencode/skills/assess-impact/SKILL.md +91 -0
  253. package/.opencode/skills/audit-code/SKILL.md +184 -0
  254. package/.opencode/skills/audit-plan/SKILL.md +89 -0
  255. package/.opencode/skills/build-epic/SKILL.md +105 -0
  256. package/.opencode/skills/change-request/SKILL.md +121 -0
  257. package/.opencode/skills/commit-message/SKILL.md +140 -0
  258. package/.opencode/skills/compose-workflow/SKILL.md +82 -0
  259. package/.opencode/skills/context7-mcp/SKILL.md +55 -0
  260. package/.opencode/skills/craft-skill/SKILL.md +196 -0
  261. package/.opencode/skills/deepen-architecture/SKILL.md +260 -0
  262. package/.opencode/skills/define-language/SKILL.md +80 -0
  263. package/.opencode/skills/define-success/SKILL.md +12 -0
  264. package/.opencode/skills/delegate-task/SKILL.md +91 -0
  265. package/.opencode/skills/deploy/SKILL.md +198 -0
  266. package/.opencode/skills/design-interface/SKILL.md +97 -0
  267. package/.opencode/skills/develop-tdd/SKILL.md +416 -0
  268. package/.opencode/skills/diagnose-root/SKILL.md +24 -0
  269. package/.opencode/skills/diagnose-stall/SKILL.md +54 -0
  270. package/.opencode/skills/dispatch-agents/SKILL.md +118 -0
  271. package/.opencode/skills/edit-document/SKILL.md +23 -0
  272. package/.opencode/skills/elaborate-spec/SKILL.md +101 -0
  273. package/.opencode/skills/enforce-first/SKILL.md +45 -0
  274. package/.opencode/skills/evolve-skill/SKILL.md +55 -0
  275. package/.opencode/skills/execute-plan/SKILL.md +61 -0
  276. package/.opencode/skills/extract-design/SKILL.md +132 -0
  277. package/.opencode/skills/find-way/SKILL.md +191 -0
  278. package/.opencode/skills/fix-bug/SKILL.md +67 -0
  279. package/.opencode/skills/gate-trace/SKILL.md +92 -0
  280. package/.opencode/skills/generate-allure-report/SKILL.md +285 -0
  281. package/.opencode/skills/grill-me/SKILL.md +108 -0
  282. package/.opencode/skills/grill-with-docs/SKILL.md +53 -0
  283. package/.opencode/skills/guard-git/SKILL.md +231 -0
  284. package/.opencode/skills/harden-vps/SKILL.md +291 -0
  285. package/.opencode/skills/hook-commits/SKILL.md +94 -0
  286. package/.opencode/skills/inspect-quality/SKILL.md +106 -0
  287. package/.opencode/skills/investigate-bug/SKILL.md +127 -0
  288. package/.opencode/skills/kickoff-branch/SKILL.md +143 -0
  289. package/.opencode/skills/maintain-wiki/SKILL.md +64 -0
  290. package/.opencode/skills/map-codebase/SKILL.md +71 -0
  291. package/.opencode/skills/migrate-spec/SKILL.md +862 -0
  292. package/.opencode/skills/model-domain/SKILL.md +232 -0
  293. package/.opencode/skills/orchestrate-project/SKILL.md +174 -0
  294. package/.opencode/skills/organize-workspace/SKILL.md +164 -0
  295. package/.opencode/skills/plan-refactor/SKILL.md +87 -0
  296. package/.opencode/skills/plan-release/SKILL.md +145 -0
  297. package/.opencode/skills/plan-tests/SKILL.md +75 -0
  298. package/.opencode/skills/plan-work/SKILL.md +260 -0
  299. package/.opencode/skills/publish-package/SKILL.md +328 -0
  300. package/.opencode/skills/quick-fix/SKILL.md +114 -0
  301. package/.opencode/skills/release-branch/SKILL.md +298 -0
  302. package/.opencode/skills/request-review/SKILL.md +113 -0
  303. package/.opencode/skills/research-first/SKILL.md +87 -0
  304. package/.opencode/skills/reset-baseline/SKILL.md +21 -0
  305. package/.opencode/skills/respond-review/SKILL.md +71 -0
  306. package/.opencode/skills/run-benchmark/SKILL.md +85 -0
  307. package/.opencode/skills/run-evals/SKILL.md +80 -0
  308. package/.opencode/skills/run-planning/SKILL.md +101 -0
  309. package/.opencode/skills/scope-work/SKILL.md +63 -0
  310. package/.opencode/skills/search-skills/SKILL.md +73 -0
  311. package/.opencode/skills/security-review/SKILL.md +384 -0
  312. package/.opencode/skills/seed-conventions/SKILL.md +302 -0
  313. package/.opencode/skills/session-state/SKILL.md +146 -0
  314. package/.opencode/skills/setup-environment/SKILL.md +39 -0
  315. package/.opencode/skills/simulate-agents/SKILL.md +26 -0
  316. package/.opencode/skills/slice-tasks/SKILL.md +68 -0
  317. package/.opencode/skills/smoke-test/SKILL.md +257 -0
  318. package/.opencode/skills/spike-prototype/SKILL.md +95 -0
  319. package/.opencode/skills/stocktake-skills/SKILL.md +74 -0
  320. package/.opencode/skills/survey-context/SKILL.md +135 -0
  321. package/.opencode/skills/terse-mode/SKILL.md +42 -0
  322. package/.opencode/skills/trace-requirement/SKILL.md +69 -0
  323. package/.opencode/skills/using-bigpowers/SKILL.md +111 -0
  324. package/.opencode/skills/validate-contracts/SKILL.md +277 -0
  325. package/.opencode/skills/validate-fix/SKILL.md +147 -0
  326. package/.opencode/skills/verify-work/SKILL.md +191 -0
  327. package/.opencode/skills/visual-dashboard/SKILL.md +50 -0
  328. package/.opencode/skills/wire-ci/SKILL.md +374 -0
  329. package/.opencode/skills/wire-observability/SKILL.md +97 -0
  330. package/.opencode/skills/write-document/SKILL.md +255 -0
  331. package/.pi/package.json +1 -1
  332. package/.pi/prompts/commit-message.md +1 -1
  333. package/.pi/prompts/craft-skill.md +2 -2
  334. package/.pi/prompts/define-success.md +5 -58
  335. package/.pi/prompts/deploy.md +1 -1
  336. package/.pi/prompts/elaborate-spec.md +1 -1
  337. package/.pi/prompts/evolve-skill.md +1 -1
  338. package/.pi/prompts/harden-vps.md +63 -60
  339. package/.pi/prompts/investigate-bug.md +2 -2
  340. package/.pi/prompts/orchestrate-project.md +1 -1
  341. package/.pi/prompts/plan-refactor.md +2 -2
  342. package/.pi/prompts/plan-release.md +2 -2
  343. package/.pi/prompts/plan-work.md +1 -1
  344. package/.pi/prompts/using-bigpowers.md +2 -2
  345. package/.pi/prompts/wire-ci.md +11 -14
  346. package/.pi/prompts/write-document.md +1 -1
  347. package/.pi/skills/commit-message/SKILL.md +1 -1
  348. package/.pi/skills/craft-skill/SKILL.md +2 -2
  349. package/.pi/skills/define-success/SKILL.md +6 -59
  350. package/.pi/skills/deploy/SKILL.md +1 -1
  351. package/.pi/skills/elaborate-spec/SKILL.md +1 -1
  352. package/.pi/skills/evolve-skill/SKILL.md +1 -1
  353. package/.pi/skills/harden-vps/SKILL.md +63 -60
  354. package/.pi/skills/investigate-bug/SKILL.md +2 -2
  355. package/.pi/skills/orchestrate-project/SKILL.md +1 -1
  356. package/.pi/skills/plan-refactor/SKILL.md +2 -2
  357. package/.pi/skills/plan-release/SKILL.md +2 -2
  358. package/.pi/skills/plan-work/SKILL.md +1 -1
  359. package/.pi/skills/using-bigpowers/SKILL.md +2 -2
  360. package/.pi/skills/wire-ci/SKILL.md +11 -14
  361. package/.pi/skills/write-document/SKILL.md +1 -1
  362. package/.qwen/skills/align-grid/SKILL.md +110 -0
  363. package/.qwen/skills/assess-impact/SKILL.md +91 -0
  364. package/.qwen/skills/audit-code/SKILL.md +184 -0
  365. package/.qwen/skills/audit-plan/SKILL.md +89 -0
  366. package/.qwen/skills/build-epic/SKILL.md +105 -0
  367. package/.qwen/skills/change-request/SKILL.md +121 -0
  368. package/.qwen/skills/commit-message/SKILL.md +140 -0
  369. package/.qwen/skills/compose-workflow/SKILL.md +82 -0
  370. package/.qwen/skills/context7-mcp/SKILL.md +55 -0
  371. package/.qwen/skills/craft-skill/SKILL.md +196 -0
  372. package/.qwen/skills/deepen-architecture/SKILL.md +260 -0
  373. package/.qwen/skills/define-language/SKILL.md +80 -0
  374. package/.qwen/skills/define-success/SKILL.md +12 -0
  375. package/.qwen/skills/delegate-task/SKILL.md +91 -0
  376. package/.qwen/skills/deploy/SKILL.md +198 -0
  377. package/.qwen/skills/design-interface/SKILL.md +97 -0
  378. package/.qwen/skills/develop-tdd/SKILL.md +416 -0
  379. package/.qwen/skills/diagnose-root/SKILL.md +24 -0
  380. package/.qwen/skills/diagnose-stall/SKILL.md +54 -0
  381. package/.qwen/skills/dispatch-agents/SKILL.md +118 -0
  382. package/.qwen/skills/edit-document/SKILL.md +23 -0
  383. package/.qwen/skills/elaborate-spec/SKILL.md +101 -0
  384. package/.qwen/skills/enforce-first/SKILL.md +45 -0
  385. package/.qwen/skills/evolve-skill/SKILL.md +55 -0
  386. package/.qwen/skills/execute-plan/SKILL.md +61 -0
  387. package/.qwen/skills/extract-design/SKILL.md +132 -0
  388. package/.qwen/skills/find-way/SKILL.md +191 -0
  389. package/.qwen/skills/fix-bug/SKILL.md +67 -0
  390. package/.qwen/skills/gate-trace/SKILL.md +92 -0
  391. package/.qwen/skills/generate-allure-report/SKILL.md +285 -0
  392. package/.qwen/skills/grill-me/SKILL.md +108 -0
  393. package/.qwen/skills/grill-with-docs/SKILL.md +53 -0
  394. package/.qwen/skills/guard-git/SKILL.md +231 -0
  395. package/.qwen/skills/harden-vps/SKILL.md +291 -0
  396. package/.qwen/skills/hook-commits/SKILL.md +94 -0
  397. package/.qwen/skills/inspect-quality/SKILL.md +106 -0
  398. package/.qwen/skills/investigate-bug/SKILL.md +127 -0
  399. package/.qwen/skills/kickoff-branch/SKILL.md +143 -0
  400. package/.qwen/skills/maintain-wiki/SKILL.md +64 -0
  401. package/.qwen/skills/map-codebase/SKILL.md +71 -0
  402. package/.qwen/skills/migrate-spec/SKILL.md +862 -0
  403. package/.qwen/skills/model-domain/SKILL.md +232 -0
  404. package/.qwen/skills/orchestrate-project/SKILL.md +174 -0
  405. package/.qwen/skills/organize-workspace/SKILL.md +164 -0
  406. package/.qwen/skills/plan-refactor/SKILL.md +87 -0
  407. package/.qwen/skills/plan-release/SKILL.md +145 -0
  408. package/.qwen/skills/plan-tests/SKILL.md +75 -0
  409. package/.qwen/skills/plan-work/SKILL.md +260 -0
  410. package/.qwen/skills/publish-package/SKILL.md +328 -0
  411. package/.qwen/skills/quick-fix/SKILL.md +114 -0
  412. package/.qwen/skills/release-branch/SKILL.md +298 -0
  413. package/.qwen/skills/request-review/SKILL.md +113 -0
  414. package/.qwen/skills/research-first/SKILL.md +87 -0
  415. package/.qwen/skills/reset-baseline/SKILL.md +21 -0
  416. package/.qwen/skills/respond-review/SKILL.md +71 -0
  417. package/.qwen/skills/run-benchmark/SKILL.md +85 -0
  418. package/.qwen/skills/run-evals/SKILL.md +80 -0
  419. package/.qwen/skills/run-planning/SKILL.md +101 -0
  420. package/.qwen/skills/scope-work/SKILL.md +63 -0
  421. package/.qwen/skills/search-skills/SKILL.md +73 -0
  422. package/.qwen/skills/security-review/SKILL.md +384 -0
  423. package/.qwen/skills/seed-conventions/SKILL.md +302 -0
  424. package/.qwen/skills/session-state/SKILL.md +146 -0
  425. package/.qwen/skills/setup-environment/SKILL.md +39 -0
  426. package/.qwen/skills/simulate-agents/SKILL.md +26 -0
  427. package/.qwen/skills/slice-tasks/SKILL.md +68 -0
  428. package/.qwen/skills/smoke-test/SKILL.md +257 -0
  429. package/.qwen/skills/spike-prototype/SKILL.md +95 -0
  430. package/.qwen/skills/stocktake-skills/SKILL.md +74 -0
  431. package/.qwen/skills/survey-context/SKILL.md +135 -0
  432. package/.qwen/skills/terse-mode/SKILL.md +42 -0
  433. package/.qwen/skills/trace-requirement/SKILL.md +69 -0
  434. package/.qwen/skills/using-bigpowers/SKILL.md +111 -0
  435. package/.qwen/skills/validate-contracts/SKILL.md +277 -0
  436. package/.qwen/skills/validate-fix/SKILL.md +147 -0
  437. package/.qwen/skills/verify-work/SKILL.md +191 -0
  438. package/.qwen/skills/visual-dashboard/SKILL.md +50 -0
  439. package/.qwen/skills/wire-ci/SKILL.md +374 -0
  440. package/.qwen/skills/wire-observability/SKILL.md +97 -0
  441. package/.qwen/skills/write-document/SKILL.md +255 -0
  442. package/.trae/skills/commit-message/SKILL.md +1 -1
  443. package/.trae/skills/craft-skill/SKILL.md +2 -2
  444. package/.trae/skills/define-success/SKILL.md +6 -59
  445. package/.trae/skills/deploy/SKILL.md +1 -1
  446. package/.trae/skills/elaborate-spec/SKILL.md +1 -1
  447. package/.trae/skills/evolve-skill/SKILL.md +1 -1
  448. package/.trae/skills/harden-vps/SKILL.md +63 -60
  449. package/.trae/skills/investigate-bug/SKILL.md +2 -2
  450. package/.trae/skills/orchestrate-project/SKILL.md +1 -1
  451. package/.trae/skills/plan-refactor/SKILL.md +2 -2
  452. package/.trae/skills/plan-release/SKILL.md +2 -2
  453. package/.trae/skills/plan-work/SKILL.md +1 -1
  454. package/.trae/skills/using-bigpowers/SKILL.md +2 -2
  455. package/.trae/skills/wire-ci/SKILL.md +11 -14
  456. package/.trae/skills/write-document/SKILL.md +1 -1
  457. package/.windsurf/rules/commit-message.md +1 -1
  458. package/.windsurf/rules/craft-skill.md +2 -2
  459. package/.windsurf/rules/define-success.md +6 -59
  460. package/.windsurf/rules/deploy.md +1 -1
  461. package/.windsurf/rules/elaborate-spec.md +1 -1
  462. package/.windsurf/rules/evolve-skill.md +1 -1
  463. package/.windsurf/rules/harden-vps.md +63 -60
  464. package/.windsurf/rules/investigate-bug.md +2 -2
  465. package/.windsurf/rules/orchestrate-project.md +1 -1
  466. package/.windsurf/rules/plan-refactor.md +2 -2
  467. package/.windsurf/rules/plan-release.md +2 -2
  468. package/.windsurf/rules/plan-work.md +1 -1
  469. package/.windsurf/rules/using-bigpowers.md +2 -2
  470. package/.windsurf/rules/wire-ci.md +11 -14
  471. package/.windsurf/rules/write-document.md +1 -1
  472. package/.zcode/skills/commit-message/SKILL.md +1 -1
  473. package/.zcode/skills/craft-skill/SKILL.md +2 -2
  474. package/.zcode/skills/define-success/SKILL.md +6 -59
  475. package/.zcode/skills/deploy/SKILL.md +1 -1
  476. package/.zcode/skills/elaborate-spec/SKILL.md +1 -1
  477. package/.zcode/skills/evolve-skill/SKILL.md +1 -1
  478. package/.zcode/skills/harden-vps/SKILL.md +63 -60
  479. package/.zcode/skills/investigate-bug/SKILL.md +2 -2
  480. package/.zcode/skills/orchestrate-project/SKILL.md +1 -1
  481. package/.zcode/skills/plan-refactor/SKILL.md +2 -2
  482. package/.zcode/skills/plan-release/SKILL.md +2 -2
  483. package/.zcode/skills/plan-work/SKILL.md +1 -1
  484. package/.zcode/skills/using-bigpowers/SKILL.md +2 -2
  485. package/.zcode/skills/wire-ci/SKILL.md +11 -14
  486. package/.zcode/skills/write-document/SKILL.md +1 -1
  487. package/CHANGELOG.md +14 -0
  488. package/SKILL-INDEX.md +2 -2
  489. package/package.json +1 -1
  490. package/scripts/adapters/agy.sh +3 -0
  491. package/scripts/adapters/continue.sh +3 -0
  492. package/scripts/adapters/cursor.sh +3 -0
  493. package/scripts/adapters/gemini.sh +5 -24
  494. package/scripts/adapters/mimo.sh +3 -0
  495. package/scripts/adapters/omp.sh +3 -0
  496. package/scripts/adapters/pi.sh +6 -3
  497. package/scripts/adapters/zcode.sh +3 -0
  498. package/scripts/adapters/zed.sh +3 -0
  499. package/scripts/check-skill-links.py +35 -0
  500. package/scripts/generate-workflow-diagrams.sh +102 -0
  501. package/scripts/golden-g13-test-orphans.sh +70 -0
  502. package/scripts/golden-g14-adapter-dispatch.sh +113 -0
  503. package/scripts/land-branch.sh +9 -3
  504. package/scripts/lib/__pycache__/link_utils.cpython-312.pyc +0 -0
  505. package/scripts/lib/__pycache__/srp_engine_links.cpython-312.pyc +0 -0
  506. package/scripts/lib/adapter-guard.sh +30 -0
  507. package/scripts/lib/golden-suite-gates.sh +28 -0
  508. package/scripts/lib/install-targets-b.sh +0 -8
  509. package/scripts/lib/sync-render.sh +0 -43
  510. package/scripts/lib/target-contracts.sh +37 -1
  511. package/scripts/targets.yaml +35 -13
  512. package/scripts/test-adapter-render.sh +116 -0
  513. package/scripts/test-adapters.sh +10 -3
  514. package/scripts/test-install-hub.sh +139 -0
  515. package/scripts/test-target-contracts.sh +73 -0
  516. package/scripts/tombstone-skill.sh +6 -0
  517. package/skills/commit-message/REFERENCE.md +1 -1
  518. package/skills/craft-skill/SKILL.md +2 -2
  519. package/skills/define-success/SKILL.md +7 -61
  520. package/skills/deploy/SKILL.md +1 -1
  521. package/skills/elaborate-spec/SKILL.md +1 -1
  522. package/skills/evolve-skill/REFERENCE.md +1 -1
  523. package/skills/harden-vps/REFERENCE.md +39 -36
  524. package/skills/harden-vps/SKILL.md +24 -24
  525. package/skills/investigate-bug/SKILL.md +2 -2
  526. package/skills/orchestrate-project/REFERENCE.md +1 -1
  527. package/skills/plan-refactor/SKILL.md +2 -2
  528. package/skills/plan-release/SKILL.md +2 -2
  529. package/skills/plan-work/SKILL.md +1 -1
  530. package/skills/security-review/fixtures/CWE-639-idor-negative.go +1 -1
  531. package/skills/security-review/fixtures/CWE-639-idor-positive.go +1 -1
  532. package/skills/using-bigpowers/SKILL.md +2 -2
  533. package/skills/wire-ci/REFERENCE.md +11 -14
  534. package/skills/write-document/REFERENCE.md +1 -1
  535. package/skills-lock.json +12 -12
  536. package/.fix_regex.sh +0 -16
  537. package/.hermes-verify-sed-fix.py +0 -53
  538. package/_test_e28s01.sh +0 -2
  539. package/audit-independent-unwaived-2026-07-06.md +0 -49
  540. package/hermes-verify-sed-fix.py +0 -30
  541. package/instructions +0 -1
  542. package/scripts/hermes-verify-e39s02.sh +0 -28
  543. package/scripts/test-agy-hub.sh +0 -60
  544. package/scripts/test-cline-adapter.sh +0 -55
  545. package/scripts/test-cline-hub.sh +0 -48
  546. package/scripts/test-codebuddy-adapter.sh +0 -63
  547. package/scripts/test-codebuddy-hub.sh +0 -49
  548. package/scripts/test-codex-adapter.sh +0 -63
  549. package/scripts/test-codex-hub.sh +0 -49
  550. package/scripts/test-copilot-adapter.sh +0 -47
  551. package/scripts/test-copilot-hub.sh +0 -43
  552. package/scripts/test-gemini-adapter.sh +0 -70
  553. package/scripts/test-gemini-hub.sh +0 -56
  554. package/scripts/test-hermes-adapter.sh +0 -85
  555. package/scripts/test-hermes-hub.sh +0 -52
  556. package/scripts/test-kilocode-adapter.sh +0 -55
  557. package/scripts/test-kilocode-hub.sh +0 -48
  558. package/scripts/test-mimo-hub.sh +0 -52
  559. package/scripts/test-opencode-adapter.sh +0 -47
  560. package/scripts/test-opencode-hub.sh +0 -43
  561. package/scripts/test-qwen-adapter.sh +0 -63
  562. package/scripts/test-qwen-hub.sh +0 -49
  563. package/scripts/test-trae-adapter.sh +0 -63
  564. package/scripts/test-trae-hub.sh +0 -49
  565. package/scripts/test-windsurf-adapter.sh +0 -63
  566. package/scripts/test-windsurf-hub.sh +0 -49
  567. package/scripts/test-zcode-hub.sh +0 -52
  568. package/test_figlet.py +0 -17
@@ -0,0 +1,231 @@
1
+ ---
2
+ name: guard-git
3
+ model: haiku
4
+ description: "Block dangerous git commands (push, force push, reset --hard, clean, branch -D, checkout/restore .) and enforce Conventional Commits & Branch Protection before an AI agent runs them. Installs hook scripts for Claude Code, Cursor, Cursor CLI, and Gemini CLI; documents Google Antigravity Terminal deny lists. Use when the user wants git safety hooks, to block git push or destructive git in agents, or to mirror the same policy across AI coding tools."
5
+ ---
6
+
7
+ # Guard Git
8
+ > **HARD GATE** — **HARD GATE** — Before committing, verify: branch is not main/master, author is correct, git user is configured. Bad commits are hard to fix.
9
+
10
+
11
+ Installs a shared hook that blocks destructive git operations and enforces workflow discipline. **Requires `jq` on the agent's PATH** when the hook runs.
12
+
13
+ ## What gets blocked/enforced
14
+
15
+ - **Safety**: `git push --force`, `git reset --hard`, `git clean -f`, `git branch -D`, `git checkout .`, `git restore .`.
16
+ - **Discipline**: Blocks direct commits or pushes to protected branches (`main`, `master`) unless `GIT_BIGPOWERS_LAND=1` (set only by `scripts/land-branch.sh`).
17
+ - **Allows**: `git push origin <feature-branch>` for backup/CI; solo land push to `main` only inside `land-branch.sh`.
18
+ - **Standardization**: Enforces [Conventional Commits](https://www.conventionalcommits.org/) for all `git commit` commands.
19
+ - **Secrets**: Blocks commits containing common secret patterns (`sk-`, `ghp_`, `AKIA`, `xoxb-`, `-----BEGIN` private keys) — see [REFERENCE.md](REFERENCE.md).
20
+
21
+ ## Quick start
22
+
23
+ 1. **Scope**: ask project-only vs global (paths differ per product).
24
+ 2. **Write the hook bundle** from [REFERENCE.md](REFERENCE.md) into the client's hooks directory.
25
+ 3. **Run `chmod +x`** on `pre-tool-use.sh`.
26
+ 4. **Merge** the hook snippet from [REFERENCE.md](REFERENCE.md) into the right settings file — do not wipe unrelated keys.
27
+ 5. **Verify** with the tests in [REFERENCE.md](REFERENCE.md).
28
+
29
+ | Client | Mechanism | Config |
30
+ |--------|-----------|--------|
31
+ | Claude Code | `PreToolUse` (Bash) | `.claude/settings.json` or `~/.claude/settings.json` |
32
+ | Cursor / Cursor CLI | `beforeShellExecution` | `.cursor/hooks.json` or `~/.cursor/hooks.json` |
33
+ | Gemini CLI | `BeforeTool` + `run_shell_command` | `.gemini/settings.json` or `~/.gemini/settings.json` |
34
+ | Google Antigravity | Built-in Terminal **Deny list** | Settings UI (no shell hook) |
35
+
36
+ **Modes (env on the hook command):** `GIT_GUARDRAILS_MODE` is `claude` (default) or `cursor` → stderr + exit `2` on block. Set `gemini` for Gemini CLI → JSON `decision` on stdout.
37
+
38
+ ## Customization
39
+
40
+ To add or remove patterns or protected branches, edit `pre-tool-use.sh`.
41
+
42
+ ## Advanced
43
+
44
+ Full JSON examples, merge rules, Antigravity deny-list entries, and test commands: [REFERENCE.md](REFERENCE.md).
45
+
46
+
47
+
48
+ <!-- story: e01s03 -->
49
+
50
+ ---
51
+
52
+ # Git guardrails — reference
53
+
54
+ ## Navigation
55
+
56
+ | Lines | Section |
57
+ |-------|---------|
58
+ | 1 | Title |
59
+ | 3–14 | Navigation |
60
+ | 16–24 | Secret patterns |
61
+ | 26–44 | Copy layout |
62
+ | 46–72 | Claude Code |
63
+ | 74–92 | Cursor and Cursor CLI |
64
+ | 94–120 | Gemini CLI |
65
+ | 122–135 | Google Antigravity |
66
+ | 137–178 | Verify (local tests) |
67
+
68
+ ## Secret patterns (audit + pre-commit)
69
+
70
+ Agents must not commit files containing:
71
+
72
+ - `sk-` (OpenAI API keys)
73
+ - `ghp_` / `gho_` (GitHub tokens)
74
+ - `AKIA` (AWS access key id)
75
+ - `xoxb-` (Slack bot tokens)
76
+ - `-----BEGIN` private keys
77
+
78
+ Use `audit-code` supply-chain checklist before commit. Consider `git-secrets` or custom pre-commit hook in target projects.
79
+
80
+ ## Copy layout
81
+
82
+ The main script is `pre-tool-use.sh`.
83
+
84
+ ```text
85
+ <hooks-dir>/pre-tool-use.sh
86
+ ```
87
+
88
+ Example project locations:
89
+
90
+ - Claude: `.claude/hooks/`
91
+ - Cursor: `.cursor/hooks/`
92
+ - Gemini: `.gemini/hooks/`
93
+
94
+ Use the same layout for user-level hooks (`~/.claude/hooks`, `~/.cursor/hooks`, `~/.gemini/hooks`).
95
+
96
+ ---
97
+
98
+ ## Claude Code
99
+
100
+ Hook command does **not** need `GIT_GUARDRAILS_MODE` (defaults to `claude`).
101
+
102
+ **Project** (`.claude/settings.json`):
103
+
104
+ ```json
105
+ {
106
+ "hooks": {
107
+ "PreToolUse": [
108
+ {
109
+ "matcher": "Bash",
110
+ "hooks": [
111
+ {
112
+ "type": "command",
113
+ "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/pre-tool-use.sh"
114
+ }
115
+ ]
116
+ }
117
+ ]
118
+ }
119
+ }
120
+ ```
121
+
122
+ ---
123
+
124
+ ## Cursor and Cursor CLI
125
+
126
+ Use `beforeShellExecution`. Set `GIT_GUARDRAILS_MODE=cursor`.
127
+
128
+ **Project** (`.cursor/hooks.json`):
129
+
130
+ ```json
131
+ {
132
+ "version": 1,
133
+ "hooks": {
134
+ "beforeShellExecution": [
135
+ {
136
+ "command": "GIT_GUARDRAILS_MODE=cursor .cursor/hooks/pre-tool-use.sh",
137
+ "matcher": "git"
138
+ }
139
+ ]
140
+ }
141
+ }
142
+ ```
143
+
144
+ ---
145
+
146
+ ## Gemini CLI
147
+
148
+ Use `BeforeTool` with matcher `run_shell_command`. Set **`GIT_GUARDRAILS_MODE=gemini`**.
149
+
150
+ **Project** (`.gemini/settings.json`):
151
+
152
+ ```json
153
+ {
154
+ "hooks": {
155
+ "BeforeTool": [
156
+ {
157
+ "matcher": "run_shell_command",
158
+ "hooks": [
159
+ {
160
+ "name": "git-guardrails",
161
+ "type": "command",
162
+ "command": "GIT_GUARDRAILS_MODE=gemini \"$GEMINI_PROJECT_DIR\"/.gemini/hooks/pre-tool-use.sh",
163
+ "timeout": 5000
164
+ }
165
+ ]
166
+ }
167
+ ]
168
+ }
169
+ }
170
+ ```
171
+
172
+ ---
173
+
174
+ ## Google Antigravity
175
+
176
+ Add **Deny list** entries in **Antigravity → Settings → Terminal**:
177
+
178
+ - `git push --force`
179
+ - `git push origin main`
180
+ - `git push origin master`
181
+ - `git reset --hard`
182
+ - `git clean`
183
+ - `git branch -D`
184
+ - `git checkout .`
185
+ - `git restore .`
186
+
187
+ ---
188
+
189
+ ## Verify (local tests)
190
+
191
+ **1. Block push to main without land mode (Claude mode):**
192
+ ```bash
193
+ echo '{"tool_input":{"command":"git push origin main"}}' | ./pre-tool-use.sh
194
+ # Expected: exit 2, protected branch message
195
+ ```
196
+
197
+ **2. Allow push to main with GIT_BIGPOWERS_LAND=1:**
198
+ ```bash
199
+ GIT_BIGPOWERS_LAND=1 echo '{"tool_input":{"command":"git push origin main"}}' | ./pre-tool-use.sh
200
+ # Expected: exit 0 (when on main)
201
+ ```
202
+
203
+ **3. Allow push to feature branch:**
204
+ ```bash
205
+ echo '{"tool_input":{"command":"git push -u origin feat/my-task"}}' | ./pre-tool-use.sh
206
+ # Expected: exit 0
207
+ ```
208
+
209
+ **4. Conventional Commits (Gemini mode):**
210
+ ```bash
211
+ echo '{"tool_input":{"command":"git commit -m \"bad message\""}}' | GIT_GUARDRAILS_MODE=gemini ./pre-tool-use.sh
212
+ # Expected: exit 0, {"decision":"deny", "reason":"..."}
213
+ ```
214
+
215
+ **5. Protected Branch commit (Cursor mode):**
216
+ ```bash
217
+ # Run on 'main' branch
218
+ echo '{"command":"git commit -m \"feat: valid message\""}' | GIT_GUARDRAILS_MODE=cursor ./pre-tool-use.sh
219
+ # Expected: exit 2, "Direct commits to protected branch 'main' are forbidden"
220
+ ```
221
+
222
+ **6. Land script exists:**
223
+ ```bash
224
+ test -x scripts/land-branch.sh && echo OK
225
+ ```
226
+
227
+ **7. Allow (Gemini mode):**
228
+ ```bash
229
+ echo '{"tool_input":{"command":"git status"}}' | GIT_GUARDRAILS_MODE=gemini ./pre-tool-use.sh
230
+ # Expected: exit 0, {"decision":"allow"}
231
+ ```
@@ -0,0 +1,291 @@
1
+ ---
2
+ name: harden-vps
3
+ model: haiku
4
+ description: "Harden a production Linux VPS for your application across three layers — application (systemd hardening, monitoring alerts, backup automation), Ubuntu OS (UFW firewall, fail2ban SSH, unattended-upgrades, SSH hardening), and VPS provider (health checks, daily backups, monthly snapshots). Use when the user wants to secure a production server, harden a VPS, audit server security, or mentions production hardening, VPS security, or harden the server."
5
+ ---
6
+
7
+ # Harden VPS
8
+
9
+ Three-layer production hardening for a self-hosted app on any VPS. Each layer independently verifiable. Apply OS first (firewall blocks attacks immediately), then your application (alerts + backups), then your VPS provider (snapshots). See [REFERENCE.md](REFERENCE.md) for full script bodies, systemd unit template, and gotchas.
10
+
11
+ ## Quick start
12
+
13
+ SSH as root into the VPS. Find credentials in the your VPS provider Customer Control Panel.
14
+
15
+ > **HARD GATE** — Run `ufw status` first. No firewall = layer 1 takes priority over everything.
16
+
17
+ ## Layer 1 — Ubuntu OS
18
+
19
+ ```bash
20
+ # UFW
21
+ ufw default deny incoming && ufw default allow outgoing
22
+ ufw allow 22/tcp && ufw allow 80/tcp && ufw allow 443/tcp && ufw enable
23
+ # → verify: ufw status | grep -q active
24
+
25
+ # fail2ban
26
+ apt install -y fail2ban
27
+ # Configure /etc/fail2ban/jail.local: sshd, maxretry=3, bantime=3600, findtime=600
28
+ systemctl restart fail2ban
29
+ # → verify: fail2ban-client status sshd
30
+
31
+ # unattended-upgrades
32
+ apt install -y unattended-upgrades && dpkg-reconfigure -plow unattended-upgrades
33
+ # → verify: systemctl is-active unattended-upgrades | grep -q active
34
+
35
+ # SSH: PermitRootLogin no, PasswordAuthentication no, PubkeyAuthentication yes
36
+ # → verify: sshd -T | grep -E 'permitrootlogin no|passwordauthentication no'
37
+
38
+ # Deploy healthcheck.sh → /opt/your-app/scripts/healthcheck.sh
39
+ # Crontab: */5 * * * * /opt/your-app/scripts/healthcheck.sh
40
+ ```
41
+
42
+ ## Layer 2 — applicationlication
43
+
44
+ ```bash
45
+ # systemd: User=your-app, NoNewPrivileges=yes, ProtectSystem=full,
46
+ # ProtectKernelTunables=yes, ProtectKernelModules=yes,
47
+ # ProtectControlGroups=yes, RestrictAddressFamilies=AF_INET AF_INET6,
48
+ # RestrictRealtime=yes, PrivateTmp=yes, LimitNOFILE=65536
49
+ # → verify: systemctl show your-app -p NoNewPrivileges -p ProtectSystem -p User
50
+
51
+ # Alerts (your application requires auth; insert via SQLite)
52
+ sqlite3 /opt/your-app/data/your-app.db "
53
+ INSERT INTO monitoring_alerts (id,name,metric,threshold,operator,enabled,duration_seconds)
54
+ VALUES ('a1','Disk >80%','disk_used_percent',80,'gt',1,300);
55
+ INSERT INTO monitoring_alerts (id,name,metric,threshold,operator,enabled,duration_seconds)
56
+ VALUES ('a2','CPU >90%','cpu_percent',90,'gt',1,60);
57
+ INSERT INTO monitoring_alerts (id,name,metric,threshold,operator,enabled,duration_seconds)
58
+ VALUES ('a3','RAM >85%','mem_used_percent',85,'gt',1,120);
59
+ "
60
+ systemctl restart your-app
61
+
62
+ # Backup crontab (root):
63
+ # 0 2 * * * cp /opt/your-app/data/your-app.db /backup/your-app-$(date +\%Y\%m\%d).db
64
+ # 0 3 * * * find /backup/ -name "your-app-*.db" -mtime +90 -delete
65
+ ```
66
+
67
+ ## Layer 3 — VPS provider
68
+
69
+ ```bash
70
+ # cntb CLI
71
+ curl -sL "$(curl -sL https://api.github.com/repos/contabo/cntb/releases/latest \
72
+ | grep browser_download_url.*linux_amd64.tar.gz | head -1 | cut -d'"' -f4)" \
73
+ | tar xz -C /usr/local/bin
74
+
75
+ # Snapshot script → /opt/your-app/scripts/contabo-snapshot.sh (reads from /opt/your-app/.env)
76
+ # Credentials as env vars in /opt/your-app/.env (deployed by GitHub Actions):
77
+ # CONTABO_CLIENT_ID, CONTABO_CLIENT_SECRET, CONTABO_API_USER, CONTABO_API_PASSWORD
78
+ # Crontab: 0 4 1 * * /opt/your-app/scripts/contabo-snapshot.sh
79
+
80
+ # > HARD GATE — Snapshot cron silently fails until env vars are set in .env.
81
+ # Credentials source: your VPS provider Customer Panel → API Details.
82
+ # Local dev: add to .envrc. Production: GitHub Secrets → deploy → /opt/your-app/.env
83
+ ```
84
+
85
+ ## CRITICAL GOTCHAS
86
+
87
+ 1. **Shell escaping in Orca terminals:** `$VAR`, `$(…)`, and `%` get eaten by the local shell. Always use base64: `echo '<base64>' | base64 -d > script.sh`
88
+ 2. **Crontab `%`:** cron interprets `%` as newline. Escape as `\%` in `$(date +\%Y\%m\%d)`
89
+ 3. **fail2ban exit 255:** means a jail references a missing log file. Remove the broken jail, restart.
90
+ 4. **your application alerts need auth:** POST to `/api/monitoring/alerts` requires Bearer token. Workaround: insert directly into SQLite, then restart your application.
91
+
92
+ ## Verify all 8 gates
93
+
94
+ ```bash
95
+ ufw status|grep -q active||echo FAIL:ufw
96
+ fail2ban-client status sshd>/dev/null 2>&1||echo FAIL:fail2ban
97
+ systemctl is-active unattended-upgrades|grep -q active||echo FAIL:unattended
98
+ sshd -T|grep -q 'permitrootlogin no'||echo FAIL:sshd
99
+ systemctl show your-app -p NoNewPrivileges|grep -q yes||echo FAIL:systemd
100
+ systemctl is-active your-app|grep -q active||echo FAIL:your-app
101
+ sqlite3 /opt/your-app/data/your-app.db "SELECT count(*) FROM monitoring_alerts"|grep -q 3||echo FAIL:alerts
102
+ crontab -l|grep -q healthcheck&&crontab -l|grep -q your-app.db&&crontab -l|grep -q contabo-snapshot||echo FAIL:crontab
103
+ echo ALL 8 GATES PASSED
104
+ ```
105
+
106
+ → verify: # requires VPS SSH — run the 8-gate one-liner on the VPS manually
107
+
108
+ ---
109
+
110
+ # Harden VPS — Reference
111
+
112
+ ## Health check script
113
+
114
+ Deploy to `/opt/your-app/scripts/healthcheck.sh`:
115
+
116
+ ```bash
117
+ #!/bin/bash
118
+ LOG=/var/log/your-app/health.log
119
+ mkdir -p /var/log/your-app
120
+ DISK=$(df / | awk 'NR==2 {print $5}' | tr -d '%')
121
+ RAM=$(free | awk '/Mem:/ {printf "%.0f", $3/$2*100}')
122
+ NOW=$(date -Iseconds)
123
+ [ "$DISK" -gt 85 ] && echo "$NOW ALERT: Disk ${DISK}%" >> "$LOG"
124
+ [ "$RAM" -gt 90 ] && echo "$NOW ALERT: RAM ${RAM}%" >> "$LOG"
125
+ systemctl is-active --quiet your-app || { echo "$NOW ALERT: your application DOWN" >> "$LOG"; systemctl restart your-app; }
126
+ [ -f /var/run/reboot-required ] && echo "$NOW WARN: kernel reboot pending" >> "$LOG"
127
+ ```
128
+
129
+ Make executable: `chmod +x /opt/your-app/scripts/healthcheck.sh`
130
+
131
+ ## your application systemd unit
132
+
133
+ Full hardened unit at `/etc/systemd/system/your-app.service`:
134
+
135
+ ```ini
136
+ [Unit]
137
+ Description=your application BaaS Platform
138
+ Documentation=https://github.com/example-org/example-app
139
+ After=network.target caddy.service
140
+ Wants=caddy.service
141
+
142
+ [Service]
143
+ Type=simple
144
+ User=your-app
145
+ Group=your-app
146
+ WorkingDirectory=/opt/your-app
147
+ ExecStart=/opt/your-app/bin/your-app serve \
148
+ --port 8080 \
149
+ --db /opt/your-app/data/your-app.db \
150
+ --sites-domain <your-domain.example.com>
151
+ EnvironmentFile=-/opt/your-app/.env
152
+ Environment=APP_HOME=/opt/your-app
153
+ Environment=HOME=/opt/your-app
154
+ Environment=NPM_CONFIG_CACHE=/opt/your-app/.npm
155
+ Environment=PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
156
+ Restart=always
157
+ RestartSec=5
158
+ StartLimitIntervalSec=60
159
+ StartLimitBurst=3
160
+ TimeoutStopSec=30
161
+ KillSignal=SIGTERM
162
+ NoNewPrivileges=yes
163
+ PrivateTmp=yes
164
+ ProtectSystem=full
165
+ ProtectHome=yes
166
+ ProtectKernelTunables=yes
167
+ ProtectKernelModules=yes
168
+ ProtectControlGroups=yes
169
+ RestrictAddressFamilies=AF_INET AF_INET6
170
+ RestrictRealtime=yes
171
+ ReadWritePaths=/opt/your-app/data
172
+ ReadWritePaths=/opt/your-app/backups
173
+ ReadWritePaths=/opt/your-app/secrets
174
+ ReadWritePaths=/opt/your-app/.npm
175
+ ReadWritePaths=/opt/your-app/logs
176
+ LimitNOFILE=65536
177
+
178
+ [Install]
179
+ WantedBy=multi-user.target
180
+ ```
181
+
182
+ ## fail2ban jail.local
183
+
184
+ ```ini
185
+ [sshd]
186
+ enabled = true
187
+ port = ssh
188
+ filter = sshd
189
+ logpath = /var/log/auth.log
190
+ maxretry = 3
191
+ bantime = 3600
192
+ findtime = 600
193
+ ```
194
+
195
+ Note: your application auth jail deferred — your application logs to journald, not a file. To enable, use `backend = systemd` with a journald filter.
196
+
197
+ ## provider-snapshot.sh — worked example (Contabo API)
198
+
199
+ > Snapshot APIs are provider-specific. This is one worked example, not a
200
+ > bigpowers default; swap the auth and endpoint calls for your own provider.
201
+
202
+ Deploy to `/opt/your-app/scripts/contabo-snapshot.sh`. Reads credentials from `/opt/your-app/.env` (same file used by your application systemd unit):
203
+
204
+ ```bash
205
+ #!/bin/bash
206
+ set -e
207
+ LOG=/var/log/your-app/snapshot.log
208
+ ENVFILE=/opt/your-app/.env
209
+ INSTANCE_ID=<your-contabo-instance-id>
210
+
211
+ [ -f "$ENVFILE" ] || { echo "$(date -Iseconds) ERROR: $ENVFILE missing" >> "$LOG"; exit 1; }
212
+ set -a; source "$ENVFILE"; set +a
213
+
214
+ [ -z "$CONTABO_CLIENT_ID" ] && { echo "$(date -Iseconds) ERROR: CONTABO_CLIENT_ID not set" >> "$LOG"; exit 1; }
215
+
216
+ TOKEN=$(curl -s -d "client_id=$CONTABO_CLIENT_ID" \
217
+ -d "client_secret=$CONTABO_CLIENT_SECRET" \
218
+ --data-urlencode "username=$CONTABO_API_USER" \
219
+ --data-urlencode "password=$CONTABO_API_PASSWORD" \
220
+ -d 'grant_type=password' \
221
+ 'https://auth.contabo.com/auth/realms/contabo/protocol/openid-connect/token' \
222
+ | jq -r '.access_token')
223
+
224
+ [ -z "$TOKEN" ] || [ "$TOKEN" = "null" ] && { echo "$(date -Iseconds) ERROR: auth failed" >> "$LOG"; exit 1; }
225
+
226
+ curl -s -X POST \
227
+ -H "Authorization: Bearer $TOKEN" \
228
+ -H "Content-Type: application/json" \
229
+ -H "x-request-id: $(uuidgen 2>/dev/null || echo $RANDOM)" \
230
+ "https://api.contabo.com/v1/compute/instances/${INSTANCE_ID}/snapshots" \
231
+ | tee -a "$LOG"
232
+
233
+ echo >> "$LOG"
234
+ echo "$(date -Iseconds) Snapshot requested for $INSTANCE_ID" >> "$LOG"
235
+ ```
236
+
237
+ ## your VPS provider credentials
238
+
239
+ Add to `/opt/your-app/.env` (same file used by your application systemd unit, deployed by GitHub Actions):
240
+
241
+ ```
242
+ CONTABO_CLIENT_ID=
243
+ CONTABO_CLIENT_SECRET=
244
+ CONTABO_API_USER=
245
+ CONTABO_API_PASSWORD=
246
+ ```
247
+
248
+ Source: your VPS provider Customer Control Panel → API Details. ClientId and ClientSecret are generated there. API User is your email. API Password is set separately in the panel.
249
+
250
+ **Pipeline:** GitHub Secrets → deploy workflow → `/opt/your-app/.env` on VPS. For local dev (`cntb get instances`), add to `.envrc`.
251
+
252
+ ## your VPS provider instance info template
253
+
254
+ Fill in your instance details from the your VPS provider Customer Control Panel:
255
+
256
+ ```
257
+ IP: <your-instance-ip>
258
+ IPv6: <your-instance-ipv6>
259
+ Region: <your-region>
260
+ OS: <your-os-version>
261
+ Disk: <your-disk-size>
262
+ Default user: root
263
+ Customer ID: <your-customer-id>
264
+ ```
265
+
266
+ ## your application monitoring alert SQL
267
+
268
+ ```sql
269
+ INSERT INTO monitoring_alerts (id, name, metric, threshold, operator, enabled, duration_seconds)
270
+ VALUES ('alert-001', 'VPS Disk above 80%', 'disk_used_percent', 80, 'gt', 1, 300);
271
+
272
+ INSERT INTO monitoring_alerts (id, name, metric, threshold, operator, enabled, duration_seconds)
273
+ VALUES ('alert-002', 'VPS CPU above 90%', 'cpu_percent', 90, 'gt', 1, 60);
274
+
275
+ INSERT INTO monitoring_alerts (id, name, metric, threshold, operator, enabled, duration_seconds)
276
+ VALUES ('alert-003', 'VPS RAM above 85%', 'mem_used_percent', 85, 'gt', 1, 120);
277
+ ```
278
+
279
+ Alerts are loaded at your application startup. Restart with `systemctl restart your-app` after inserting.
280
+
281
+ ## Base64 encoding workaround
282
+
283
+ When sending scripts through Orca terminal `--text`, the local bash shell interprets `$`, `(`, and `%`. Encode locally and decode remotely:
284
+
285
+ ```bash
286
+ # Local
287
+ cat script.sh | base64
288
+
289
+ # Remote terminal
290
+ echo '<base64-output>' | base64 -d > script.sh
291
+ ```
@@ -0,0 +1,94 @@
1
+ ---
2
+ name: hook-commits
3
+ model: haiku
4
+ description: "Set up pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing."
5
+ ---
6
+
7
+ # Hook Commits
8
+ > **HARD GATE** — **HARD GATE** — Pre-commit and commit-msg hooks must run before any commit lands. Skipping hooks (`--no-verify`) is forbidden unless explicitly authorized for a specific commit and documented.
9
+
10
+
11
+ ## What This Sets Up
12
+
13
+ - **Husky** pre-commit hook
14
+ - **lint-staged** running Prettier on all staged files
15
+ - **Prettier** config (if missing)
16
+ - **typecheck** and **test** scripts in the pre-commit hook
17
+
18
+ ## Steps
19
+
20
+ ### 1. Detect package manager
21
+
22
+ Check for `package-lock.json` (npm), `pnpm-lock.yaml` (pnpm), `yarn.lock` (yarn), `bun.lockb` (bun). Use whichever is present. Default to npm if unclear.
23
+
24
+ ### 2. Install dependencies
25
+
26
+ Install as devDependencies:
27
+
28
+ ```
29
+ husky lint-staged prettier
30
+ ```
31
+
32
+ ### 3. Initialize Husky
33
+
34
+ ```bash
35
+ npx husky init
36
+ ```
37
+
38
+ This creates `.husky/` dir and adds `prepare: "husky"` to package.json.
39
+
40
+ ### 4. Create `.husky/pre-commit`
41
+
42
+ Write this file (no shebang needed for Husky v9+):
43
+
44
+ ```
45
+ npx lint-staged
46
+ npm run typecheck
47
+ npm run test
48
+ ```
49
+
50
+ **Adapt**: Replace `npm` with detected package manager. If repo has no `typecheck` or `test` script in package.json, omit those lines and tell the user.
51
+
52
+ ### 5. Create `.lintstagedrc`
53
+
54
+ ```json
55
+ {
56
+ "*": "prettier --ignore-unknown --write"
57
+ }
58
+ ```
59
+
60
+ ### 6. Create `.prettierrc` (if missing)
61
+
62
+ Only create if no Prettier config exists. Use these defaults:
63
+
64
+ ```json
65
+ {
66
+ "useTabs": false,
67
+ "tabWidth": 2,
68
+ "printWidth": 80,
69
+ "singleQuote": false,
70
+ "trailingComma": "es5",
71
+ "semi": true,
72
+ "arrowParens": "always"
73
+ }
74
+ ```
75
+
76
+ ### 7. Verify
77
+
78
+ - [ ] `.husky/pre-commit` exists and is executable
79
+ - [ ] `.lintstagedrc` exists
80
+ - [ ] `prepare` script in package.json is `"husky"`
81
+ - [ ] `prettier` config exists
82
+ - [ ] Run `npx lint-staged` to verify it works
83
+
84
+ ### 8. Commit
85
+
86
+ Stage all changed/created files and commit with message: `chore: add pre-commit hooks (husky + lint-staged + prettier)`
87
+
88
+ This will run through the new pre-commit hooks — a good smoke test that everything works.
89
+
90
+ ## Notes
91
+
92
+ - Husky v9+ doesn't need shebangs in hook files
93
+ - `prettier --ignore-unknown` skips files Prettier can't parse (images, etc.)
94
+ - The pre-commit runs lint-staged first (fast, staged-only), then full typecheck and tests