codeply-cli 0.5.1 → 0.5.2

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 (387) hide show
  1. package/LICENSE +21 -0
  2. package/THIRD_PARTY_NOTICES.md +65 -63
  3. package/bin/codeply.js +1 -1
  4. package/lib/agent.mjs +133 -24
  5. package/lib/ai.js +268 -9
  6. package/lib/ai.mjs +6 -6
  7. package/lib/apply-patch.js +217 -217
  8. package/lib/arity-table.json +138 -138
  9. package/lib/arity.js +70 -70
  10. package/lib/auth.mjs +6 -6
  11. package/lib/bots.js +82 -17
  12. package/lib/chatgpt.js +282 -0
  13. package/lib/cloud-browser.mjs +143 -143
  14. package/lib/cloud.mjs +1186 -1144
  15. package/lib/commands.js +103 -103
  16. package/lib/config.js +83 -3
  17. package/lib/design-library/assemble-artifact.mjs +21 -21
  18. package/lib/design-library/cleanup.mjs +45 -45
  19. package/lib/design-library/index.json +22379 -22379
  20. package/lib/design-library/make-table-data.mjs +39 -39
  21. package/lib/diagnostics.js +192 -192
  22. package/lib/edit-engine.js +364 -364
  23. package/lib/github-agent.mjs +311 -311
  24. package/lib/history.js +75 -75
  25. package/lib/mail-watch.js +504 -0
  26. package/lib/mcp.js +258 -258
  27. package/lib/model-sync.js +114 -0
  28. package/lib/native-tools.mjs +16 -1
  29. package/lib/oauth-connectors.js +146 -24
  30. package/lib/permissions.js +109 -109
  31. package/lib/plugins.js +353 -353
  32. package/lib/publish.js +916 -0
  33. package/lib/reach.js +67 -0
  34. package/lib/server.mjs +457 -457
  35. package/lib/session-db.js +220 -220
  36. package/lib/share.js +168 -168
  37. package/lib/skills.js +2 -0
  38. package/lib/snapshot.js +146 -146
  39. package/lib/telemetry.js +102 -0
  40. package/lib/terminal-hints.js +154 -154
  41. package/lib/tools.mjs +316 -14
  42. package/lib/typecheck-worker.js +147 -147
  43. package/lib/web-tools.js +209 -158
  44. package/package.json +49 -49
  45. package/skills/SOURCE.md +58 -58
  46. package/skills/accessibility/SKILL.md +147 -147
  47. package/skills/agent-architecture-audit/SKILL.md +257 -257
  48. package/skills/agent-eval/SKILL.md +147 -147
  49. package/skills/agent-harness-construction/SKILL.md +74 -74
  50. package/skills/agent-introspection-debugging/SKILL.md +154 -154
  51. package/skills/agent-payment-x402/SKILL.md +225 -225
  52. package/skills/agent-self-evaluation/SKILL.md +182 -182
  53. package/skills/agent-self-evaluation/references/evaluation-criteria.md +71 -71
  54. package/skills/agent-self-evaluation/references/hook-integration.md +64 -64
  55. package/skills/agent-sort/SKILL.md +216 -216
  56. package/skills/agentic-engineering/SKILL.md +64 -64
  57. package/skills/agentic-os/SKILL.md +388 -388
  58. package/skills/ai-first-engineering/SKILL.md +52 -52
  59. package/skills/ai-regression-testing/SKILL.md +386 -386
  60. package/skills/android-clean-architecture/SKILL.md +340 -340
  61. package/skills/angular-developer/SKILL.md +155 -155
  62. package/skills/angular-developer/references/angular-animations.md +160 -160
  63. package/skills/angular-developer/references/angular-aria.md +410 -410
  64. package/skills/angular-developer/references/cli.md +86 -86
  65. package/skills/angular-developer/references/component-harnesses.md +59 -59
  66. package/skills/angular-developer/references/component-styling.md +91 -91
  67. package/skills/angular-developer/references/components.md +117 -117
  68. package/skills/angular-developer/references/creating-services.md +97 -97
  69. package/skills/angular-developer/references/data-resolvers.md +69 -69
  70. package/skills/angular-developer/references/define-routes.md +67 -67
  71. package/skills/angular-developer/references/defining-providers.md +72 -72
  72. package/skills/angular-developer/references/di-fundamentals.md +120 -120
  73. package/skills/angular-developer/references/e2e-testing.md +56 -56
  74. package/skills/angular-developer/references/effects.md +83 -83
  75. package/skills/angular-developer/references/hierarchical-injectors.md +43 -43
  76. package/skills/angular-developer/references/host-elements.md +80 -80
  77. package/skills/angular-developer/references/injection-context.md +63 -63
  78. package/skills/angular-developer/references/inputs.md +101 -101
  79. package/skills/angular-developer/references/linked-signal.md +59 -59
  80. package/skills/angular-developer/references/loading-strategies.md +61 -61
  81. package/skills/angular-developer/references/mcp.md +108 -108
  82. package/skills/angular-developer/references/navigate-to-routes.md +69 -69
  83. package/skills/angular-developer/references/outputs.md +86 -86
  84. package/skills/angular-developer/references/reactive-forms.md +122 -122
  85. package/skills/angular-developer/references/rendering-strategies.md +44 -44
  86. package/skills/angular-developer/references/resource.md +77 -77
  87. package/skills/angular-developer/references/route-animations.md +56 -56
  88. package/skills/angular-developer/references/route-guards.md +52 -52
  89. package/skills/angular-developer/references/router-lifecycle.md +45 -45
  90. package/skills/angular-developer/references/router-testing.md +87 -87
  91. package/skills/angular-developer/references/show-routes-with-outlets.md +68 -68
  92. package/skills/angular-developer/references/signal-forms.md +795 -795
  93. package/skills/angular-developer/references/signals-overview.md +94 -94
  94. package/skills/angular-developer/references/tailwind-css.md +69 -69
  95. package/skills/angular-developer/references/template-driven-forms.md +114 -114
  96. package/skills/angular-developer/references/testing-fundamentals.md +65 -65
  97. package/skills/api-connector-builder/SKILL.md +121 -121
  98. package/skills/api-design/SKILL.md +524 -524
  99. package/skills/architecture-decision-records/SKILL.md +180 -180
  100. package/skills/article-writing/SKILL.md +80 -80
  101. package/skills/automation-audit-ops/SKILL.md +143 -143
  102. package/skills/autonomous-agent-harness/SKILL.md +274 -274
  103. package/skills/autonomous-loops/SKILL.md +611 -611
  104. package/skills/backend-patterns/SKILL.md +562 -562
  105. package/skills/benchmark/SKILL.md +95 -95
  106. package/skills/benchmark-methodology/SKILL.md +191 -191
  107. package/skills/benchmark-optimization-loop/SKILL.md +71 -71
  108. package/skills/blender-motion-state-inspection/SKILL.md +165 -165
  109. package/skills/blueprint/SKILL.md +106 -106
  110. package/skills/brand-discovery/SKILL.md +145 -145
  111. package/skills/brand-discovery/references/10_purpose-why.md +40 -40
  112. package/skills/brand-discovery/references/20_positioning.md +44 -44
  113. package/skills/brand-discovery/references/30_audience-niche.md +52 -52
  114. package/skills/brand-discovery/references/40_personality-archetype.md +57 -57
  115. package/skills/brand-discovery/references/50_voice-tone.md +59 -59
  116. package/skills/brand-discovery/references/60_narrative-story.md +50 -50
  117. package/skills/brand-discovery/references/70_founder-tension.md +49 -49
  118. package/skills/brand-discovery/references/90_SYNTHESIS.md +133 -133
  119. package/skills/brand-voice/SKILL.md +98 -98
  120. package/skills/brand-voice/references/voice-profile-schema.md +55 -55
  121. package/skills/browser-qa/SKILL.md +105 -105
  122. package/skills/bun-runtime/SKILL.md +85 -85
  123. package/skills/canary-watch/SKILL.md +108 -108
  124. package/skills/carrier-relationship-management/SKILL.md +212 -212
  125. package/skills/cisco-ios-patterns/SKILL.md +164 -164
  126. package/skills/ck/SKILL.md +148 -148
  127. package/skills/claude-devfleet/SKILL.md +112 -112
  128. package/skills/click-path-audit/SKILL.md +245 -245
  129. package/skills/clickhouse-io/SKILL.md +445 -445
  130. package/skills/code-tour/SKILL.md +254 -254
  131. package/skills/codebase-onboarding/SKILL.md +234 -234
  132. package/skills/codehealth-mcp/SKILL.md +167 -167
  133. package/skills/coding-standards/SKILL.md +551 -551
  134. package/skills/competitive-platform-analysis/SKILL.md +214 -214
  135. package/skills/competitive-report-structure/SKILL.md +162 -162
  136. package/skills/compose-multiplatform-patterns/SKILL.md +300 -300
  137. package/skills/config-gc/SKILL.md +120 -120
  138. package/skills/configure-ecc/SKILL.md +385 -385
  139. package/skills/connections-optimizer/SKILL.md +190 -190
  140. package/skills/content-engine/SKILL.md +132 -132
  141. package/skills/content-hash-cache-pattern/SKILL.md +162 -162
  142. package/skills/context-budget/SKILL.md +136 -136
  143. package/skills/continuous-agent-loop/SKILL.md +46 -46
  144. package/skills/continuous-learning/SKILL.md +132 -132
  145. package/skills/continuous-learning-v2/SKILL.md +361 -361
  146. package/skills/contract-first/SKILL.md +287 -287
  147. package/skills/cost-aware-llm-pipeline/SKILL.md +184 -184
  148. package/skills/cost-tracking/SKILL.md +97 -97
  149. package/skills/council/SKILL.md +204 -204
  150. package/skills/cpp-coding-standards/SKILL.md +724 -724
  151. package/skills/cpp-testing/SKILL.md +325 -325
  152. package/skills/crosspost/SKILL.md +112 -112
  153. package/skills/csharp-testing/SKILL.md +322 -322
  154. package/skills/customer-billing-ops/SKILL.md +141 -141
  155. package/skills/customs-trade-compliance/SKILL.md +263 -263
  156. package/skills/dart-flutter-patterns/SKILL.md +564 -564
  157. package/skills/dashboard-builder/SKILL.md +109 -109
  158. package/skills/data-scraper-agent/SKILL.md +765 -765
  159. package/skills/data-throughput-accelerator/SKILL.md +74 -74
  160. package/skills/database-migrations/SKILL.md +430 -430
  161. package/skills/deep-research/SKILL.md +160 -160
  162. package/skills/defi-amm-security/SKILL.md +167 -167
  163. package/skills/delivery-gate/SKILL.md +126 -126
  164. package/skills/deployment-patterns/SKILL.md +428 -428
  165. package/skills/design-system/SKILL.md +83 -83
  166. package/skills/django-celery/SKILL.md +458 -458
  167. package/skills/django-patterns/SKILL.md +735 -735
  168. package/skills/django-security/SKILL.md +644 -644
  169. package/skills/django-tdd/SKILL.md +730 -730
  170. package/skills/django-verification/SKILL.md +470 -470
  171. package/skills/dmux-workflows/SKILL.md +192 -192
  172. package/skills/docker-patterns/SKILL.md +365 -365
  173. package/skills/documentation-lookup/SKILL.md +91 -91
  174. package/skills/dotnet-patterns/SKILL.md +322 -322
  175. package/skills/dynamic-workflow-mode/SKILL.md +124 -124
  176. package/skills/e2e-testing/SKILL.md +327 -327
  177. package/skills/ecc-guide/SKILL.md +190 -190
  178. package/skills/ecc-recipes/SKILL.md +149 -149
  179. package/skills/ecc-tools-cost-audit/SKILL.md +161 -161
  180. package/skills/email-ops/SKILL.md +122 -122
  181. package/skills/energy-procurement/SKILL.md +228 -228
  182. package/skills/enterprise-agent-ops/SKILL.md +51 -51
  183. package/skills/error-handling/SKILL.md +377 -377
  184. package/skills/eval-harness/SKILL.md +271 -271
  185. package/skills/evm-token-decimals/SKILL.md +131 -131
  186. package/skills/exa-search/SKILL.md +108 -108
  187. package/skills/fal-ai-media/SKILL.md +289 -289
  188. package/skills/fastapi-patterns/SKILL.md +514 -514
  189. package/skills/finance-billing-ops/SKILL.md +128 -128
  190. package/skills/flox-environments/SKILL.md +497 -497
  191. package/skills/flutter-dart-code-review/SKILL.md +436 -436
  192. package/skills/foundation-models-on-device/SKILL.md +243 -243
  193. package/skills/frontend-a11y/SKILL.md +446 -446
  194. package/skills/frontend-design-direction/SKILL.md +93 -93
  195. package/skills/frontend-patterns/SKILL.md +657 -657
  196. package/skills/frontend-slides/SKILL.md +185 -185
  197. package/skills/fsharp-testing/SKILL.md +281 -281
  198. package/skills/gan-style-harness/SKILL.md +279 -279
  199. package/skills/gateguard/SKILL.md +133 -133
  200. package/skills/generating-python-installer/SKILL.md +820 -820
  201. package/skills/git-workflow/SKILL.md +716 -716
  202. package/skills/github-ops/SKILL.md +145 -145
  203. package/skills/golang-patterns/SKILL.md +676 -676
  204. package/skills/golang-testing/SKILL.md +721 -721
  205. package/skills/google-workspace-ops/SKILL.md +96 -96
  206. package/skills/growth-log/SKILL.md +128 -128
  207. package/skills/healthcare-cdss-patterns/SKILL.md +246 -246
  208. package/skills/healthcare-emr-patterns/SKILL.md +160 -160
  209. package/skills/healthcare-eval-harness/SKILL.md +208 -208
  210. package/skills/healthcare-phi-compliance/SKILL.md +146 -146
  211. package/skills/hermes-imports/SKILL.md +89 -89
  212. package/skills/hexagonal-architecture/SKILL.md +277 -277
  213. package/skills/hipaa-compliance/SKILL.md +79 -79
  214. package/skills/homelab-network-readiness/SKILL.md +170 -170
  215. package/skills/homelab-network-setup/SKILL.md +130 -130
  216. package/skills/homelab-pihole-dns/SKILL.md +275 -275
  217. package/skills/homelab-vlan-segmentation/SKILL.md +312 -312
  218. package/skills/homelab-wireguard-vpn/SKILL.md +306 -306
  219. package/skills/hookify-rules/SKILL.md +128 -128
  220. package/skills/inherit-legacy-style/SKILL.md +157 -157
  221. package/skills/intent-driven-development/SKILL.md +360 -360
  222. package/skills/inventory-demand-planning/SKILL.md +247 -247
  223. package/skills/investor-materials/SKILL.md +97 -97
  224. package/skills/investor-outreach/SKILL.md +92 -92
  225. package/skills/ios-icon-gen/SKILL.md +158 -158
  226. package/skills/iterative-retrieval/SKILL.md +212 -212
  227. package/skills/ito-basket-compare/SKILL.md +64 -64
  228. package/skills/ito-compute/SKILL.md +129 -129
  229. package/skills/ito-data-atlas-agent/SKILL.md +64 -64
  230. package/skills/ito-market-intelligence/SKILL.md +61 -61
  231. package/skills/ito-trade-planner/SKILL.md +68 -68
  232. package/skills/java-coding-standards/SKILL.md +384 -384
  233. package/skills/jira-integration/SKILL.md +303 -303
  234. package/skills/jpa-patterns/SKILL.md +152 -152
  235. package/skills/knowledge-ops/SKILL.md +155 -155
  236. package/skills/kotlin-coroutines-flows/SKILL.md +285 -285
  237. package/skills/kotlin-exposed-patterns/SKILL.md +720 -720
  238. package/skills/kotlin-ktor-patterns/SKILL.md +690 -690
  239. package/skills/kotlin-patterns/SKILL.md +712 -712
  240. package/skills/kotlin-testing/SKILL.md +825 -825
  241. package/skills/kubernetes-patterns/SKILL.md +756 -756
  242. package/skills/laravel-patterns/SKILL.md +416 -416
  243. package/skills/laravel-plugin-discovery/SKILL.md +230 -230
  244. package/skills/laravel-security/SKILL.md +948 -948
  245. package/skills/laravel-tdd/SKILL.md +675 -675
  246. package/skills/laravel-verification/SKILL.md +180 -180
  247. package/skills/latency-critical-systems/SKILL.md +75 -75
  248. package/skills/lead-intelligence/SKILL.md +322 -322
  249. package/skills/liquid-glass-design/SKILL.md +279 -279
  250. package/skills/llm-trading-agent-security/SKILL.md +147 -147
  251. package/skills/logistics-exception-management/SKILL.md +222 -222
  252. package/skills/loop-design-check/SKILL.md +143 -143
  253. package/skills/mailtrap-email-integration/SKILL.md +77 -77
  254. package/skills/make-interfaces-feel-better/SKILL.md +152 -152
  255. package/skills/manim-video/SKILL.md +90 -90
  256. package/skills/market-research/SKILL.md +76 -76
  257. package/skills/marketing-campaign/SKILL.md +114 -114
  258. package/skills/mcp-server-patterns/SKILL.md +70 -70
  259. package/skills/messages-ops/SKILL.md +105 -105
  260. package/skills/ml-adoption-playbook/SKILL.md +57 -57
  261. package/skills/mle-workflow/SKILL.md +348 -348
  262. package/skills/motion-advanced/SKILL.md +596 -596
  263. package/skills/motion-foundations/SKILL.md +299 -299
  264. package/skills/motion-patterns/SKILL.md +434 -434
  265. package/skills/motion-ui/SKILL.md +576 -576
  266. package/skills/mysql-patterns/SKILL.md +413 -413
  267. package/skills/nanoclaw-repl/SKILL.md +34 -34
  268. package/skills/nestjs-patterns/SKILL.md +231 -231
  269. package/skills/netmiko-ssh-automation/SKILL.md +174 -174
  270. package/skills/network-bgp-diagnostics/SKILL.md +168 -168
  271. package/skills/network-config-validation/SKILL.md +211 -211
  272. package/skills/network-interface-health/SKILL.md +153 -153
  273. package/skills/nextjs-turbopack/SKILL.md +58 -58
  274. package/skills/nodejs-keccak256/SKILL.md +103 -103
  275. package/skills/nutrient-document-processing/SKILL.md +168 -168
  276. package/skills/nuxt4-patterns/SKILL.md +101 -101
  277. package/skills/openclaw-persona-forge/SKILL.md +289 -289
  278. package/skills/openclaw-persona-forge/references/avatar-style.md +124 -124
  279. package/skills/openclaw-persona-forge/references/boundary-rules.md +53 -53
  280. package/skills/openclaw-persona-forge/references/error-handling.md +53 -53
  281. package/skills/openclaw-persona-forge/references/identity-tension.md +48 -48
  282. package/skills/openclaw-persona-forge/references/naming-system.md +39 -39
  283. package/skills/openclaw-persona-forge/references/output-template.md +166 -166
  284. package/skills/opensource-pipeline/SKILL.md +256 -256
  285. package/skills/orch-add-feature/SKILL.md +45 -45
  286. package/skills/orch-build-mvp/SKILL.md +49 -49
  287. package/skills/orch-change-feature/SKILL.md +43 -43
  288. package/skills/orch-fix-defect/SKILL.md +43 -43
  289. package/skills/orch-pipeline/SKILL.md +121 -121
  290. package/skills/orch-refine-code/SKILL.md +44 -44
  291. package/skills/parallel-execution-optimizer/SKILL.md +74 -74
  292. package/skills/perl-patterns/SKILL.md +505 -505
  293. package/skills/perl-security/SKILL.md +504 -504
  294. package/skills/perl-testing/SKILL.md +476 -476
  295. package/skills/plan-canvas/SKILL.md +153 -153
  296. package/skills/plan-orchestrate/SKILL.md +263 -263
  297. package/skills/plankton-code-quality/SKILL.md +237 -237
  298. package/skills/postgres-patterns/SKILL.md +148 -148
  299. package/skills/prediction-market-oracle-research/SKILL.md +64 -64
  300. package/skills/prediction-market-risk-review/SKILL.md +61 -61
  301. package/skills/premium-web-design/SKILL.md +154 -154
  302. package/skills/prisma-patterns/SKILL.md +401 -401
  303. package/skills/product-capability/SKILL.md +142 -142
  304. package/skills/product-lens/SKILL.md +93 -93
  305. package/skills/production-audit/SKILL.md +207 -207
  306. package/skills/production-scheduling/SKILL.md +238 -238
  307. package/skills/project-flow-ops/SKILL.md +112 -112
  308. package/skills/prompt-optimizer/SKILL.md +398 -398
  309. package/skills/publish-website/SKILL.md +76 -0
  310. package/skills/python-patterns/SKILL.md +751 -751
  311. package/skills/python-testing/SKILL.md +817 -817
  312. package/skills/pytorch-patterns/SKILL.md +397 -397
  313. package/skills/quality-nonconformance/SKILL.md +260 -260
  314. package/skills/quarkus-patterns/SKILL.md +723 -723
  315. package/skills/quarkus-security/SKILL.md +468 -468
  316. package/skills/quarkus-tdd/SKILL.md +812 -812
  317. package/skills/quarkus-verification/SKILL.md +480 -480
  318. package/skills/ralphinho-rfc-pipeline/SKILL.md +68 -68
  319. package/skills/react-native-patterns/SKILL.md +326 -326
  320. package/skills/react-patterns/SKILL.md +342 -342
  321. package/skills/react-performance/SKILL.md +575 -575
  322. package/skills/react-testing/SKILL.md +424 -424
  323. package/skills/recsys-pipeline-architect/SKILL.md +115 -115
  324. package/skills/recursive-decision-ledger/SKILL.md +81 -81
  325. package/skills/redis-patterns/SKILL.md +404 -404
  326. package/skills/regex-vs-llm-structured-text/SKILL.md +221 -221
  327. package/skills/remotion-video-creation/SKILL.md +43 -43
  328. package/skills/repo-scan/SKILL.md +79 -79
  329. package/skills/research-ops/SKILL.md +113 -113
  330. package/skills/returns-reverse-logistics/SKILL.md +240 -240
  331. package/skills/rules-distill/SKILL.md +265 -265
  332. package/skills/rust-patterns/SKILL.md +500 -500
  333. package/skills/rust-testing/SKILL.md +501 -501
  334. package/skills/safety-guard/SKILL.md +76 -76
  335. package/skills/santa-method/SKILL.md +307 -307
  336. package/skills/scientific-db-pubmed-database/SKILL.md +176 -176
  337. package/skills/scientific-db-uspto-database/SKILL.md +178 -178
  338. package/skills/scientific-pkg-gget/SKILL.md +167 -167
  339. package/skills/scientific-thinking-literature-review/SKILL.md +193 -193
  340. package/skills/scientific-thinking-scholar-evaluation/SKILL.md +161 -161
  341. package/skills/search-first/SKILL.md +183 -183
  342. package/skills/security-bounty-hunter/SKILL.md +100 -100
  343. package/skills/security-review/SKILL.md +504 -504
  344. package/skills/security-scan/SKILL.md +166 -166
  345. package/skills/seo/SKILL.md +155 -155
  346. package/skills/skill-comply/SKILL.md +59 -59
  347. package/skills/skill-scout/SKILL.md +141 -141
  348. package/skills/skill-stocktake/SKILL.md +195 -195
  349. package/skills/social-graph-ranker/SKILL.md +155 -155
  350. package/skills/social-publisher/SKILL.md +130 -130
  351. package/skills/springboot-patterns/SKILL.md +315 -315
  352. package/skills/springboot-security/SKILL.md +273 -273
  353. package/skills/springboot-tdd/SKILL.md +159 -159
  354. package/skills/springboot-verification/SKILL.md +232 -232
  355. package/skills/strategic-compact/SKILL.md +142 -142
  356. package/skills/swift-actor-persistence/SKILL.md +144 -144
  357. package/skills/swift-concurrency-6-2/SKILL.md +216 -216
  358. package/skills/swift-protocol-di-testing/SKILL.md +191 -191
  359. package/skills/swiftui-patterns/SKILL.md +259 -259
  360. package/skills/taste/SKILL.md +264 -264
  361. package/skills/taste/references/genre-taxonomy.md +87 -87
  362. package/skills/tdd-workflow/SKILL.md +583 -583
  363. package/skills/team-agent-orchestration/SKILL.md +111 -111
  364. package/skills/team-builder/SKILL.md +169 -169
  365. package/skills/terminal-ops/SKILL.md +110 -110
  366. package/skills/tinystruct-patterns/SKILL.md +279 -279
  367. package/skills/tinystruct-patterns/references/architecture.md +90 -90
  368. package/skills/tinystruct-patterns/references/data-handling.md +60 -60
  369. package/skills/tinystruct-patterns/references/database.md +99 -99
  370. package/skills/tinystruct-patterns/references/routing.md +64 -64
  371. package/skills/tinystruct-patterns/references/system-usage.md +97 -97
  372. package/skills/tinystruct-patterns/references/testing.md +72 -72
  373. package/skills/token-budget-advisor/SKILL.md +134 -134
  374. package/skills/ui-demo/SKILL.md +466 -466
  375. package/skills/ui-to-vue/SKILL.md +135 -135
  376. package/skills/uncloud/SKILL.md +344 -344
  377. package/skills/unified-memory/SKILL.md +170 -170
  378. package/skills/unified-notifications-ops/SKILL.md +188 -188
  379. package/skills/verification-loop/SKILL.md +129 -129
  380. package/skills/video-editing/SKILL.md +311 -311
  381. package/skills/videodb/SKILL.md +375 -375
  382. package/skills/visa-doc-translate/SKILL.md +117 -117
  383. package/skills/vite-patterns/SKILL.md +450 -450
  384. package/skills/vue-patterns/SKILL.md +471 -471
  385. package/skills/windows-desktop-e2e/SKILL.md +888 -888
  386. package/skills/workspace-surface-audit/SKILL.md +126 -126
  387. package/skills/x-api/SKILL.md +235 -235
