@rune-kit/rune 2.10.0 → 2.11.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 (205) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +8 -6
  3. package/commands/rune.md +168 -168
  4. package/contexts/dev.md +34 -34
  5. package/contexts/research.md +43 -43
  6. package/contexts/review.md +55 -55
  7. package/extensions/ai-ml/PACK.md +88 -88
  8. package/extensions/ai-ml/skills/ai-agents.md +172 -172
  9. package/extensions/ai-ml/skills/code-sandbox.md +187 -187
  10. package/extensions/ai-ml/skills/deep-research.md +146 -146
  11. package/extensions/ai-ml/skills/embedding-search.md +66 -66
  12. package/extensions/ai-ml/skills/fine-tuning-guide.md +74 -74
  13. package/extensions/ai-ml/skills/llm-architect.md +125 -125
  14. package/extensions/ai-ml/skills/llm-integration.md +64 -64
  15. package/extensions/ai-ml/skills/prompt-patterns.md +72 -72
  16. package/extensions/ai-ml/skills/rag-patterns.md +66 -66
  17. package/extensions/ai-ml/skills/web-extraction.md +114 -114
  18. package/extensions/analytics/PACK.md +92 -92
  19. package/extensions/analytics/skills/ab-testing.md +72 -72
  20. package/extensions/analytics/skills/dashboard-patterns.md +83 -83
  21. package/extensions/analytics/skills/data-validation.md +68 -68
  22. package/extensions/analytics/skills/funnel-analysis.md +81 -81
  23. package/extensions/analytics/skills/sql-patterns.md +57 -57
  24. package/extensions/analytics/skills/statistical-analysis.md +79 -79
  25. package/extensions/analytics/skills/tracking-setup.md +71 -71
  26. package/extensions/backend/PACK.md +104 -104
  27. package/extensions/backend/skills/api-patterns.md +84 -84
  28. package/extensions/backend/skills/async-pipeline.md +193 -193
  29. package/extensions/backend/skills/auth-patterns.md +97 -97
  30. package/extensions/backend/skills/background-jobs.md +133 -133
  31. package/extensions/backend/skills/caching-patterns.md +108 -108
  32. package/extensions/backend/skills/cli-generation.md +133 -133
  33. package/extensions/backend/skills/database-patterns.md +87 -87
  34. package/extensions/backend/skills/middleware-patterns.md +104 -104
  35. package/extensions/chrome-ext/PACK.md +93 -93
  36. package/extensions/chrome-ext/skills/cws-preflight.md +143 -143
  37. package/extensions/chrome-ext/skills/cws-publish.md +104 -104
  38. package/extensions/chrome-ext/skills/ext-ai-integration.md +251 -251
  39. package/extensions/chrome-ext/skills/ext-messaging.md +139 -139
  40. package/extensions/chrome-ext/skills/ext-storage.md +133 -133
  41. package/extensions/chrome-ext/skills/mv3-scaffold.md +164 -164
  42. package/extensions/content/PACK.md +96 -96
  43. package/extensions/content/skills/blog-patterns.md +88 -88
  44. package/extensions/content/skills/cms-integration.md +131 -131
  45. package/extensions/content/skills/content-scoring.md +107 -107
  46. package/extensions/content/skills/i18n.md +83 -83
  47. package/extensions/content/skills/mdx-authoring.md +137 -137
  48. package/extensions/content/skills/reference.md +1014 -1014
  49. package/extensions/content/skills/seo-patterns.md +67 -67
  50. package/extensions/content/skills/video-repurpose.md +153 -153
  51. package/extensions/devops/PACK.md +101 -101
  52. package/extensions/devops/skills/chaos-testing.md +67 -67
  53. package/extensions/devops/skills/ci-cd.md +75 -75
  54. package/extensions/devops/skills/docker.md +58 -58
  55. package/extensions/devops/skills/edge-serverless.md +163 -163
  56. package/extensions/devops/skills/infra-as-code.md +158 -158
  57. package/extensions/devops/skills/kubernetes.md +110 -110
  58. package/extensions/devops/skills/monitoring.md +57 -57
  59. package/extensions/devops/skills/server-setup.md +64 -64
  60. package/extensions/devops/skills/ssl-domain.md +42 -42
  61. package/extensions/ecommerce/PACK.md +116 -116
  62. package/extensions/ecommerce/skills/cart-system.md +79 -79
  63. package/extensions/ecommerce/skills/inventory-mgmt.md +102 -102
  64. package/extensions/ecommerce/skills/order-management.md +126 -126
  65. package/extensions/ecommerce/skills/payment-integration.md +472 -472
  66. package/extensions/ecommerce/skills/shopify-dev.md +69 -69
  67. package/extensions/ecommerce/skills/subscription-billing.md +93 -93
  68. package/extensions/ecommerce/skills/tax-compliance.md +117 -117
  69. package/extensions/gamedev/PACK.md +142 -142
  70. package/extensions/gamedev/skills/asset-pipeline.md +74 -74
  71. package/extensions/gamedev/skills/audio-system.md +129 -129
  72. package/extensions/gamedev/skills/camera-system.md +87 -87
  73. package/extensions/gamedev/skills/ecs.md +98 -98
  74. package/extensions/gamedev/skills/game-loops.md +72 -72
  75. package/extensions/gamedev/skills/input-system.md +199 -199
  76. package/extensions/gamedev/skills/multiplayer.md +180 -180
  77. package/extensions/gamedev/skills/particles.md +105 -105
  78. package/extensions/gamedev/skills/physics-engine.md +89 -89
  79. package/extensions/gamedev/skills/scene-management.md +146 -146
  80. package/extensions/gamedev/skills/threejs-patterns.md +90 -90
  81. package/extensions/gamedev/skills/webgl.md +71 -71
  82. package/extensions/mobile/PACK.md +106 -106
  83. package/extensions/mobile/skills/app-store-connect.md +152 -152
  84. package/extensions/mobile/skills/app-store-prep.md +66 -66
  85. package/extensions/mobile/skills/deep-linking.md +109 -109
  86. package/extensions/mobile/skills/flutter.md +60 -60
  87. package/extensions/mobile/skills/ios-build-pipeline.md +142 -142
  88. package/extensions/mobile/skills/native-bridge.md +66 -66
  89. package/extensions/mobile/skills/ota-updates.md +97 -97
  90. package/extensions/mobile/skills/push-notifications.md +111 -111
  91. package/extensions/mobile/skills/react-native.md +82 -82
  92. package/extensions/saas/PACK.md +116 -116
  93. package/extensions/saas/skills/billing-integration.md +200 -200
  94. package/extensions/saas/skills/feature-flags.md +130 -130
  95. package/extensions/saas/skills/multi-tenant.md +103 -103
  96. package/extensions/saas/skills/onboarding-flow.md +139 -139
  97. package/extensions/saas/skills/subscription-flow.md +95 -95
  98. package/extensions/saas/skills/team-management.md +144 -144
  99. package/extensions/security/PACK.md +99 -99
  100. package/extensions/security/skills/api-security.md +140 -140
  101. package/extensions/security/skills/compliance.md +68 -68
  102. package/extensions/security/skills/owasp-audit.md +64 -64
  103. package/extensions/security/skills/pentest-patterns.md +77 -77
  104. package/extensions/security/skills/secret-mgmt.md +65 -65
  105. package/extensions/security/skills/supply-chain.md +65 -65
  106. package/extensions/trading/PACK.md +80 -80
  107. package/extensions/trading/skills/chart-components.md +55 -55
  108. package/extensions/trading/skills/experiment-loop.md +125 -125
  109. package/extensions/trading/skills/fintech-patterns.md +47 -47
  110. package/extensions/trading/skills/indicator-library.md +58 -58
  111. package/extensions/trading/skills/quant-analysis.md +111 -111
  112. package/extensions/trading/skills/realtime-data.md +58 -58
  113. package/extensions/trading/skills/trade-logic.md +104 -104
  114. package/extensions/ui/PACK.md +130 -130
  115. package/extensions/ui/skills/a11y-audit.md +91 -91
  116. package/extensions/ui/skills/animation-patterns.md +127 -127
  117. package/extensions/ui/skills/component-patterns.md +100 -100
  118. package/extensions/ui/skills/design-decision.md +108 -108
  119. package/extensions/ui/skills/design-system.md +68 -68
  120. package/extensions/ui/skills/landing-patterns.md +155 -155
  121. package/extensions/ui/skills/palette-picker.md +173 -173
  122. package/extensions/ui/skills/react-health.md +90 -90
  123. package/extensions/ui/skills/type-system.md +125 -125
  124. package/extensions/ui/skills/web-vitals.md +153 -153
  125. package/extensions/zalo/PACK.md +145 -145
  126. package/extensions/zalo/skills/zalo-oa-mcp.md +317 -317
  127. package/extensions/zalo/skills/zalo-oa-messaging.md +429 -429
  128. package/extensions/zalo/skills/zalo-oa-setup.md +236 -236
  129. package/extensions/zalo/skills/zalo-oa-webhook.md +189 -189
  130. package/extensions/zalo/skills/zalo-personal-messaging.md +194 -194
  131. package/extensions/zalo/skills/zalo-personal-setup.md +153 -153
  132. package/extensions/zalo/skills/zalo-rate-guard.md +219 -219
  133. package/hooks/auto-format/index.cjs +48 -48
  134. package/hooks/hooks.json +111 -111
  135. package/hooks/post-session-reflect/index.cjs +189 -189
  136. package/hooks/pre-compact/index.cjs +95 -95
  137. package/hooks/run-hook.cmd +1 -1
  138. package/hooks/secrets-scan/index.cjs +100 -100
  139. package/hooks/session-start/index.cjs +71 -71
  140. package/hooks/typecheck/index.cjs +65 -65
  141. package/package.json +63 -63
  142. package/references/ui-pro-max-data/LICENSE-UI-PRO-MAX +21 -21
  143. package/references/ui-pro-max-data/charts.csv +26 -26
  144. package/references/ui-pro-max-data/colors.csv +161 -161
  145. package/references/ui-pro-max-data/styles.csv +68 -68
  146. package/references/ui-pro-max-data/typography.csv +74 -74
  147. package/references/ui-pro-max-data/ui-reasoning.csv +162 -162
  148. package/references/ui-pro-max-data/ux-guidelines.csv +99 -99
  149. package/skills/adversary/SKILL.md +283 -283
  150. package/skills/asset-creator/SKILL.md +157 -157
  151. package/skills/audit/SKILL.md +147 -2
  152. package/skills/autopsy/SKILL.md +335 -335
  153. package/skills/brainstorm/SKILL.md +342 -342
  154. package/skills/browser-pilot/SKILL.md +168 -168
  155. package/skills/constraint-check/SKILL.md +165 -165
  156. package/skills/context-engine/SKILL.md +404 -404
  157. package/skills/cook/SKILL.md +917 -863
  158. package/skills/db/SKILL.md +273 -273
  159. package/skills/debug/SKILL.md +465 -465
  160. package/skills/dependency-doctor/SKILL.md +265 -235
  161. package/skills/deploy/SKILL.md +274 -231
  162. package/skills/design/DESIGN-REFERENCE.md +365 -365
  163. package/skills/design/SKILL.md +589 -589
  164. package/skills/doc-processor/SKILL.md +254 -254
  165. package/skills/docs/SKILL.md +374 -374
  166. package/skills/docs-seeker/SKILL.md +177 -177
  167. package/skills/fix/SKILL.md +330 -330
  168. package/skills/git/SKILL.md +339 -339
  169. package/skills/hallucination-guard/SKILL.md +219 -219
  170. package/skills/incident/SKILL.md +254 -253
  171. package/skills/integrity-check/SKILL.md +169 -169
  172. package/skills/journal/SKILL.md +240 -240
  173. package/skills/launch/SKILL.md +344 -344
  174. package/skills/logic-guardian/SKILL.md +251 -251
  175. package/skills/marketing/SKILL.md +290 -289
  176. package/skills/mcp-builder/SKILL.md +425 -425
  177. package/skills/neural-memory/SKILL.md +362 -362
  178. package/skills/onboard/SKILL.md +404 -403
  179. package/skills/perf/SKILL.md +346 -346
  180. package/skills/plan/SKILL.md +433 -428
  181. package/skills/preflight/SKILL.md +415 -415
  182. package/skills/problem-solver/SKILL.md +380 -284
  183. package/skills/rescue/SKILL.md +474 -474
  184. package/skills/retro/SKILL.md +3 -1
  185. package/skills/review/SKILL.md +612 -588
  186. package/skills/review-intake/SKILL.md +249 -249
  187. package/skills/safeguard/SKILL.md +200 -200
  188. package/skills/sast/SKILL.md +190 -190
  189. package/skills/scaffold/SKILL.md +328 -287
  190. package/skills/scope-guard/SKILL.md +180 -180
  191. package/skills/scout/SKILL.md +263 -263
  192. package/skills/sentinel/SKILL.md +382 -381
  193. package/skills/sentinel-env/SKILL.md +254 -254
  194. package/skills/sequential-thinking/SKILL.md +234 -234
  195. package/skills/session-bridge/SKILL.md +543 -543
  196. package/skills/skill-forge/SKILL.md +581 -581
  197. package/skills/skill-router/SKILL.md +3 -0
  198. package/skills/surgeon/SKILL.md +215 -215
  199. package/skills/team/SKILL.md +556 -537
  200. package/skills/test/SKILL.md +614 -614
  201. package/skills/trend-scout/SKILL.md +145 -145
  202. package/skills/verification/SKILL.md +326 -326
  203. package/skills/video-creator/SKILL.md +201 -201
  204. package/skills/watchdog/SKILL.md +168 -168
  205. package/skills/worktree/SKILL.md +140 -140
