codeply-cli 0.5.6 → 0.6.0

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