@@ -1,128 +1,128 @@
1
- ---
2
- name: hookify-rules
3
- description: This skill should be used when the user asks to create a hookify rule, write a hook rule, configure hookify, add a hookify rule, or needs guidance on hookify rule syntax and patterns.
4
- ---
5
-
6
- # Writing Hookify Rules
7
-
8
- ## Overview
9
-
10
- Hookify rules are markdown files with YAML frontmatter that define patterns to watch for and messages to show when those patterns match. Rules are stored in `.claude/hookify.{rule-name}.local.md` files.
11
-
12
- ## Rule File Format
13
-
14
- ### Basic Structure
15
-
16
- ```markdown
17
- ---
18
- name: rule-identifier
19
- enabled: true
20
- event: bash|file|stop|prompt|all
21
- pattern: regex-pattern-here
22
- ---
23
-
24
- Message to show Claude when this rule triggers.
25
- Can include markdown formatting, warnings, suggestions, etc.
26
- ```
27
-
28
- ### Frontmatter Fields
29
-
30
- | Field | Required | Values | Description |
31
- |-------|----------|--------|-------------|
32
- | name | Yes | kebab-case string | Unique identifier (verb-first: warn-*, block-*, require-*) |
33
- | enabled | Yes | true/false | Toggle without deleting |
34
- | event | Yes | bash/file/stop/prompt/all | Which hook event triggers this |
35
- | action | No | warn/block | warn (default) shows message; block prevents operation |
36
- | pattern | Yes* | regex string | Pattern to match (*or use conditions for complex rules) |
37
-
38
- ### Advanced Format (Multiple Conditions)
39
-
40
- ```markdown
41
- ---
42
- name: warn-env-api-keys
43
- enabled: true
44
- event: file
45
- conditions:
46
- - field: file_path
47
- operator: regex_match
48
- pattern: \.env$
49
- - field: new_text
50
- operator: contains
51
- pattern: API_KEY
52
- ---
53
-
54
- You're adding an API key to a .env file. Ensure this file is in .gitignore!
55
- ```
56
-
57
- **Condition fields by event:**
58
- - bash: `command`
59
- - file: `file_path`, `new_text`, `old_text`, `content`
60
- - prompt: `user_prompt`
61
-
62
- **Operators:** `regex_match`, `contains`, `equals`, `not_contains`, `starts_with`, `ends_with`
63
-
64
- All conditions must match for rule to trigger.
65
-
66
- ## Event Type Guide
67
-
68
- ### bash Events
69
- Match Bash command patterns:
70
- - Dangerous commands: `rm\s+-rf`, `dd\s+if=`, `mkfs`
71
- - Privilege escalation: `sudo\s+`, `su\s+`
72
- - Permission issues: `chmod\s+777`
73
-
74
- ### file Events
75
- Match Edit/Write/MultiEdit operations:
76
- - Debug code: `console\.log\(`, `debugger`
77
- - Security risks: `eval\(`, `innerHTML\s*=`
78
- - Sensitive files: `\.env$`, `credentials`, `\.pem$`
79
-
80
- ### stop Events
81
- Completion checks and reminders. Pattern `.*` matches always.
82
-
83
- ### prompt Events
84
- Match user prompt content for workflow enforcement.
85
-
86
- ## Pattern Writing Tips
87
-
88
- ### Regex Basics
89
- - Escape special chars: `.` to `\.`, `(` to `\(`
90
- - `\s` whitespace, `\d` digit, `\w` word char
91
- - `+` one or more, `*` zero or more, `?` optional
92
- - `|` OR operator
93
-
94
- ### Common Pitfalls
95
- - **Too broad**: `log` matches "login", "dialog" — use `console\.log\(`
96
- - **Too specific**: `rm -rf /tmp` — use `rm\s+-rf`
97
- - **YAML escaping**: Use unquoted patterns; quoted strings need `\\s`
98
-
99
- ### Testing
100
- ```bash
101
- python3 -c "import re; print(re.search(r'your_pattern', 'test text'))"
102
- ```
103
-
104
- ## File Organization
105
-
106
- - **Location**: `.claude/` directory in project root
107
- - **Naming**: `.claude/hookify.{descriptive-name}.local.md`
108
- - **Gitignore**: Add `.claude/*.local.md` to `.gitignore`
109
-
110
- ## Commands
111
-
112
- - `/hookify [description]` - Create new rules (auto-analyzes conversation if no args)
113
- - `/hookify-list` - View all rules in table format
114
- - `/hookify-configure` - Toggle rules on/off interactively
115
- - `/hookify-help` - Full documentation
116
-
117
- ## Quick Reference
118
-
119
- Minimum viable rule:
120
- ```markdown
121
- ---
122
- name: my-rule
123
- enabled: true
124
- event: bash
125
- pattern: dangerous_command
126
- ---
127
- Warning message here
128
- ```
1
+ ---
2
+ name: hookify-rules
3
+ description: This skill should be used when the user asks to create a hookify rule, write a hook rule, configure hookify, add a hookify rule, or needs guidance on hookify rule syntax and patterns.
4
+ ---
5
+
6
+ # Writing Hookify Rules
7
+
8
+ ## Overview
9
+
10
+ Hookify rules are markdown files with YAML frontmatter that define patterns to watch for and messages to show when those patterns match. Rules are stored in `.claude/hookify.{rule-name}.local.md` files.
11
+
12
+ ## Rule File Format
13
+
14
+ ### Basic Structure
15
+
16
+ ```markdown
17
+ ---
18
+ name: rule-identifier
19
+ enabled: true
20
+ event: bash|file|stop|prompt|all
21
+ pattern: regex-pattern-here
22
+ ---
23
+
24
+ Message to show Claude when this rule triggers.
25
+ Can include markdown formatting, warnings, suggestions, etc.
26
+ ```
27
+
28
+ ### Frontmatter Fields
29
+
30
+ | Field | Required | Values | Description |
31
+ |-------|----------|--------|-------------|
32
+ | name | Yes | kebab-case string | Unique identifier (verb-first: warn-*, block-*, require-*) |
33
+ | enabled | Yes | true/false | Toggle without deleting |
34
+ | event | Yes | bash/file/stop/prompt/all | Which hook event triggers this |
35
+ | action | No | warn/block | warn (default) shows message; block prevents operation |
36
+ | pattern | Yes* | regex string | Pattern to match (*or use conditions for complex rules) |
37
+
38
+ ### Advanced Format (Multiple Conditions)
39
+
40
+ ```markdown
41
+ ---
42
+ name: warn-env-api-keys
43
+ enabled: true
44
+ event: file
45
+ conditions:
46
+ - field: file_path
47
+ operator: regex_match
48
+ pattern: \.env$
49
+ - field: new_text
50
+ operator: contains
51
+ pattern: API_KEY
52
+ ---
53
+
54
+ You're adding an API key to a .env file. Ensure this file is in .gitignore!
55
+ ```
56
+
57
+ **Condition fields by event:**
58
+ - bash: `command`
59
+ - file: `file_path`, `new_text`, `old_text`, `content`
60
+ - prompt: `user_prompt`
61
+
62
+ **Operators:** `regex_match`, `contains`, `equals`, `not_contains`, `starts_with`, `ends_with`
63
+
64
+ All conditions must match for rule to trigger.
65
+
66
+ ## Event Type Guide
67
+
68
+ ### bash Events
69
+ Match Bash command patterns:
70
+ - Dangerous commands: `rm\s+-rf`, `dd\s+if=`, `mkfs`
71
+ - Privilege escalation: `sudo\s+`, `su\s+`
72
+ - Permission issues: `chmod\s+777`
73
+
74
+ ### file Events
75
+ Match Edit/Write/MultiEdit operations:
76
+ - Debug code: `console\.log\(`, `debugger`
77
+ - Security risks: `eval\(`, `innerHTML\s*=`
78
+ - Sensitive files: `\.env$`, `credentials`, `\.pem$`
79
+
80
+ ### stop Events
81
+ Completion checks and reminders. Pattern `.*` matches always.
82
+
83
+ ### prompt Events
84
+ Match user prompt content for workflow enforcement.
85
+
86
+ ## Pattern Writing Tips
87
+
88
+ ### Regex Basics
89
+ - Escape special chars: `.` to `\.`, `(` to `\(`
90
+ - `\s` whitespace, `\d` digit, `\w` word char
91
+ - `+` one or more, `*` zero or more, `?` optional
92
+ - `|` OR operator
93
+
94
+ ### Common Pitfalls
95
+ - **Too broad**: `log` matches "login", "dialog" — use `console\.log\(`
96
+ - **Too specific**: `rm -rf /tmp` — use `rm\s+-rf`
97
+ - **YAML escaping**: Use unquoted patterns; quoted strings need `\\s`
98
+
99
+ ### Testing
100
+ ```bash
101
+ python3 -c "import re; print(re.search(r'your_pattern', 'test text'))"
102
+ ```
103
+
104
+ ## File Organization
105
+
106
+ - **Location**: `.claude/` directory in project root
107
+ - **Naming**: `.claude/hookify.{descriptive-name}.local.md`
108
+ - **Gitignore**: Add `.claude/*.local.md` to `.gitignore`
109
+
110
+ ## Commands
111
+
112
+ - `/hookify [description]` - Create new rules (auto-analyzes conversation if no args)
113
+ - `/hookify-list` - View all rules in table format
114
+ - `/hookify-configure` - Toggle rules on/off interactively
115
+ - `/hookify-help` - Full documentation
116
+
117
+ ## Quick Reference
118
+
119
+ Minimum viable rule:
120
+ ```markdown
121
+ ---
122
+ name: my-rule
123
+ enabled: true
124
+ event: bash
125
+ pattern: dangerous_command
126
+ ---
127
+ Warning message here
128
+ ```
@@ -1,157 +1,157 @@
1
- ---
2
- name: inherit-legacy-style
3
- description: Legacy-project style inheritance skill. Use when the user types /inherit-legacy-style, or when onboarding an AI coding agent onto a hand-written legacy project and you need to prevent "style drift" (the model imposing its pretrained mainstream idioms onto the project). Language- and framework-agnostic — it aligns meta-architecture only, not syntax. Once run, it becomes a behavioral constraint on all subsequent coding tasks. Do NOT use for pure research or one-off questions unrelated to code-style alignment.
4
- metadata:
5
- origin: community
6
- allowed-tools: Read, Glob, Grep, Bash, Edit, Write, AskUserQuestion
7
- ---
8
-
9
- # Inherit Legacy Style
10
-
11
- Prevents AI code style drift in legacy projects by scanning the codebase for implicit conventions across 4 meta-architecture dimensions, resolving conflicts with the user one at a time, and crystallizing the consensus into an enforceable `.ai-style-rules.md`. Fully language- and framework-agnostic.
12
-
13
- ## When to Activate
14
-
15
- - User types `/inherit-legacy-style`
16
- - User mentions onboarding AI onto a hand-written legacy project
17
- - User is worried about AI-generated code "drifting" from existing project conventions
18
- - User wants to extract and codify their project's implicit coding rules
19
-
20
- ## When to Use
21
-
22
- Use this skill when you need to preserve legacy project style and prevent AI-generated style drift. See **When to Activate** above for trigger conditions.
23
-
24
- ## Prerequisites
25
-
26
- - Git (recommended; non-Git projects fall back to file timestamps for incremental mode)
27
- - Read/Write access to the project root (generates `.ai-style-rules.md` and optionally `CLAUDE.md`)
28
-
29
- ## Workflow
30
-
31
- ### Step 0 — Auto-Detect Mode
32
-
33
- Silently check for `.ai-style-rules.md` at the project root:
34
-
35
- | File exists? | Mode |
36
- |---|---|
37
- | No | **Branch A — First-time Full-Scan** |
38
- | Yes | **Branch B — Incremental Sniff** |
39
-
40
- Announce the mode in one line and proceed — never ask the user to pick.
41
-
42
- ### Branch A — First-time Full-Scan
43
-
44
- **1. Measure scale, pick a scanning tier**
45
-
46
- ```bash
47
- git ls-files | grep -cE '\.(js|ts|jsx|tsx|vue|py|go|rs|java|kt|rb|php|cs|swift|c|cpp|h)$'
48
- ```
49
-
50
- | Tier | Source files | Strategy |
51
- |---|---|---|
52
- | Small | ≲ 50 | Full close-read every source |
53
- | Medium | 50–500 | Infra layer = full read; business layer = sample 2–3 per dimension |
54
- | Large | ≳ 500 | Strict sampling + budget cap; `--stat` summary first, then targeted reads |
55
-
56
- **2. Scan along 4 dimensions**
57
-
58
- 1. **File Anatomy** — in-file declaration order (imports → types → main logic → helpers → export)
59
- 2. **State & Control Flow** — naming conventions for async state, pagination, flags
60
- 3. **Infrastructure** — where cross-cutting utils live (interceptors, formatters, middleware)
61
- 4. **Error Handling** — try/catch vs global interceptor vs Result return; null-check habits
62
-
63
- **3. Apply signal-threshold noise reduction**
64
-
65
- Before interrupting the user, evaluate signal strength:
66
-
67
- - **Weak signal** → auto-suppress: minority <5% AND count <10 → majority wins, minority goes to DONTs
68
- - **Strong signal** → grill: near-even split, or semantic fork on a core dimension
69
- - **Small-project exception**: sources ≲50, "3 vs 2" is NOT a majority → grill it
70
-
71
- **4. Resolve conflicts one at a time (Grilling Protocol)**
72
-
73
- For each strong-signal conflict, present exactly ONE question with 4 options:
74
-
75
- > Evidence: `pathA` uses style X, `pathB` uses style Y
76
- > WARNING: Risk: mixing both fractures the project style
77
- > Choose: `1` follow X `2` follow Y `3` this is evolution, update rules `4` I have a new rule
78
-
79
- Suspend until the user answers, then proceed to the next conflict. Never stack questions.
80
-
81
- **5. Generate `.ai-style-rules.md`** with three mandatory sections:
82
- - **[Golden Files]** — real exemplar paths annotated with what they demonstrate
83
- - **[Naming & State-Control Rules]** — concrete, checkable conventions
84
- - **[DONTs]** — anti-patterns that must not propagate
85
-
86
- **6. Install the persistent hook**
87
-
88
- Ask the user for enforcement strength (use `AskUserQuestion`):
89
-
90
- | Option | Mechanism |
91
- |---|---|
92
- | **1** Soft hook (recommended) | Write `@.ai-style-rules.md` reference into project `CLAUDE.md` |
93
- | **2** Hard hook | Soft hook + `PreToolUse[Write\|Edit\|MultiEdit]` Hook in `settings.json` |
94
- | **3** No hook | Keep the rules file; user references manually |
95
-
96
- ### Branch B — Incremental Sniff
97
-
98
- 1. Read existing `.ai-style-rules.md`; if it has a commit fingerprint, `git diff <last_hash> HEAD --stat` to pinpoint delta
99
- 2. Read recent Git changes (`git log -3 --stat` → inspect suspect files on demand)
100
- 3. For oversized diffs (>hundreds of files): `--stat` summary only + sample the largest changes
101
- 4. Compare new code against recorded rules → conflicts go through Grilling Protocol
102
- 5. Append evolution log at the end of `.ai-style-rules.md` (never overwrite old rules)
103
-
104
- ### Per-Turn Enforcement
105
-
106
- When `.ai-style-rules.md` is in context (loaded via CLAUDE.md), every code-writing task must open with a **compliance declaration** in the reasoning chain, naming the exemplar being followed and the DONTs being avoided.
107
-
108
- ## How It Works
109
-
110
- This skill auto-detects whether it's a first-time or incremental run via `.ai-style-rules.md` presence:
111
-
112
- - **First-time (Branch A)** — Measures project scale, scans codebase across 4 meta-architecture dimensions (File Anatomy, State & Control Flow, Infrastructure, Error Handling), applies signal-threshold noise reduction to suppress weak conflicts, resolves strong-signal conflicts one-at-a-time with the user, generates `.ai-style-rules.md` with Golden Files / Naming Rules / DONTs, and offers optional enforcement hooks.
113
- - **Incremental (Branch B)** — Reads existing rules, checks recent Git diffs for new or conflicting patterns, runs the same one-at-a-time grilling protocol for any conflicts found, and appends evolution logs without overwriting existing rules.
114
- - **Per-Turn Enforcement** — When hooked via `CLAUDE.md`, every code-writing task opens with a compliance declaration naming the exemplar followed and the DONTs avoided.
115
-
116
- ## Output Specification
117
-
118
- - `.ai-style-rules.md` at project root (with commit fingerprint + scale tier in header)
119
- - Optionally `CLAUDE.md` with `@.ai-style-rules.md` reference
120
- - Evolution logs appended as `### [YYYY-MM-DD] Style Evolution Log` entries
121
-
122
- ## Anti-Patterns
123
-
124
- - FAIL: Do NOT skip the scale measurement step — sampling a 30-file project "starves" it; full-scanning a 5,000-file repo blows up
125
- - FAIL: Do NOT stack multiple conflict questions at once — grilling is strictly one-at-a-time
126
- - FAIL: Do NOT overwrite old rules in incremental mode — always append evolution logs
127
- - FAIL: Do NOT default to "hard hook" without asking — enforcement strength is the user's call
128
- - FAIL: Do NOT judge syntax or tech-stack quality — this skill aligns meta-architecture only
129
- - FAIL: Do NOT copy bugs from exemplar files — reuse structure, flag defects
130
-
131
- ## Best Practices
132
-
133
- - Announce the detected mode (first-time vs incremental) and scale tier in one line before scanning
134
- - For large projects, read `--stat` summaries first, then targeted `Read` on suspect files
135
- - Let the signal threshold handle noise — a 843-vs-8 naming split should auto-resolve without user interruption
136
- - When in doubt about signal strength, lean toward asking
137
- - The CLAUDE.md soft hook (`@.ai-style-rules.md`) is usually sufficient; hard hook only if the user wants mechanical enforcement
138
-
139
- ## Related Skills
140
-
141
- - `init` — initialize a new CLAUDE.md with codebase documentation
142
- - `code-review` — review diffs for correctness and style issues
143
- - `simplify` — review code for reuse and simplification opportunities
144
-
145
- ## Examples
146
-
147
- 1. **First-time onboarding**
148
- - User: "Help me onboard AI to this older codebase without changing its style."
149
- - Action: Run Branch A full-scan → measure scale → scan 4 dimensions → grill conflicts → generate `.ai-style-rules.md` → offer hook strength (soft/hard/none).
150
-
151
- 2. **Incremental update after team changes**
152
- - User: "We added a new module; keep existing style rules intact."
153
- - Action: Run Branch B incremental sniff → compare Git deltas to recorded rules → grill any new conflicts → append evolution log without overwriting.
154
-
155
- 3. **Enforcing DONTs via CLAUDE.md**
156
- - User: "Make sure all new code stays consistent with the project's rules."
157
- - Action: Soft hook installed → `.ai-style-rules.md` auto-loaded every session → every code-writing task opens with compliance declaration, reusing exemplar patterns and avoiding DONTs.
1
+ ---
2
+ name: inherit-legacy-style
3
+ description: Legacy-project style inheritance skill. Use when the user types /inherit-legacy-style, or when onboarding an AI coding agent onto a hand-written legacy project and you need to prevent "style drift" (the model imposing its pretrained mainstream idioms onto the project). Language- and framework-agnostic — it aligns meta-architecture only, not syntax. Once run, it becomes a behavioral constraint on all subsequent coding tasks. Do NOT use for pure research or one-off questions unrelated to code-style alignment.
4
+ metadata:
5
+ origin: community
6
+ allowed-tools: Read, Glob, Grep, Bash, Edit, Write, AskUserQuestion
7
+ ---
8
+
9
+ # Inherit Legacy Style
10
+
11
+ Prevents AI code style drift in legacy projects by scanning the codebase for implicit conventions across 4 meta-architecture dimensions, resolving conflicts with the user one at a time, and crystallizing the consensus into an enforceable `.ai-style-rules.md`. Fully language- and framework-agnostic.
12
+
13
+ ## When to Activate
14
+
15
+ - User types `/inherit-legacy-style`
16
+ - User mentions onboarding AI onto a hand-written legacy project
17
+ - User is worried about AI-generated code "drifting" from existing project conventions
18
+ - User wants to extract and codify their project's implicit coding rules
19
+
20
+ ## When to Use
21
+
22
+ Use this skill when you need to preserve legacy project style and prevent AI-generated style drift. See **When to Activate** above for trigger conditions.
23
+
24
+ ## Prerequisites
25
+
26
+ - Git (recommended; non-Git projects fall back to file timestamps for incremental mode)
27
+ - Read/Write access to the project root (generates `.ai-style-rules.md` and optionally `CLAUDE.md`)
28
+
29
+ ## Workflow
30
+
31
+ ### Step 0 — Auto-Detect Mode
32
+
33
+ Silently check for `.ai-style-rules.md` at the project root:
34
+
35
+ | File exists? | Mode |
36
+ |---|---|
37
+ | No | **Branch A — First-time Full-Scan** |
38
+ | Yes | **Branch B — Incremental Sniff** |
39
+
40
+ Announce the mode in one line and proceed — never ask the user to pick.
41
+
42
+ ### Branch A — First-time Full-Scan
43
+
44
+ **1. Measure scale, pick a scanning tier**
45
+
46
+ ```bash
47
+ git ls-files | grep -cE '\.(js|ts|jsx|tsx|vue|py|go|rs|java|kt|rb|php|cs|swift|c|cpp|h)$'
48
+ ```
49
+
50
+ | Tier | Source files | Strategy |
51
+ |---|---|---|
52
+ | Small | ≲ 50 | Full close-read every source |
53
+ | Medium | 50–500 | Infra layer = full read; business layer = sample 2–3 per dimension |
54
+ | Large | ≳ 500 | Strict sampling + budget cap; `--stat` summary first, then targeted reads |
55
+
56
+ **2. Scan along 4 dimensions**
57
+
58
+ 1. **File Anatomy** — in-file declaration order (imports → types → main logic → helpers → export)
59
+ 2. **State & Control Flow** — naming conventions for async state, pagination, flags
60
+ 3. **Infrastructure** — where cross-cutting utils live (interceptors, formatters, middleware)
61
+ 4. **Error Handling** — try/catch vs global interceptor vs Result return; null-check habits
62
+
63
+ **3. Apply signal-threshold noise reduction**
64
+
65
+ Before interrupting the user, evaluate signal strength:
66
+
67
+ - **Weak signal** → auto-suppress: minority <5% AND count <10 → majority wins, minority goes to DONTs
68
+ - **Strong signal** → grill: near-even split, or semantic fork on a core dimension
69
+ - **Small-project exception**: sources ≲50, "3 vs 2" is NOT a majority → grill it
70
+
71
+ **4. Resolve conflicts one at a time (Grilling Protocol)**
72
+
73
+ For each strong-signal conflict, present exactly ONE question with 4 options:
74
+
75
+ > Evidence: `pathA` uses style X, `pathB` uses style Y
76
+ > WARNING: Risk: mixing both fractures the project style
77
+ > Choose: `1` follow X `2` follow Y `3` this is evolution, update rules `4` I have a new rule
78
+
79
+ Suspend until the user answers, then proceed to the next conflict. Never stack questions.
80
+
81
+ **5. Generate `.ai-style-rules.md`** with three mandatory sections:
82
+ - **[Golden Files]** — real exemplar paths annotated with what they demonstrate
83
+ - **[Naming & State-Control Rules]** — concrete, checkable conventions
84
+ - **[DONTs]** — anti-patterns that must not propagate
85
+
86
+ **6. Install the persistent hook**
87
+
88
+ Ask the user for enforcement strength (use `AskUserQuestion`):
89
+
90
+ | Option | Mechanism |
91
+ |---|---|
92
+ | **1** Soft hook (recommended) | Write `@.ai-style-rules.md` reference into project `CLAUDE.md` |
93
+ | **2** Hard hook | Soft hook + `PreToolUse[Write\|Edit\|MultiEdit]` Hook in `settings.json` |
94
+ | **3** No hook | Keep the rules file; user references manually |
95
+
96
+ ### Branch B — Incremental Sniff
97
+
98
+ 1. Read existing `.ai-style-rules.md`; if it has a commit fingerprint, `git diff <last_hash> HEAD --stat` to pinpoint delta
99
+ 2. Read recent Git changes (`git log -3 --stat` → inspect suspect files on demand)
100
+ 3. For oversized diffs (>hundreds of files): `--stat` summary only + sample the largest changes
101
+ 4. Compare new code against recorded rules → conflicts go through Grilling Protocol
102
+ 5. Append evolution log at the end of `.ai-style-rules.md` (never overwrite old rules)
103
+
104
+ ### Per-Turn Enforcement
105
+
106
+ When `.ai-style-rules.md` is in context (loaded via CLAUDE.md), every code-writing task must open with a **compliance declaration** in the reasoning chain, naming the exemplar being followed and the DONTs being avoided.
107
+
108
+ ## How It Works
109
+
110
+ This skill auto-detects whether it's a first-time or incremental run via `.ai-style-rules.md` presence:
111
+
112
+ - **First-time (Branch A)** — Measures project scale, scans codebase across 4 meta-architecture dimensions (File Anatomy, State & Control Flow, Infrastructure, Error Handling), applies signal-threshold noise reduction to suppress weak conflicts, resolves strong-signal conflicts one-at-a-time with the user, generates `.ai-style-rules.md` with Golden Files / Naming Rules / DONTs, and offers optional enforcement hooks.
113
+ - **Incremental (Branch B)** — Reads existing rules, checks recent Git diffs for new or conflicting patterns, runs the same one-at-a-time grilling protocol for any conflicts found, and appends evolution logs without overwriting existing rules.
114
+ - **Per-Turn Enforcement** — When hooked via `CLAUDE.md`, every code-writing task opens with a compliance declaration naming the exemplar followed and the DONTs avoided.
115
+
116
+ ## Output Specification
117
+
118
+ - `.ai-style-rules.md` at project root (with commit fingerprint + scale tier in header)
119
+ - Optionally `CLAUDE.md` with `@.ai-style-rules.md` reference
120
+ - Evolution logs appended as `### [YYYY-MM-DD] Style Evolution Log` entries
121
+
122
+ ## Anti-Patterns
123
+
124
+ - FAIL: Do NOT skip the scale measurement step — sampling a 30-file project "starves" it; full-scanning a 5,000-file repo blows up
125
+ - FAIL: Do NOT stack multiple conflict questions at once — grilling is strictly one-at-a-time
126
+ - FAIL: Do NOT overwrite old rules in incremental mode — always append evolution logs
127
+ - FAIL: Do NOT default to "hard hook" without asking — enforcement strength is the user's call
128
+ - FAIL: Do NOT judge syntax or tech-stack quality — this skill aligns meta-architecture only
129
+ - FAIL: Do NOT copy bugs from exemplar files — reuse structure, flag defects
130
+
131
+ ## Best Practices
132
+
133
+ - Announce the detected mode (first-time vs incremental) and scale tier in one line before scanning
134
+ - For large projects, read `--stat` summaries first, then targeted `Read` on suspect files
135
+ - Let the signal threshold handle noise — a 843-vs-8 naming split should auto-resolve without user interruption
136
+ - When in doubt about signal strength, lean toward asking
137
+ - The CLAUDE.md soft hook (`@.ai-style-rules.md`) is usually sufficient; hard hook only if the user wants mechanical enforcement
138
+
139
+ ## Related Skills
140
+
141
+ - `init` — initialize a new CLAUDE.md with codebase documentation
142
+ - `code-review` — review diffs for correctness and style issues
143
+ - `simplify` — review code for reuse and simplification opportunities
144
+
145
+ ## Examples
146
+
147
+ 1. **First-time onboarding**
148
+ - User: "Help me onboard AI to this older codebase without changing its style."
149
+ - Action: Run Branch A full-scan → measure scale → scan 4 dimensions → grill conflicts → generate `.ai-style-rules.md` → offer hook strength (soft/hard/none).
150
+
151
+ 2. **Incremental update after team changes**
152
+ - User: "We added a new module; keep existing style rules intact."
153
+ - Action: Run Branch B incremental sniff → compare Git deltas to recorded rules → grill any new conflicts → append evolution log without overwriting.
154
+
155
+ 3. **Enforcing DONTs via CLAUDE.md**
156
+ - User: "Make sure all new code stays consistent with the project's rules."
157
+ - Action: Soft hook installed → `.ai-style-rules.md` auto-loaded every session → every code-writing task opens with compliance declaration, reusing exemplar patterns and avoiding DONTs.