codeply-cli 0.3.1 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (375) hide show
  1. package/THIRD_PARTY_NOTICES.md +63 -63
  2. package/bin/codeply.js +127 -0
  3. package/lib/agent.mjs +2139 -2139
  4. package/lib/ai.mjs +6 -6
  5. package/lib/apply-patch.js +217 -217
  6. package/lib/arity-table.json +138 -138
  7. package/lib/arity.js +70 -70
  8. package/lib/auth.mjs +6 -6
  9. package/lib/cloud.mjs +796 -0
  10. package/lib/commands.js +103 -103
  11. package/lib/design-library/assemble-artifact.mjs +21 -21
  12. package/lib/design-library/cleanup.mjs +45 -45
  13. package/lib/design-library/index.json +22379 -22379
  14. package/lib/design-library/make-table-data.mjs +39 -39
  15. package/lib/diagnostics.js +192 -192
  16. package/lib/edit-engine.js +364 -364
  17. package/lib/github-agent.mjs +311 -307
  18. package/lib/history.js +75 -75
  19. package/lib/mcp.js +258 -258
  20. package/lib/native-tools.mjs +189 -189
  21. package/lib/oauth-connectors.js +2 -1
  22. package/lib/permissions.js +109 -109
  23. package/lib/plugins.js +353 -353
  24. package/lib/server.mjs +457 -457
  25. package/lib/session-db.js +220 -220
  26. package/lib/share.js +168 -168
  27. package/lib/skills.js +416 -416
  28. package/lib/snapshot.js +146 -146
  29. package/lib/terminal-hints.js +154 -154
  30. package/lib/tools.mjs +2012 -2012
  31. package/lib/typecheck-worker.js +147 -147
  32. package/lib/web-tools.js +158 -158
  33. package/package.json +49 -47
  34. package/skills/SOURCE.md +58 -58
  35. package/skills/accessibility/SKILL.md +147 -147
  36. package/skills/agent-architecture-audit/SKILL.md +257 -257
  37. package/skills/agent-eval/SKILL.md +147 -147
  38. package/skills/agent-harness-construction/SKILL.md +74 -74
  39. package/skills/agent-introspection-debugging/SKILL.md +154 -154
  40. package/skills/agent-payment-x402/SKILL.md +225 -225
  41. package/skills/agent-self-evaluation/SKILL.md +182 -182
  42. package/skills/agent-self-evaluation/references/evaluation-criteria.md +71 -71
  43. package/skills/agent-self-evaluation/references/hook-integration.md +64 -64
  44. package/skills/agent-sort/SKILL.md +216 -216
  45. package/skills/agentic-engineering/SKILL.md +64 -64
  46. package/skills/agentic-os/SKILL.md +388 -388
  47. package/skills/ai-first-engineering/SKILL.md +52 -52
  48. package/skills/ai-regression-testing/SKILL.md +386 -386
  49. package/skills/android-clean-architecture/SKILL.md +340 -340
  50. package/skills/angular-developer/SKILL.md +155 -155
  51. package/skills/angular-developer/references/angular-animations.md +160 -160
  52. package/skills/angular-developer/references/angular-aria.md +410 -410
  53. package/skills/angular-developer/references/cli.md +86 -86
  54. package/skills/angular-developer/references/component-harnesses.md +59 -59
  55. package/skills/angular-developer/references/component-styling.md +91 -91
  56. package/skills/angular-developer/references/components.md +117 -117
  57. package/skills/angular-developer/references/creating-services.md +97 -97
  58. package/skills/angular-developer/references/data-resolvers.md +69 -69
  59. package/skills/angular-developer/references/define-routes.md +67 -67
  60. package/skills/angular-developer/references/defining-providers.md +72 -72
  61. package/skills/angular-developer/references/di-fundamentals.md +120 -120
  62. package/skills/angular-developer/references/e2e-testing.md +56 -56
  63. package/skills/angular-developer/references/effects.md +83 -83
  64. package/skills/angular-developer/references/hierarchical-injectors.md +43 -43
  65. package/skills/angular-developer/references/host-elements.md +80 -80
  66. package/skills/angular-developer/references/injection-context.md +63 -63
  67. package/skills/angular-developer/references/inputs.md +101 -101
  68. package/skills/angular-developer/references/linked-signal.md +59 -59
  69. package/skills/angular-developer/references/loading-strategies.md +61 -61
  70. package/skills/angular-developer/references/mcp.md +108 -108
  71. package/skills/angular-developer/references/navigate-to-routes.md +69 -69
  72. package/skills/angular-developer/references/outputs.md +86 -86
  73. package/skills/angular-developer/references/reactive-forms.md +122 -122
  74. package/skills/angular-developer/references/rendering-strategies.md +44 -44
  75. package/skills/angular-developer/references/resource.md +77 -77
  76. package/skills/angular-developer/references/route-animations.md +56 -56
  77. package/skills/angular-developer/references/route-guards.md +52 -52
  78. package/skills/angular-developer/references/router-lifecycle.md +45 -45
  79. package/skills/angular-developer/references/router-testing.md +87 -87
  80. package/skills/angular-developer/references/show-routes-with-outlets.md +68 -68
  81. package/skills/angular-developer/references/signal-forms.md +795 -795
  82. package/skills/angular-developer/references/signals-overview.md +94 -94
  83. package/skills/angular-developer/references/tailwind-css.md +69 -69
  84. package/skills/angular-developer/references/template-driven-forms.md +114 -114
  85. package/skills/angular-developer/references/testing-fundamentals.md +65 -65
  86. package/skills/api-connector-builder/SKILL.md +121 -121
  87. package/skills/api-design/SKILL.md +524 -524
  88. package/skills/architecture-decision-records/SKILL.md +180 -180
  89. package/skills/article-writing/SKILL.md +80 -80
  90. package/skills/automation-audit-ops/SKILL.md +143 -143
  91. package/skills/autonomous-agent-harness/SKILL.md +274 -274
  92. package/skills/autonomous-loops/SKILL.md +611 -611
  93. package/skills/backend-patterns/SKILL.md +562 -562
  94. package/skills/benchmark/SKILL.md +95 -95
  95. package/skills/benchmark-methodology/SKILL.md +191 -191
  96. package/skills/benchmark-optimization-loop/SKILL.md +71 -71
  97. package/skills/blender-motion-state-inspection/SKILL.md +165 -165
  98. package/skills/blueprint/SKILL.md +106 -106
  99. package/skills/brand-discovery/SKILL.md +145 -145
  100. package/skills/brand-discovery/references/10_purpose-why.md +40 -40
  101. package/skills/brand-discovery/references/20_positioning.md +44 -44
  102. package/skills/brand-discovery/references/30_audience-niche.md +52 -52
  103. package/skills/brand-discovery/references/40_personality-archetype.md +57 -57
  104. package/skills/brand-discovery/references/50_voice-tone.md +59 -59
  105. package/skills/brand-discovery/references/60_narrative-story.md +50 -50
  106. package/skills/brand-discovery/references/70_founder-tension.md +49 -49
  107. package/skills/brand-discovery/references/90_SYNTHESIS.md +133 -133
  108. package/skills/brand-voice/SKILL.md +98 -98
  109. package/skills/brand-voice/references/voice-profile-schema.md +55 -55
  110. package/skills/browser-qa/SKILL.md +105 -105
  111. package/skills/bun-runtime/SKILL.md +85 -85
  112. package/skills/canary-watch/SKILL.md +108 -108
  113. package/skills/carrier-relationship-management/SKILL.md +212 -212
  114. package/skills/cisco-ios-patterns/SKILL.md +164 -164
  115. package/skills/ck/SKILL.md +148 -148
  116. package/skills/claude-devfleet/SKILL.md +112 -112
  117. package/skills/click-path-audit/SKILL.md +245 -245
  118. package/skills/clickhouse-io/SKILL.md +445 -445
  119. package/skills/code-tour/SKILL.md +254 -254
  120. package/skills/codebase-onboarding/SKILL.md +234 -234
  121. package/skills/codehealth-mcp/SKILL.md +167 -167
  122. package/skills/coding-standards/SKILL.md +551 -551
  123. package/skills/competitive-platform-analysis/SKILL.md +214 -214
  124. package/skills/competitive-report-structure/SKILL.md +162 -162
  125. package/skills/compose-multiplatform-patterns/SKILL.md +300 -300
  126. package/skills/config-gc/SKILL.md +120 -120
  127. package/skills/configure-ecc/SKILL.md +385 -385
  128. package/skills/connections-optimizer/SKILL.md +190 -190
  129. package/skills/content-engine/SKILL.md +132 -132
  130. package/skills/content-hash-cache-pattern/SKILL.md +162 -162
  131. package/skills/context-budget/SKILL.md +136 -136
  132. package/skills/continuous-agent-loop/SKILL.md +46 -46
  133. package/skills/continuous-learning/SKILL.md +132 -132
  134. package/skills/continuous-learning-v2/SKILL.md +361 -361
  135. package/skills/contract-first/SKILL.md +287 -287
  136. package/skills/cost-aware-llm-pipeline/SKILL.md +184 -184
  137. package/skills/cost-tracking/SKILL.md +97 -97
  138. package/skills/council/SKILL.md +204 -204
  139. package/skills/cpp-coding-standards/SKILL.md +724 -724
  140. package/skills/cpp-testing/SKILL.md +325 -325
  141. package/skills/crosspost/SKILL.md +112 -112
  142. package/skills/csharp-testing/SKILL.md +322 -322
  143. package/skills/customer-billing-ops/SKILL.md +141 -141
  144. package/skills/customs-trade-compliance/SKILL.md +263 -263
  145. package/skills/dart-flutter-patterns/SKILL.md +564 -564
  146. package/skills/dashboard-builder/SKILL.md +109 -109
  147. package/skills/data-scraper-agent/SKILL.md +765 -765
  148. package/skills/data-throughput-accelerator/SKILL.md +74 -74
  149. package/skills/database-migrations/SKILL.md +430 -430
  150. package/skills/deep-research/SKILL.md +160 -160
  151. package/skills/defi-amm-security/SKILL.md +167 -167
  152. package/skills/delivery-gate/SKILL.md +126 -126
  153. package/skills/deployment-patterns/SKILL.md +428 -428
  154. package/skills/design-system/SKILL.md +83 -83
  155. package/skills/django-celery/SKILL.md +458 -458
  156. package/skills/django-patterns/SKILL.md +735 -735
  157. package/skills/django-security/SKILL.md +644 -644
  158. package/skills/django-tdd/SKILL.md +730 -730
  159. package/skills/django-verification/SKILL.md +470 -470
  160. package/skills/dmux-workflows/SKILL.md +192 -192
  161. package/skills/docker-patterns/SKILL.md +365 -365
  162. package/skills/documentation-lookup/SKILL.md +91 -91
  163. package/skills/dotnet-patterns/SKILL.md +322 -322
  164. package/skills/dynamic-workflow-mode/SKILL.md +124 -124
  165. package/skills/e2e-testing/SKILL.md +327 -327
  166. package/skills/ecc-guide/SKILL.md +190 -190
  167. package/skills/ecc-recipes/SKILL.md +149 -149
  168. package/skills/ecc-tools-cost-audit/SKILL.md +161 -161
  169. package/skills/email-ops/SKILL.md +122 -122
  170. package/skills/energy-procurement/SKILL.md +228 -228
  171. package/skills/enterprise-agent-ops/SKILL.md +51 -51
  172. package/skills/error-handling/SKILL.md +377 -377
  173. package/skills/eval-harness/SKILL.md +271 -271
  174. package/skills/evm-token-decimals/SKILL.md +131 -131
  175. package/skills/exa-search/SKILL.md +108 -108
  176. package/skills/fal-ai-media/SKILL.md +289 -289
  177. package/skills/fastapi-patterns/SKILL.md +514 -514
  178. package/skills/finance-billing-ops/SKILL.md +128 -128
  179. package/skills/flox-environments/SKILL.md +497 -497
  180. package/skills/flutter-dart-code-review/SKILL.md +436 -436
  181. package/skills/foundation-models-on-device/SKILL.md +243 -243
  182. package/skills/frontend-a11y/SKILL.md +446 -446
  183. package/skills/frontend-design-direction/SKILL.md +93 -93
  184. package/skills/frontend-patterns/SKILL.md +657 -657
  185. package/skills/frontend-slides/SKILL.md +185 -185
  186. package/skills/fsharp-testing/SKILL.md +281 -281
  187. package/skills/gan-style-harness/SKILL.md +279 -279
  188. package/skills/gateguard/SKILL.md +133 -133
  189. package/skills/generating-python-installer/SKILL.md +820 -820
  190. package/skills/git-workflow/SKILL.md +716 -716
  191. package/skills/github-ops/SKILL.md +145 -145
  192. package/skills/golang-patterns/SKILL.md +676 -676
  193. package/skills/golang-testing/SKILL.md +721 -721
  194. package/skills/google-workspace-ops/SKILL.md +96 -96
  195. package/skills/growth-log/SKILL.md +128 -128
  196. package/skills/healthcare-cdss-patterns/SKILL.md +246 -246
  197. package/skills/healthcare-emr-patterns/SKILL.md +160 -160
  198. package/skills/healthcare-eval-harness/SKILL.md +208 -208
  199. package/skills/healthcare-phi-compliance/SKILL.md +146 -146
  200. package/skills/hermes-imports/SKILL.md +89 -89
  201. package/skills/hexagonal-architecture/SKILL.md +277 -277
  202. package/skills/hipaa-compliance/SKILL.md +79 -79
  203. package/skills/homelab-network-readiness/SKILL.md +170 -170
  204. package/skills/homelab-network-setup/SKILL.md +130 -130
  205. package/skills/homelab-pihole-dns/SKILL.md +275 -275
  206. package/skills/homelab-vlan-segmentation/SKILL.md +312 -312
  207. package/skills/homelab-wireguard-vpn/SKILL.md +306 -306
  208. package/skills/hookify-rules/SKILL.md +128 -128
  209. package/skills/inherit-legacy-style/SKILL.md +157 -157
  210. package/skills/intent-driven-development/SKILL.md +360 -360
  211. package/skills/inventory-demand-planning/SKILL.md +247 -247
  212. package/skills/investor-materials/SKILL.md +97 -97
  213. package/skills/investor-outreach/SKILL.md +92 -92
  214. package/skills/ios-icon-gen/SKILL.md +158 -158
  215. package/skills/iterative-retrieval/SKILL.md +212 -212
  216. package/skills/ito-basket-compare/SKILL.md +64 -64
  217. package/skills/ito-compute/SKILL.md +129 -129
  218. package/skills/ito-data-atlas-agent/SKILL.md +64 -64
  219. package/skills/ito-market-intelligence/SKILL.md +61 -61
  220. package/skills/ito-trade-planner/SKILL.md +68 -68
  221. package/skills/java-coding-standards/SKILL.md +384 -384
  222. package/skills/jira-integration/SKILL.md +303 -303
  223. package/skills/jpa-patterns/SKILL.md +152 -152
  224. package/skills/knowledge-ops/SKILL.md +155 -155
  225. package/skills/kotlin-coroutines-flows/SKILL.md +285 -285
  226. package/skills/kotlin-exposed-patterns/SKILL.md +720 -720
  227. package/skills/kotlin-ktor-patterns/SKILL.md +690 -690
  228. package/skills/kotlin-patterns/SKILL.md +712 -712
  229. package/skills/kotlin-testing/SKILL.md +825 -825
  230. package/skills/kubernetes-patterns/SKILL.md +756 -756
  231. package/skills/laravel-patterns/SKILL.md +416 -416
  232. package/skills/laravel-plugin-discovery/SKILL.md +230 -230
  233. package/skills/laravel-security/SKILL.md +948 -948
  234. package/skills/laravel-tdd/SKILL.md +675 -675
  235. package/skills/laravel-verification/SKILL.md +180 -180
  236. package/skills/latency-critical-systems/SKILL.md +75 -75
  237. package/skills/lead-intelligence/SKILL.md +322 -322
  238. package/skills/liquid-glass-design/SKILL.md +279 -279
  239. package/skills/llm-trading-agent-security/SKILL.md +147 -147
  240. package/skills/logistics-exception-management/SKILL.md +222 -222
  241. package/skills/loop-design-check/SKILL.md +143 -143
  242. package/skills/mailtrap-email-integration/SKILL.md +77 -77
  243. package/skills/make-interfaces-feel-better/SKILL.md +152 -152
  244. package/skills/manim-video/SKILL.md +90 -90
  245. package/skills/market-research/SKILL.md +76 -76
  246. package/skills/marketing-campaign/SKILL.md +114 -114
  247. package/skills/mcp-server-patterns/SKILL.md +70 -70
  248. package/skills/messages-ops/SKILL.md +105 -105
  249. package/skills/ml-adoption-playbook/SKILL.md +57 -57
  250. package/skills/mle-workflow/SKILL.md +348 -348
  251. package/skills/motion-advanced/SKILL.md +596 -596
  252. package/skills/motion-foundations/SKILL.md +299 -299
  253. package/skills/motion-patterns/SKILL.md +434 -434
  254. package/skills/motion-ui/SKILL.md +576 -576
  255. package/skills/mysql-patterns/SKILL.md +413 -413
  256. package/skills/nanoclaw-repl/SKILL.md +34 -34
  257. package/skills/nestjs-patterns/SKILL.md +231 -231
  258. package/skills/netmiko-ssh-automation/SKILL.md +174 -174
  259. package/skills/network-bgp-diagnostics/SKILL.md +168 -168
  260. package/skills/network-config-validation/SKILL.md +211 -211
  261. package/skills/network-interface-health/SKILL.md +153 -153
  262. package/skills/nextjs-turbopack/SKILL.md +58 -58
  263. package/skills/nodejs-keccak256/SKILL.md +103 -103
  264. package/skills/nutrient-document-processing/SKILL.md +168 -168
  265. package/skills/nuxt4-patterns/SKILL.md +101 -101
  266. package/skills/openclaw-persona-forge/SKILL.md +289 -289
  267. package/skills/openclaw-persona-forge/references/avatar-style.md +124 -124
  268. package/skills/openclaw-persona-forge/references/boundary-rules.md +53 -53
  269. package/skills/openclaw-persona-forge/references/error-handling.md +53 -53
  270. package/skills/openclaw-persona-forge/references/identity-tension.md +48 -48
  271. package/skills/openclaw-persona-forge/references/naming-system.md +39 -39
  272. package/skills/openclaw-persona-forge/references/output-template.md +166 -166
  273. package/skills/opensource-pipeline/SKILL.md +256 -256
  274. package/skills/orch-add-feature/SKILL.md +45 -45
  275. package/skills/orch-build-mvp/SKILL.md +49 -49
  276. package/skills/orch-change-feature/SKILL.md +43 -43
  277. package/skills/orch-fix-defect/SKILL.md +43 -43
  278. package/skills/orch-pipeline/SKILL.md +121 -121
  279. package/skills/orch-refine-code/SKILL.md +44 -44
  280. package/skills/parallel-execution-optimizer/SKILL.md +74 -74
  281. package/skills/perl-patterns/SKILL.md +505 -505
  282. package/skills/perl-security/SKILL.md +504 -504
  283. package/skills/perl-testing/SKILL.md +476 -476
  284. package/skills/plan-canvas/SKILL.md +153 -153
  285. package/skills/plan-orchestrate/SKILL.md +263 -263
  286. package/skills/plankton-code-quality/SKILL.md +237 -237
  287. package/skills/postgres-patterns/SKILL.md +148 -148
  288. package/skills/prediction-market-oracle-research/SKILL.md +64 -64
  289. package/skills/prediction-market-risk-review/SKILL.md +61 -61
  290. package/skills/premium-web-design/SKILL.md +154 -154
  291. package/skills/prisma-patterns/SKILL.md +401 -401
  292. package/skills/product-capability/SKILL.md +142 -142
  293. package/skills/product-lens/SKILL.md +93 -93
  294. package/skills/production-audit/SKILL.md +207 -207
  295. package/skills/production-scheduling/SKILL.md +238 -238
  296. package/skills/project-flow-ops/SKILL.md +112 -112
  297. package/skills/prompt-optimizer/SKILL.md +398 -398
  298. package/skills/python-patterns/SKILL.md +751 -751
  299. package/skills/python-testing/SKILL.md +817 -817
  300. package/skills/pytorch-patterns/SKILL.md +397 -397
  301. package/skills/quality-nonconformance/SKILL.md +260 -260
  302. package/skills/quarkus-patterns/SKILL.md +723 -723
  303. package/skills/quarkus-security/SKILL.md +468 -468
  304. package/skills/quarkus-tdd/SKILL.md +812 -812
  305. package/skills/quarkus-verification/SKILL.md +480 -480
  306. package/skills/ralphinho-rfc-pipeline/SKILL.md +68 -68
  307. package/skills/react-native-patterns/SKILL.md +326 -326
  308. package/skills/react-patterns/SKILL.md +342 -342
  309. package/skills/react-performance/SKILL.md +575 -575
  310. package/skills/react-testing/SKILL.md +424 -424
  311. package/skills/recsys-pipeline-architect/SKILL.md +115 -115
  312. package/skills/recursive-decision-ledger/SKILL.md +81 -81
  313. package/skills/redis-patterns/SKILL.md +404 -404
  314. package/skills/regex-vs-llm-structured-text/SKILL.md +221 -221
  315. package/skills/remotion-video-creation/SKILL.md +43 -43
  316. package/skills/repo-scan/SKILL.md +79 -79
  317. package/skills/research-ops/SKILL.md +113 -113
  318. package/skills/returns-reverse-logistics/SKILL.md +240 -240
  319. package/skills/rules-distill/SKILL.md +265 -265
  320. package/skills/rust-patterns/SKILL.md +500 -500
  321. package/skills/rust-testing/SKILL.md +501 -501
  322. package/skills/safety-guard/SKILL.md +76 -76
  323. package/skills/santa-method/SKILL.md +307 -307
  324. package/skills/scientific-db-pubmed-database/SKILL.md +176 -176
  325. package/skills/scientific-db-uspto-database/SKILL.md +178 -178
  326. package/skills/scientific-pkg-gget/SKILL.md +167 -167
  327. package/skills/scientific-thinking-literature-review/SKILL.md +193 -193
  328. package/skills/scientific-thinking-scholar-evaluation/SKILL.md +161 -161
  329. package/skills/search-first/SKILL.md +183 -183
  330. package/skills/security-bounty-hunter/SKILL.md +100 -100
  331. package/skills/security-review/SKILL.md +504 -504
  332. package/skills/security-scan/SKILL.md +166 -166
  333. package/skills/seo/SKILL.md +155 -155
  334. package/skills/skill-comply/SKILL.md +59 -59
  335. package/skills/skill-scout/SKILL.md +141 -141
  336. package/skills/skill-stocktake/SKILL.md +195 -195
  337. package/skills/social-graph-ranker/SKILL.md +155 -155
  338. package/skills/social-publisher/SKILL.md +130 -130
  339. package/skills/springboot-patterns/SKILL.md +315 -315
  340. package/skills/springboot-security/SKILL.md +273 -273
  341. package/skills/springboot-tdd/SKILL.md +159 -159
  342. package/skills/springboot-verification/SKILL.md +232 -232
  343. package/skills/strategic-compact/SKILL.md +142 -142
  344. package/skills/swift-actor-persistence/SKILL.md +144 -144
  345. package/skills/swift-concurrency-6-2/SKILL.md +216 -216
  346. package/skills/swift-protocol-di-testing/SKILL.md +191 -191
  347. package/skills/swiftui-patterns/SKILL.md +259 -259
  348. package/skills/taste/SKILL.md +264 -264
  349. package/skills/taste/references/genre-taxonomy.md +87 -87
  350. package/skills/tdd-workflow/SKILL.md +583 -583
  351. package/skills/team-agent-orchestration/SKILL.md +111 -111
  352. package/skills/team-builder/SKILL.md +169 -169
  353. package/skills/terminal-ops/SKILL.md +110 -110
  354. package/skills/tinystruct-patterns/SKILL.md +279 -279
  355. package/skills/tinystruct-patterns/references/architecture.md +90 -90
  356. package/skills/tinystruct-patterns/references/data-handling.md +60 -60
  357. package/skills/tinystruct-patterns/references/database.md +99 -99
  358. package/skills/tinystruct-patterns/references/routing.md +64 -64
  359. package/skills/tinystruct-patterns/references/system-usage.md +97 -97
  360. package/skills/tinystruct-patterns/references/testing.md +72 -72
  361. package/skills/token-budget-advisor/SKILL.md +134 -134
  362. package/skills/ui-demo/SKILL.md +466 -466
  363. package/skills/ui-to-vue/SKILL.md +135 -135
  364. package/skills/uncloud/SKILL.md +344 -344
  365. package/skills/unified-memory/SKILL.md +170 -170
  366. package/skills/unified-notifications-ops/SKILL.md +188 -188
  367. package/skills/verification-loop/SKILL.md +129 -129
  368. package/skills/video-editing/SKILL.md +311 -311
  369. package/skills/videodb/SKILL.md +375 -375
  370. package/skills/visa-doc-translate/SKILL.md +117 -117
  371. package/skills/vite-patterns/SKILL.md +450 -450
  372. package/skills/vue-patterns/SKILL.md +471 -471
  373. package/skills/windows-desktop-e2e/SKILL.md +888 -888
  374. package/skills/workspace-surface-audit/SKILL.md +126 -126
  375. 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.