@@ -1,81 +1,81 @@
1
- ---
2
- name: "funnel-analysis"
3
- pack: "@rune/analytics"
4
- description: "Funnel analysis — conversion tracking, drop-off identification, cohort analysis, retention metrics, LTV calculation, attribution modeling."
5
- model: sonnet
6
- tools: [Read, Edit, Write, Grep, Glob, Bash]
7
- ---
8
-
9
- # funnel-analysis
10
-
11
- Funnel analysis — conversion tracking, drop-off identification, cohort analysis, retention metrics, LTV calculation, attribution modeling.
12
-
13
- #### Workflow
14
-
15
- **Step 1 — Detect funnel tracking**
16
- Use Grep to find funnel-related code: `funnel`, `conversion`, `step`, `checkout.*step`, `onboarding.*step`, `cohort`, `retention`. Read event tracking calls to understand: which user journey steps are tracked, how step completion is determined, and where drop-off data is collected.
17
-
18
- **Step 2 — Audit funnel completeness**
19
- Check for: missing steps in the funnel (gap between "add to cart" and "payment complete" — no "checkout started"), step events not including a session or flow ID (can't link steps to same journey), no timestamp on steps (can't measure time between steps), no segmentation on funnel data (can't compare mobile vs desktop conversion), and no drop-off alerting.
20
-
21
- **Step 3 — Emit funnel patterns**
22
- Emit: typed funnel step tracker with flow ID, funnel aggregation query (SQL), drop-off rate calculator, cohort retention matrix, and simple LTV estimation.
23
-
24
- #### Example
25
-
26
- ```typescript
27
- // Funnel step tracker with flow correlation
28
- interface FunnelStep {
29
- funnelId: string;
30
- flowId: string; // ties steps to same user journey
31
- step: string;
32
- stepIndex: number;
33
- userId: string;
34
- timestamp: number;
35
- metadata?: Record<string, string | number>;
36
- }
37
-
38
- const CHECKOUT_FUNNEL = ['cart_viewed', 'checkout_started', 'shipping_entered', 'payment_entered', 'order_completed'] as const;
39
-
40
- function trackFunnelStep(step: typeof CHECKOUT_FUNNEL[number], flowId: string, meta?: Record<string, string | number>) {
41
- const event: FunnelStep = {
42
- funnelId: 'checkout',
43
- flowId,
44
- step,
45
- stepIndex: CHECKOUT_FUNNEL.indexOf(step),
46
- userId: getCurrentUserId(),
47
- timestamp: Date.now(),
48
- metadata: meta,
49
- };
50
- analytics.track({ name: 'funnel_step', properties: event });
51
- }
52
-
53
- // SQL — funnel drop-off analysis (PostgreSQL)
54
- // SELECT step, COUNT(DISTINCT flow_id) as users,
55
- // LAG(COUNT(DISTINCT flow_id)) OVER (ORDER BY step_index) as prev_users,
56
- // ROUND(COUNT(DISTINCT flow_id)::numeric /
57
- // LAG(COUNT(DISTINCT flow_id)) OVER (ORDER BY step_index) * 100, 1) as conversion_pct
58
- // FROM funnel_events
59
- // WHERE funnel_id = 'checkout' AND timestamp > NOW() - INTERVAL '30 days'
60
- // GROUP BY step, step_index ORDER BY step_index;
61
-
62
- // Cohort retention matrix
63
- async function cohortRetention(cohortField: string, periods: number) {
64
- return db.execute(sql`
65
- WITH cohorts AS (
66
- SELECT user_id, DATE_TRUNC('week', MIN(created_at)) AS cohort_week
67
- FROM events WHERE name = 'signup_completed'
68
- GROUP BY user_id
69
- ),
70
- activity AS (
71
- SELECT user_id, DATE_TRUNC('week', timestamp) AS active_week
72
- FROM events GROUP BY user_id, DATE_TRUNC('week', timestamp)
73
- )
74
- SELECT c.cohort_week, EXTRACT(WEEK FROM a.active_week - c.cohort_week) AS week_number,
75
- COUNT(DISTINCT a.user_id) AS active_users
76
- FROM cohorts c JOIN activity a ON c.user_id = a.user_id
77
- WHERE a.active_week >= c.cohort_week
78
- GROUP BY c.cohort_week, week_number ORDER BY c.cohort_week, week_number
79
- `);
80
- }
81
- ```
1
+ ---
2
+ name: "funnel-analysis"
3
+ pack: "@rune/analytics"
4
+ description: "Funnel analysis — conversion tracking, drop-off identification, cohort analysis, retention metrics, LTV calculation, attribution modeling."
5
+ model: sonnet
6
+ tools: [Read, Edit, Write, Grep, Glob, Bash]
7
+ ---
8
+
9
+ # funnel-analysis
10
+
11
+ Funnel analysis — conversion tracking, drop-off identification, cohort analysis, retention metrics, LTV calculation, attribution modeling.
12
+
13
+ #### Workflow
14
+
15
+ **Step 1 — Detect funnel tracking**
16
+ Use Grep to find funnel-related code: `funnel`, `conversion`, `step`, `checkout.*step`, `onboarding.*step`, `cohort`, `retention`. Read event tracking calls to understand: which user journey steps are tracked, how step completion is determined, and where drop-off data is collected.
17
+
18
+ **Step 2 — Audit funnel completeness**
19
+ Check for: missing steps in the funnel (gap between "add to cart" and "payment complete" — no "checkout started"), step events not including a session or flow ID (can't link steps to same journey), no timestamp on steps (can't measure time between steps), no segmentation on funnel data (can't compare mobile vs desktop conversion), and no drop-off alerting.
20
+
21
+ **Step 3 — Emit funnel patterns**
22
+ Emit: typed funnel step tracker with flow ID, funnel aggregation query (SQL), drop-off rate calculator, cohort retention matrix, and simple LTV estimation.
23
+
24
+ #### Example
25
+
26
+ ```typescript
27
+ // Funnel step tracker with flow correlation
28
+ interface FunnelStep {
29
+ funnelId: string;
30
+ flowId: string; // ties steps to same user journey
31
+ step: string;
32
+ stepIndex: number;
33
+ userId: string;
34
+ timestamp: number;
35
+ metadata?: Record<string, string | number>;
36
+ }
37
+
38
+ const CHECKOUT_FUNNEL = ['cart_viewed', 'checkout_started', 'shipping_entered', 'payment_entered', 'order_completed'] as const;
39
+
40
+ function trackFunnelStep(step: typeof CHECKOUT_FUNNEL[number], flowId: string, meta?: Record<string, string | number>) {
41
+ const event: FunnelStep = {
42
+ funnelId: 'checkout',
43
+ flowId,
44
+ step,
45
+ stepIndex: CHECKOUT_FUNNEL.indexOf(step),
46
+ userId: getCurrentUserId(),
47
+ timestamp: Date.now(),
48
+ metadata: meta,
49
+ };
50
+ analytics.track({ name: 'funnel_step', properties: event });
51
+ }
52
+
53
+ // SQL — funnel drop-off analysis (PostgreSQL)
54
+ // SELECT step, COUNT(DISTINCT flow_id) as users,
55
+ // LAG(COUNT(DISTINCT flow_id)) OVER (ORDER BY step_index) as prev_users,
56
+ // ROUND(COUNT(DISTINCT flow_id)::numeric /
57
+ // LAG(COUNT(DISTINCT flow_id)) OVER (ORDER BY step_index) * 100, 1) as conversion_pct
58
+ // FROM funnel_events
59
+ // WHERE funnel_id = 'checkout' AND timestamp > NOW() - INTERVAL '30 days'
60
+ // GROUP BY step, step_index ORDER BY step_index;
61
+
62
+ // Cohort retention matrix
63
+ async function cohortRetention(cohortField: string, periods: number) {
64
+ return db.execute(sql`
65
+ WITH cohorts AS (
66
+ SELECT user_id, DATE_TRUNC('week', MIN(created_at)) AS cohort_week
67
+ FROM events WHERE name = 'signup_completed'
68
+ GROUP BY user_id
69
+ ),
70
+ activity AS (
71
+ SELECT user_id, DATE_TRUNC('week', timestamp) AS active_week
72
+ FROM events GROUP BY user_id, DATE_TRUNC('week', timestamp)
73
+ )
74
+ SELECT c.cohort_week, EXTRACT(WEEK FROM a.active_week - c.cohort_week) AS week_number,
75
+ COUNT(DISTINCT a.user_id) AS active_users
76
+ FROM cohorts c JOIN activity a ON c.user_id = a.user_id
77
+ WHERE a.active_week >= c.cohort_week
78
+ GROUP BY c.cohort_week, week_number ORDER BY c.cohort_week, week_number
79
+ `);
80
+ }
81
+ ```
@@ -1,57 +1,57 @@
1
- ---
2
- name: "sql-patterns"
3
- pack: "@rune/analytics"
4
- description: "SQL query patterns for analytics — common aggregations, window functions, CTEs, performance optimization, and safe parameterized queries for analytics workloads."
5
- model: sonnet
6
- tools: [Read, Edit, Write, Grep, Glob, Bash]
7
- ---
8
-
9
- # sql-patterns
10
-
11
- SQL query patterns for analytics — common aggregations, window functions, CTEs, performance optimization, and safe parameterized queries for analytics workloads.
12
-
13
- #### Workflow
14
-
15
- **Step 1 — Detect database setup**
16
- Use Grep to find database usage: `prisma`, `drizzle`, `knex`, `pg`, `mysql2`, `better-sqlite3`, `sql`, `SELECT`, `INSERT`. Identify: ORM vs raw SQL, database engine (PostgreSQL, MySQL, SQLite), migration tool, and query builder.
17
-
18
- **Step 2 — Audit query quality**
19
- Check for: string interpolation in SQL (injection risk), missing indexes on columns used in WHERE/JOIN/ORDER BY, N+1 queries in loops, SELECT * instead of specific columns, no pagination on large result sets, aggregations done client-side instead of database, and missing EXPLAIN ANALYZE on slow queries.
20
-
21
- **Step 3 — Emit SQL patterns**
22
- Emit patterns appropriate to the detected database engine.
23
-
24
- #### Example
25
-
26
- ```sql
27
- -- Time-bucketed metrics (PostgreSQL)
28
- -- Use DATE_TRUNC for consistent time buckets
29
- SELECT
30
- DATE_TRUNC('hour', created_at) AS bucket,
31
- COUNT(*) AS total_events,
32
- COUNT(DISTINCT user_id) AS unique_users,
33
- PERCENTILE_CONT(0.95) WITHIN GROUP (ORDER BY response_ms) AS p95_latency
34
- FROM events
35
- WHERE created_at > NOW() - INTERVAL '24 hours'
36
- GROUP BY bucket
37
- ORDER BY bucket;
38
-
39
- -- Running totals with window functions
40
- SELECT date, daily_revenue,
41
- SUM(daily_revenue) OVER (ORDER BY date ROWS UNBOUNDED PRECEDING) AS cumulative_revenue,
42
- AVG(daily_revenue) OVER (ORDER BY date ROWS 6 PRECEDING) AS rolling_7d_avg
43
- FROM daily_metrics;
44
-
45
- -- Efficient pagination (keyset, not OFFSET)
46
- -- BAD: SELECT * FROM events ORDER BY id LIMIT 20 OFFSET 10000;
47
- -- GOOD: cursor-based
48
- SELECT * FROM events
49
- WHERE id > $1 -- last seen ID
50
- ORDER BY id
51
- LIMIT 20;
52
-
53
- -- Safe parameterized queries (NEVER string interpolation)
54
- -- BAD: `SELECT * FROM users WHERE id = ${userId}`
55
- -- GOOD: prepared statement
56
- const result = await db.query('SELECT * FROM users WHERE id = $1', [userId]);
57
- ```
1
+ ---
2
+ name: "sql-patterns"
3
+ pack: "@rune/analytics"
4
+ description: "SQL query patterns for analytics — common aggregations, window functions, CTEs, performance optimization, and safe parameterized queries for analytics workloads."
5
+ model: sonnet
6
+ tools: [Read, Edit, Write, Grep, Glob, Bash]
7
+ ---
8
+
9
+ # sql-patterns
10
+
11
+ SQL query patterns for analytics — common aggregations, window functions, CTEs, performance optimization, and safe parameterized queries for analytics workloads.
12
+
13
+ #### Workflow
14
+
15
+ **Step 1 — Detect database setup**
16
+ Use Grep to find database usage: `prisma`, `drizzle`, `knex`, `pg`, `mysql2`, `better-sqlite3`, `sql`, `SELECT`, `INSERT`. Identify: ORM vs raw SQL, database engine (PostgreSQL, MySQL, SQLite), migration tool, and query builder.
17
+
18
+ **Step 2 — Audit query quality**
19
+ Check for: string interpolation in SQL (injection risk), missing indexes on columns used in WHERE/JOIN/ORDER BY, N+1 queries in loops, SELECT * instead of specific columns, no pagination on large result sets, aggregations done client-side instead of database, and missing EXPLAIN ANALYZE on slow queries.
20
+
21
+ **Step 3 — Emit SQL patterns**
22
+ Emit patterns appropriate to the detected database engine.
23
+
24
+ #### Example
25
+
26
+ ```sql
27
+ -- Time-bucketed metrics (PostgreSQL)
28
+ -- Use DATE_TRUNC for consistent time buckets
29
+ SELECT
30
+ DATE_TRUNC('hour', created_at) AS bucket,
31
+ COUNT(*) AS total_events,
32
+ COUNT(DISTINCT user_id) AS unique_users,
33
+ PERCENTILE_CONT(0.95) WITHIN GROUP (ORDER BY response_ms) AS p95_latency
34
+ FROM events
35
+ WHERE created_at > NOW() - INTERVAL '24 hours'
36
+ GROUP BY bucket
37
+ ORDER BY bucket;
38
+
39
+ -- Running totals with window functions
40
+ SELECT date, daily_revenue,
41
+ SUM(daily_revenue) OVER (ORDER BY date ROWS UNBOUNDED PRECEDING) AS cumulative_revenue,
42
+ AVG(daily_revenue) OVER (ORDER BY date ROWS 6 PRECEDING) AS rolling_7d_avg
43
+ FROM daily_metrics;
44
+
45
+ -- Efficient pagination (keyset, not OFFSET)
46
+ -- BAD: SELECT * FROM events ORDER BY id LIMIT 20 OFFSET 10000;
47
+ -- GOOD: cursor-based
48
+ SELECT * FROM events
49
+ WHERE id > $1 -- last seen ID
50
+ ORDER BY id
51
+ LIMIT 20;
52
+
53
+ -- Safe parameterized queries (NEVER string interpolation)
54
+ -- BAD: `SELECT * FROM users WHERE id = ${userId}`
55
+ -- GOOD: prepared statement
56
+ const result = await db.query('SELECT * FROM users WHERE id = $1', [userId]);
57
+ ```
@@ -1,79 +1,79 @@
1
- ---
2
- name: "statistical-analysis"
3
- pack: "@rune/analytics"
4
- description: "Statistical analysis patterns — significance testing, regression basics, distribution analysis, and correlation detection for product metrics."
5
- model: sonnet
6
- tools: [Read, Edit, Write, Grep, Glob, Bash]
7
- ---
8
-
9
- # statistical-analysis
10
-
11
- Statistical analysis patterns — significance testing, regression basics, distribution analysis, and correlation detection for product metrics.
12
-
13
- #### Workflow
14
-
15
- **Step 1 — Identify analysis need**
16
- Determine what type of analysis is needed: comparing two groups (A/B test significance), finding relationships (correlation), predicting values (regression), understanding distribution (histogram, percentiles), or detecting trends (time series decomposition).
17
-
18
- **Step 2 — Select method**
19
-
20
- | Question | Method | When to use |
21
- |----------|--------|-------------|
22
- | "Is A different from B?" | Two-sample t-test or Chi-square | Comparing conversion rates, revenue per user |
23
- | "Are these correlated?" | Pearson/Spearman correlation | Feature usage vs retention, price vs conversion |
24
- | "What predicts Y?" | Linear/logistic regression | Churn prediction, revenue forecasting |
25
- | "What's the distribution?" | Histogram + percentiles | Response times, order values, session lengths |
26
- | "Is this trend real?" | Mann-Kendall or linear regression on time | Month-over-month growth, seasonal patterns |
27
-
28
- **Step 3 — Emit analysis patterns**
29
-
30
- #### Example
31
-
32
- ```typescript
33
- // Chi-square significance test for A/B conversion rates
34
- function chiSquareTest(
35
- controlConversions: number, controlTotal: number,
36
- treatmentConversions: number, treatmentTotal: number
37
- ): { chiSquare: number; pValue: number; significant: boolean } {
38
- const controlRate = controlConversions / controlTotal;
39
- const treatmentRate = treatmentConversions / treatmentTotal;
40
- const pooledRate = (controlConversions + treatmentConversions) / (controlTotal + treatmentTotal);
41
-
42
- const expected = [
43
- [controlTotal * pooledRate, controlTotal * (1 - pooledRate)],
44
- [treatmentTotal * pooledRate, treatmentTotal * (1 - pooledRate)],
45
- ];
46
- const observed = [
47
- [controlConversions, controlTotal - controlConversions],
48
- [treatmentConversions, treatmentTotal - treatmentConversions],
49
- ];
50
-
51
- let chiSq = 0;
52
- for (let i = 0; i < 2; i++) {
53
- for (let j = 0; j < 2; j++) {
54
- chiSq += Math.pow(observed[i][j] - expected[i][j], 2) / expected[i][j];
55
- }
56
- }
57
-
58
- // p-value approximation for 1 degree of freedom
59
- const pValue = 1 - normalCDF(Math.sqrt(chiSq));
60
- return { chiSquare: chiSq, pValue, significant: pValue < 0.05 };
61
- }
62
-
63
- // Percentile calculation (for response time analysis, order values, etc.)
64
- function percentiles(values: number[], points: number[] = [50, 75, 90, 95, 99]): Record<string, number> {
65
- const sorted = [...values].sort((a, b) => a - b);
66
- return Object.fromEntries(
67
- points.map(p => [`p${p}`, sorted[Math.ceil((p / 100) * sorted.length) - 1]])
68
- );
69
- }
70
-
71
- // SQL — Correlation between two metrics (PostgreSQL)
72
- // SELECT CORR(feature_usage_count, retention_days) AS correlation,
73
- // CASE
74
- // WHEN ABS(CORR(feature_usage_count, retention_days)) > 0.7 THEN 'strong'
75
- // WHEN ABS(CORR(feature_usage_count, retention_days)) > 0.4 THEN 'moderate'
76
- // ELSE 'weak'
77
- // END AS strength
78
- // FROM user_metrics;
79
- ```
1
+ ---
2
+ name: "statistical-analysis"
3
+ pack: "@rune/analytics"
4
+ description: "Statistical analysis patterns — significance testing, regression basics, distribution analysis, and correlation detection for product metrics."
5
+ model: sonnet
6
+ tools: [Read, Edit, Write, Grep, Glob, Bash]
7
+ ---
8
+
9
+ # statistical-analysis
10
+
11
+ Statistical analysis patterns — significance testing, regression basics, distribution analysis, and correlation detection for product metrics.
12
+
13
+ #### Workflow
14
+
15
+ **Step 1 — Identify analysis need**
16
+ Determine what type of analysis is needed: comparing two groups (A/B test significance), finding relationships (correlation), predicting values (regression), understanding distribution (histogram, percentiles), or detecting trends (time series decomposition).
17
+
18
+ **Step 2 — Select method**
19
+
20
+ | Question | Method | When to use |
21
+ |----------|--------|-------------|
22
+ | "Is A different from B?" | Two-sample t-test or Chi-square | Comparing conversion rates, revenue per user |
23
+ | "Are these correlated?" | Pearson/Spearman correlation | Feature usage vs retention, price vs conversion |
24
+ | "What predicts Y?" | Linear/logistic regression | Churn prediction, revenue forecasting |
25
+ | "What's the distribution?" | Histogram + percentiles | Response times, order values, session lengths |
26
+ | "Is this trend real?" | Mann-Kendall or linear regression on time | Month-over-month growth, seasonal patterns |
27
+
28
+ **Step 3 — Emit analysis patterns**
29
+
30
+ #### Example
31
+
32
+ ```typescript
33
+ // Chi-square significance test for A/B conversion rates
34
+ function chiSquareTest(
35
+ controlConversions: number, controlTotal: number,
36
+ treatmentConversions: number, treatmentTotal: number
37
+ ): { chiSquare: number; pValue: number; significant: boolean } {
38
+ const controlRate = controlConversions / controlTotal;
39
+ const treatmentRate = treatmentConversions / treatmentTotal;
40
+ const pooledRate = (controlConversions + treatmentConversions) / (controlTotal + treatmentTotal);
41
+
42
+ const expected = [
43
+ [controlTotal * pooledRate, controlTotal * (1 - pooledRate)],
44
+ [treatmentTotal * pooledRate, treatmentTotal * (1 - pooledRate)],
45
+ ];
46
+ const observed = [
47
+ [controlConversions, controlTotal - controlConversions],
48
+ [treatmentConversions, treatmentTotal - treatmentConversions],
49
+ ];
50
+
51
+ let chiSq = 0;
52
+ for (let i = 0; i < 2; i++) {
53
+ for (let j = 0; j < 2; j++) {
54
+ chiSq += Math.pow(observed[i][j] - expected[i][j], 2) / expected[i][j];
55
+ }
56
+ }
57
+
58
+ // p-value approximation for 1 degree of freedom
59
+ const pValue = 1 - normalCDF(Math.sqrt(chiSq));
60
+ return { chiSquare: chiSq, pValue, significant: pValue < 0.05 };
61
+ }
62
+
63
+ // Percentile calculation (for response time analysis, order values, etc.)
64
+ function percentiles(values: number[], points: number[] = [50, 75, 90, 95, 99]): Record<string, number> {
65
+ const sorted = [...values].sort((a, b) => a - b);
66
+ return Object.fromEntries(
67
+ points.map(p => [`p${p}`, sorted[Math.ceil((p / 100) * sorted.length) - 1]])
68
+ );
69
+ }
70
+
71
+ // SQL — Correlation between two metrics (PostgreSQL)
72
+ // SELECT CORR(feature_usage_count, retention_days) AS correlation,
73
+ // CASE
74
+ // WHEN ABS(CORR(feature_usage_count, retention_days)) > 0.7 THEN 'strong'
75
+ // WHEN ABS(CORR(feature_usage_count, retention_days)) > 0.4 THEN 'moderate'
76
+ // ELSE 'weak'
77
+ // END AS strength
78
+ // FROM user_metrics;
79
+ ```
@@ -1,71 +1,71 @@
1
- ---
2
- name: "tracking-setup"
3
- pack: "@rune/analytics"
4
- description: "Analytics tracking — Google Analytics 4, Plausible, PostHog, Mixpanel. Event taxonomy design, consent management, server-side tracking, UTM handling."
5
- model: sonnet
6
- tools: [Read, Edit, Write, Grep, Glob, Bash]
7
- ---
8
-
9
- # tracking-setup
10
-
11
- Analytics tracking — Google Analytics 4, Plausible, PostHog, Mixpanel. Event taxonomy design, consent management, server-side tracking, UTM handling.
12
-
13
- #### Workflow
14
-
15
- **Step 1 — Detect tracking setup**
16
- Use Grep to find analytics code: `gtag`, `posthog.capture`, `mixpanel.track`, `plausible`, `analytics.track`, `useAnalytics`. Read the tracking initialization and event calls to understand: analytics provider, event naming convention, consent flow, and client vs server-side tracking.
17
-
18
- **Step 2 — Audit tracking quality**
19
- Check for: inconsistent event naming (mix of `snake_case`, `camelCase`, `kebab-case`), missing consent management (GDPR violation), tracking scripts blocking page load (performance impact), no event taxonomy document (ad-hoc event names), UTM parameters not captured on landing, user identification happening before consent, and no server-side tracking fallback (ad blockers lose 30-40% of events).
20
-
21
- **Step 3 — Emit tracking patterns**
22
- Emit: typed event taxonomy with auto-complete, consent-aware analytics wrapper, server-side event proxy for ad-blocker resistance, UTM capture and persistence utility, and page view tracking with proper SPA handling.
23
-
24
- #### Example
25
-
26
- ```typescript
27
- // Type-safe analytics wrapper with consent management
28
- type AnalyticsEvent =
29
- | { name: 'page_view'; properties: { path: string; referrer: string } }
30
- | { name: 'signup_started'; properties: { method: 'email' | 'google' | 'github' } }
31
- | { name: 'feature_used'; properties: { feature: string; plan: string } }
32
- | { name: 'checkout_started'; properties: { plan: string; billing: 'monthly' | 'annual' } }
33
- | { name: 'checkout_completed'; properties: { plan: string; revenue: number; currency: string } };
34
-
35
- class Analytics {
36
- private consent: 'granted' | 'denied' | 'pending' = 'pending';
37
- private queue: AnalyticsEvent[] = [];
38
-
39
- updateConsent(status: 'granted' | 'denied') {
40
- this.consent = status;
41
- if (status === 'granted') {
42
- this.queue.forEach(e => this.send(e));
43
- this.queue = [];
44
- } else {
45
- this.queue = [];
46
- }
47
- }
48
-
49
- track<E extends AnalyticsEvent>(event: E) {
50
- if (this.consent === 'denied') return;
51
- if (this.consent === 'pending') { this.queue.push(event); return; }
52
- this.send(event);
53
- }
54
-
55
- private send(event: AnalyticsEvent) {
56
- // Client-side (may be blocked)
57
- window.gtag?.('event', event.name, event.properties);
58
- // Server-side fallback (ad-blocker resistant)
59
- navigator.sendBeacon('/api/analytics', JSON.stringify(event));
60
- }
61
- }
62
-
63
- // UTM capture — run on landing page
64
- function captureUtm() {
65
- const params = new URLSearchParams(window.location.search);
66
- const utmKeys = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content'];
67
- const utm: Record<string, string> = {};
68
- utmKeys.forEach(key => { if (params.has(key)) utm[key] = params.get(key)!; });
69
- if (Object.keys(utm).length) sessionStorage.setItem('utm', JSON.stringify(utm));
70
- }
71
- ```
1
+ ---
2
+ name: "tracking-setup"
3
+ pack: "@rune/analytics"
4
+ description: "Analytics tracking — Google Analytics 4, Plausible, PostHog, Mixpanel. Event taxonomy design, consent management, server-side tracking, UTM handling."
5
+ model: sonnet
6
+ tools: [Read, Edit, Write, Grep, Glob, Bash]
7
+ ---
8
+
9
+ # tracking-setup
10
+
11
+ Analytics tracking — Google Analytics 4, Plausible, PostHog, Mixpanel. Event taxonomy design, consent management, server-side tracking, UTM handling.
12
+
13
+ #### Workflow
14
+
15
+ **Step 1 — Detect tracking setup**
16
+ Use Grep to find analytics code: `gtag`, `posthog.capture`, `mixpanel.track`, `plausible`, `analytics.track`, `useAnalytics`. Read the tracking initialization and event calls to understand: analytics provider, event naming convention, consent flow, and client vs server-side tracking.
17
+
18
+ **Step 2 — Audit tracking quality**
19
+ Check for: inconsistent event naming (mix of `snake_case`, `camelCase`, `kebab-case`), missing consent management (GDPR violation), tracking scripts blocking page load (performance impact), no event taxonomy document (ad-hoc event names), UTM parameters not captured on landing, user identification happening before consent, and no server-side tracking fallback (ad blockers lose 30-40% of events).
20
+
21
+ **Step 3 — Emit tracking patterns**
22
+ Emit: typed event taxonomy with auto-complete, consent-aware analytics wrapper, server-side event proxy for ad-blocker resistance, UTM capture and persistence utility, and page view tracking with proper SPA handling.
23
+
24
+ #### Example
25
+
26
+ ```typescript
27
+ // Type-safe analytics wrapper with consent management
28
+ type AnalyticsEvent =
29
+ | { name: 'page_view'; properties: { path: string; referrer: string } }
30
+ | { name: 'signup_started'; properties: { method: 'email' | 'google' | 'github' } }
31
+ | { name: 'feature_used'; properties: { feature: string; plan: string } }
32
+ | { name: 'checkout_started'; properties: { plan: string; billing: 'monthly' | 'annual' } }
33
+ | { name: 'checkout_completed'; properties: { plan: string; revenue: number; currency: string } };
34
+
35
+ class Analytics {
36
+ private consent: 'granted' | 'denied' | 'pending' = 'pending';
37
+ private queue: AnalyticsEvent[] = [];
38
+
39
+ updateConsent(status: 'granted' | 'denied') {
40
+ this.consent = status;
41
+ if (status === 'granted') {
42
+ this.queue.forEach(e => this.send(e));
43
+ this.queue = [];
44
+ } else {
45
+ this.queue = [];
46
+ }
47
+ }
48
+
49
+ track<E extends AnalyticsEvent>(event: E) {
50
+ if (this.consent === 'denied') return;
51
+ if (this.consent === 'pending') { this.queue.push(event); return; }
52
+ this.send(event);
53
+ }
54
+
55
+ private send(event: AnalyticsEvent) {
56
+ // Client-side (may be blocked)
57
+ window.gtag?.('event', event.name, event.properties);
58
+ // Server-side fallback (ad-blocker resistant)
59
+ navigator.sendBeacon('/api/analytics', JSON.stringify(event));
60
+ }
61
+ }
62
+
63
+ // UTM capture — run on landing page
64
+ function captureUtm() {
65
+ const params = new URLSearchParams(window.location.search);
66
+ const utmKeys = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content'];
67
+ const utm: Record<string, string> = {};
68
+ utmKeys.forEach(key => { if (params.has(key)) utm[key] = params.get(key)!; });
69
+ if (Object.keys(utm).length) sessionStorage.setItem('utm', JSON.stringify(utm));
70
+ }
71
+ ```