agy-superpowers 5.2.2 → 5.2.3

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 (220) hide show
  1. package/README.md +47 -150
  2. package/package.json +1 -1
  3. package/template/agent/rules/scratch-scripts.md +37 -0
  4. package/template/agent/rules/superpowers.md +4 -51
  5. package/template/agent/skills/ai-integrated-product/SKILL.md +0 -57
  6. package/template/agent/skills/analytics-setup/SKILL.md +0 -51
  7. package/template/agent/skills/api-design/SKILL.md +0 -193
  8. package/template/agent/skills/app-store-optimizer/SKILL.md +0 -127
  9. package/template/agent/skills/auth-and-identity/SKILL.md +0 -167
  10. package/template/agent/skills/backend-developer/SKILL.md +0 -148
  11. package/template/agent/skills/bootstrapper-finance/SKILL.md +0 -55
  12. package/template/agent/skills/chrome-extension-developer/SKILL.md +0 -53
  13. package/template/agent/skills/community-manager/SKILL.md +0 -115
  14. package/template/agent/skills/content-marketer/SKILL.md +0 -111
  15. package/template/agent/skills/conversion-optimizer/SKILL.md +0 -142
  16. package/template/agent/skills/cto-architect/SKILL.md +0 -133
  17. package/template/agent/skills/customer-success-manager/SKILL.md +0 -126
  18. package/template/agent/skills/data-analyst/SKILL.md +0 -147
  19. package/template/agent/skills/devops-engineer/SKILL.md +0 -117
  20. package/template/agent/skills/email-infrastructure/SKILL.md +0 -164
  21. package/template/agent/skills/game-design/SKILL.md +0 -194
  22. package/template/agent/skills/game-developer/SKILL.md +0 -175
  23. package/template/agent/skills/growth-hacker/SKILL.md +0 -122
  24. package/template/agent/skills/idea-validator/SKILL.md +0 -55
  25. package/template/agent/skills/indie-legal/SKILL.md +0 -53
  26. package/template/agent/skills/influencer-marketer/SKILL.md +0 -141
  27. package/template/agent/skills/landing-page-builder/SKILL.md +0 -59
  28. package/template/agent/skills/launch-strategist/SKILL.md +0 -62
  29. package/template/agent/skills/market-researcher/SKILL.md +0 -53
  30. package/template/agent/skills/micro-saas-builder/SKILL.md +0 -56
  31. package/template/agent/skills/monetization-strategist/SKILL.md +0 -119
  32. package/template/agent/skills/paid-acquisition-specialist/SKILL.md +0 -119
  33. package/template/agent/skills/pricing-psychologist/SKILL.md +0 -58
  34. package/template/agent/skills/real-time-features/SKILL.md +0 -194
  35. package/template/agent/skills/retention-specialist/SKILL.md +0 -123
  36. package/template/agent/skills/rust-developer/SKILL.md +0 -281
  37. package/template/agent/skills/rust-developer/references/rust-rules/_sections.md +0 -231
  38. package/template/agent/skills/rust-developer/references/rust-rules/anti-clone-excessive.md +0 -124
  39. package/template/agent/skills/rust-developer/references/rust-rules/anti-collect-intermediate.md +0 -131
  40. package/template/agent/skills/rust-developer/references/rust-rules/anti-empty-catch.md +0 -132
  41. package/template/agent/skills/rust-developer/references/rust-rules/anti-expect-lazy.md +0 -95
  42. package/template/agent/skills/rust-developer/references/rust-rules/anti-format-hot-path.md +0 -141
  43. package/template/agent/skills/rust-developer/references/rust-rules/anti-index-over-iter.md +0 -125
  44. package/template/agent/skills/rust-developer/references/rust-rules/anti-lock-across-await.md +0 -127
  45. package/template/agent/skills/rust-developer/references/rust-rules/anti-over-abstraction.md +0 -120
  46. package/template/agent/skills/rust-developer/references/rust-rules/anti-panic-expected.md +0 -131
  47. package/template/agent/skills/rust-developer/references/rust-rules/anti-premature-optimize.md +0 -156
  48. package/template/agent/skills/rust-developer/references/rust-rules/anti-string-for-str.md +0 -122
  49. package/template/agent/skills/rust-developer/references/rust-rules/anti-stringly-typed.md +0 -167
  50. package/template/agent/skills/rust-developer/references/rust-rules/anti-type-erasure.md +0 -134
  51. package/template/agent/skills/rust-developer/references/rust-rules/anti-unwrap-abuse.md +0 -143
  52. package/template/agent/skills/rust-developer/references/rust-rules/anti-vec-for-slice.md +0 -121
  53. package/template/agent/skills/rust-developer/references/rust-rules/api-builder-must-use.md +0 -143
  54. package/template/agent/skills/rust-developer/references/rust-rules/api-builder-pattern.md +0 -187
  55. package/template/agent/skills/rust-developer/references/rust-rules/api-common-traits.md +0 -165
  56. package/template/agent/skills/rust-developer/references/rust-rules/api-default-impl.md +0 -177
  57. package/template/agent/skills/rust-developer/references/rust-rules/api-extension-trait.md +0 -163
  58. package/template/agent/skills/rust-developer/references/rust-rules/api-from-not-into.md +0 -146
  59. package/template/agent/skills/rust-developer/references/rust-rules/api-impl-asref.md +0 -142
  60. package/template/agent/skills/rust-developer/references/rust-rules/api-impl-into.md +0 -160
  61. package/template/agent/skills/rust-developer/references/rust-rules/api-must-use.md +0 -125
  62. package/template/agent/skills/rust-developer/references/rust-rules/api-newtype-safety.md +0 -162
  63. package/template/agent/skills/rust-developer/references/rust-rules/api-non-exhaustive.md +0 -177
  64. package/template/agent/skills/rust-developer/references/rust-rules/api-parse-dont-validate.md +0 -184
  65. package/template/agent/skills/rust-developer/references/rust-rules/api-sealed-trait.md +0 -168
  66. package/template/agent/skills/rust-developer/references/rust-rules/api-serde-optional.md +0 -182
  67. package/template/agent/skills/rust-developer/references/rust-rules/api-typestate.md +0 -199
  68. package/template/agent/skills/rust-developer/references/rust-rules/async-bounded-channel.md +0 -175
  69. package/template/agent/skills/rust-developer/references/rust-rules/async-broadcast-pubsub.md +0 -185
  70. package/template/agent/skills/rust-developer/references/rust-rules/async-cancellation-token.md +0 -203
  71. package/template/agent/skills/rust-developer/references/rust-rules/async-clone-before-await.md +0 -171
  72. package/template/agent/skills/rust-developer/references/rust-rules/async-join-parallel.md +0 -158
  73. package/template/agent/skills/rust-developer/references/rust-rules/async-joinset-structured.md +0 -195
  74. package/template/agent/skills/rust-developer/references/rust-rules/async-mpsc-queue.md +0 -171
  75. package/template/agent/skills/rust-developer/references/rust-rules/async-no-lock-await.md +0 -156
  76. package/template/agent/skills/rust-developer/references/rust-rules/async-oneshot-response.md +0 -191
  77. package/template/agent/skills/rust-developer/references/rust-rules/async-select-racing.md +0 -198
  78. package/template/agent/skills/rust-developer/references/rust-rules/async-spawn-blocking.md +0 -154
  79. package/template/agent/skills/rust-developer/references/rust-rules/async-tokio-fs.md +0 -167
  80. package/template/agent/skills/rust-developer/references/rust-rules/async-tokio-runtime.md +0 -169
  81. package/template/agent/skills/rust-developer/references/rust-rules/async-try-join.md +0 -172
  82. package/template/agent/skills/rust-developer/references/rust-rules/async-watch-latest.md +0 -189
  83. package/template/agent/skills/rust-developer/references/rust-rules/doc-all-public.md +0 -113
  84. package/template/agent/skills/rust-developer/references/rust-rules/doc-cargo-metadata.md +0 -147
  85. package/template/agent/skills/rust-developer/references/rust-rules/doc-errors-section.md +0 -122
  86. package/template/agent/skills/rust-developer/references/rust-rules/doc-examples-section.md +0 -161
  87. package/template/agent/skills/rust-developer/references/rust-rules/doc-hidden-setup.md +0 -149
  88. package/template/agent/skills/rust-developer/references/rust-rules/doc-intra-links.md +0 -138
  89. package/template/agent/skills/rust-developer/references/rust-rules/doc-link-types.md +0 -169
  90. package/template/agent/skills/rust-developer/references/rust-rules/doc-module-inner.md +0 -116
  91. package/template/agent/skills/rust-developer/references/rust-rules/doc-panics-section.md +0 -128
  92. package/template/agent/skills/rust-developer/references/rust-rules/doc-question-mark.md +0 -136
  93. package/template/agent/skills/rust-developer/references/rust-rules/doc-safety-section.md +0 -131
  94. package/template/agent/skills/rust-developer/references/rust-rules/err-anyhow-app.md +0 -179
  95. package/template/agent/skills/rust-developer/references/rust-rules/err-context-chain.md +0 -144
  96. package/template/agent/skills/rust-developer/references/rust-rules/err-custom-type.md +0 -152
  97. package/template/agent/skills/rust-developer/references/rust-rules/err-doc-errors.md +0 -145
  98. package/template/agent/skills/rust-developer/references/rust-rules/err-expect-bugs-only.md +0 -133
  99. package/template/agent/skills/rust-developer/references/rust-rules/err-from-impl.md +0 -152
  100. package/template/agent/skills/rust-developer/references/rust-rules/err-lowercase-msg.md +0 -124
  101. package/template/agent/skills/rust-developer/references/rust-rules/err-no-unwrap-prod.md +0 -115
  102. package/template/agent/skills/rust-developer/references/rust-rules/err-question-mark.md +0 -151
  103. package/template/agent/skills/rust-developer/references/rust-rules/err-result-over-panic.md +0 -130
  104. package/template/agent/skills/rust-developer/references/rust-rules/err-source-chain.md +0 -155
  105. package/template/agent/skills/rust-developer/references/rust-rules/err-thiserror-lib.md +0 -171
  106. package/template/agent/skills/rust-developer/references/rust-rules/lint-cargo-metadata.md +0 -138
  107. package/template/agent/skills/rust-developer/references/rust-rules/lint-deny-correctness.md +0 -107
  108. package/template/agent/skills/rust-developer/references/rust-rules/lint-missing-docs.md +0 -154
  109. package/template/agent/skills/rust-developer/references/rust-rules/lint-pedantic-selective.md +0 -118
  110. package/template/agent/skills/rust-developer/references/rust-rules/lint-rustfmt-check.md +0 -157
  111. package/template/agent/skills/rust-developer/references/rust-rules/lint-unsafe-doc.md +0 -133
  112. package/template/agent/skills/rust-developer/references/rust-rules/lint-warn-complexity.md +0 -131
  113. package/template/agent/skills/rust-developer/references/rust-rules/lint-warn-perf.md +0 -136
  114. package/template/agent/skills/rust-developer/references/rust-rules/lint-warn-style.md +0 -135
  115. package/template/agent/skills/rust-developer/references/rust-rules/lint-warn-suspicious.md +0 -122
  116. package/template/agent/skills/rust-developer/references/rust-rules/lint-workspace-lints.md +0 -172
  117. package/template/agent/skills/rust-developer/references/rust-rules/mem-arena-allocator.md +0 -168
  118. package/template/agent/skills/rust-developer/references/rust-rules/mem-arrayvec.md +0 -142
  119. package/template/agent/skills/rust-developer/references/rust-rules/mem-assert-type-size.md +0 -168
  120. package/template/agent/skills/rust-developer/references/rust-rules/mem-avoid-format.md +0 -147
  121. package/template/agent/skills/rust-developer/references/rust-rules/mem-box-large-variant.md +0 -158
  122. package/template/agent/skills/rust-developer/references/rust-rules/mem-boxed-slice.md +0 -139
  123. package/template/agent/skills/rust-developer/references/rust-rules/mem-clone-from.md +0 -147
  124. package/template/agent/skills/rust-developer/references/rust-rules/mem-compact-string.md +0 -149
  125. package/template/agent/skills/rust-developer/references/rust-rules/mem-reuse-collections.md +0 -174
  126. package/template/agent/skills/rust-developer/references/rust-rules/mem-smaller-integers.md +0 -159
  127. package/template/agent/skills/rust-developer/references/rust-rules/mem-smallvec.md +0 -138
  128. package/template/agent/skills/rust-developer/references/rust-rules/mem-thinvec.md +0 -142
  129. package/template/agent/skills/rust-developer/references/rust-rules/mem-with-capacity.md +0 -156
  130. package/template/agent/skills/rust-developer/references/rust-rules/mem-write-over-format.md +0 -172
  131. package/template/agent/skills/rust-developer/references/rust-rules/mem-zero-copy.md +0 -164
  132. package/template/agent/skills/rust-developer/references/rust-rules/name-acronym-word.md +0 -99
  133. package/template/agent/skills/rust-developer/references/rust-rules/name-as-free.md +0 -104
  134. package/template/agent/skills/rust-developer/references/rust-rules/name-consts-screaming.md +0 -94
  135. package/template/agent/skills/rust-developer/references/rust-rules/name-crate-no-rs.md +0 -78
  136. package/template/agent/skills/rust-developer/references/rust-rules/name-funcs-snake.md +0 -76
  137. package/template/agent/skills/rust-developer/references/rust-rules/name-into-ownership.md +0 -123
  138. package/template/agent/skills/rust-developer/references/rust-rules/name-is-has-bool.md +0 -127
  139. package/template/agent/skills/rust-developer/references/rust-rules/name-iter-convention.md +0 -129
  140. package/template/agent/skills/rust-developer/references/rust-rules/name-iter-method.md +0 -131
  141. package/template/agent/skills/rust-developer/references/rust-rules/name-iter-type-match.md +0 -142
  142. package/template/agent/skills/rust-developer/references/rust-rules/name-lifetime-short.md +0 -86
  143. package/template/agent/skills/rust-developer/references/rust-rules/name-no-get-prefix.md +0 -154
  144. package/template/agent/skills/rust-developer/references/rust-rules/name-to-expensive.md +0 -118
  145. package/template/agent/skills/rust-developer/references/rust-rules/name-type-param-single.md +0 -92
  146. package/template/agent/skills/rust-developer/references/rust-rules/name-types-camel.md +0 -65
  147. package/template/agent/skills/rust-developer/references/rust-rules/name-variants-camel.md +0 -101
  148. package/template/agent/skills/rust-developer/references/rust-rules/opt-bounds-check.md +0 -161
  149. package/template/agent/skills/rust-developer/references/rust-rules/opt-cache-friendly.md +0 -187
  150. package/template/agent/skills/rust-developer/references/rust-rules/opt-codegen-units.md +0 -142
  151. package/template/agent/skills/rust-developer/references/rust-rules/opt-cold-unlikely.md +0 -152
  152. package/template/agent/skills/rust-developer/references/rust-rules/opt-inline-always-rare.md +0 -141
  153. package/template/agent/skills/rust-developer/references/rust-rules/opt-inline-never-cold.md +0 -181
  154. package/template/agent/skills/rust-developer/references/rust-rules/opt-inline-small.md +0 -160
  155. package/template/agent/skills/rust-developer/references/rust-rules/opt-likely-hint.md +0 -171
  156. package/template/agent/skills/rust-developer/references/rust-rules/opt-lto-release.md +0 -130
  157. package/template/agent/skills/rust-developer/references/rust-rules/opt-pgo-profile.md +0 -167
  158. package/template/agent/skills/rust-developer/references/rust-rules/opt-simd-portable.md +0 -144
  159. package/template/agent/skills/rust-developer/references/rust-rules/opt-target-cpu.md +0 -154
  160. package/template/agent/skills/rust-developer/references/rust-rules/own-arc-shared.md +0 -141
  161. package/template/agent/skills/rust-developer/references/rust-rules/own-borrow-over-clone.md +0 -95
  162. package/template/agent/skills/rust-developer/references/rust-rules/own-clone-explicit.md +0 -135
  163. package/template/agent/skills/rust-developer/references/rust-rules/own-copy-small.md +0 -124
  164. package/template/agent/skills/rust-developer/references/rust-rules/own-cow-conditional.md +0 -135
  165. package/template/agent/skills/rust-developer/references/rust-rules/own-lifetime-elision.md +0 -134
  166. package/template/agent/skills/rust-developer/references/rust-rules/own-move-large.md +0 -134
  167. package/template/agent/skills/rust-developer/references/rust-rules/own-mutex-interior.md +0 -105
  168. package/template/agent/skills/rust-developer/references/rust-rules/own-rc-single-thread.md +0 -65
  169. package/template/agent/skills/rust-developer/references/rust-rules/own-refcell-interior.md +0 -97
  170. package/template/agent/skills/rust-developer/references/rust-rules/own-rwlock-readers.md +0 -122
  171. package/template/agent/skills/rust-developer/references/rust-rules/own-slice-over-vec.md +0 -119
  172. package/template/agent/skills/rust-developer/references/rust-rules/perf-black-box-bench.md +0 -153
  173. package/template/agent/skills/rust-developer/references/rust-rules/perf-chain-avoid.md +0 -136
  174. package/template/agent/skills/rust-developer/references/rust-rules/perf-collect-into.md +0 -133
  175. package/template/agent/skills/rust-developer/references/rust-rules/perf-collect-once.md +0 -120
  176. package/template/agent/skills/rust-developer/references/rust-rules/perf-drain-reuse.md +0 -137
  177. package/template/agent/skills/rust-developer/references/rust-rules/perf-entry-api.md +0 -134
  178. package/template/agent/skills/rust-developer/references/rust-rules/perf-extend-batch.md +0 -150
  179. package/template/agent/skills/rust-developer/references/rust-rules/perf-iter-lazy.md +0 -123
  180. package/template/agent/skills/rust-developer/references/rust-rules/perf-iter-over-index.md +0 -113
  181. package/template/agent/skills/rust-developer/references/rust-rules/perf-profile-first.md +0 -175
  182. package/template/agent/skills/rust-developer/references/rust-rules/perf-release-profile.md +0 -149
  183. package/template/agent/skills/rust-developer/references/rust-rules/proj-bin-dir.md +0 -142
  184. package/template/agent/skills/rust-developer/references/rust-rules/proj-flat-small.md +0 -133
  185. package/template/agent/skills/rust-developer/references/rust-rules/proj-lib-main-split.md +0 -148
  186. package/template/agent/skills/rust-developer/references/rust-rules/proj-mod-by-feature.md +0 -130
  187. package/template/agent/skills/rust-developer/references/rust-rules/proj-mod-rs-dir.md +0 -120
  188. package/template/agent/skills/rust-developer/references/rust-rules/proj-prelude-module.md +0 -155
  189. package/template/agent/skills/rust-developer/references/rust-rules/proj-pub-crate-internal.md +0 -139
  190. package/template/agent/skills/rust-developer/references/rust-rules/proj-pub-super-parent.md +0 -135
  191. package/template/agent/skills/rust-developer/references/rust-rules/proj-pub-use-reexport.md +0 -162
  192. package/template/agent/skills/rust-developer/references/rust-rules/proj-workspace-deps.md +0 -186
  193. package/template/agent/skills/rust-developer/references/rust-rules/proj-workspace-large.md +0 -162
  194. package/template/agent/skills/rust-developer/references/rust-rules/test-arrange-act-assert.md +0 -160
  195. package/template/agent/skills/rust-developer/references/rust-rules/test-cfg-test-module.md +0 -151
  196. package/template/agent/skills/rust-developer/references/rust-rules/test-criterion-bench.md +0 -171
  197. package/template/agent/skills/rust-developer/references/rust-rules/test-descriptive-names.md +0 -142
  198. package/template/agent/skills/rust-developer/references/rust-rules/test-doctest-examples.md +0 -168
  199. package/template/agent/skills/rust-developer/references/rust-rules/test-fixture-raii.md +0 -151
  200. package/template/agent/skills/rust-developer/references/rust-rules/test-integration-dir.md +0 -144
  201. package/template/agent/skills/rust-developer/references/rust-rules/test-mock-traits.md +0 -189
  202. package/template/agent/skills/rust-developer/references/rust-rules/test-mockall-mocking.md +0 -226
  203. package/template/agent/skills/rust-developer/references/rust-rules/test-proptest-properties.md +0 -161
  204. package/template/agent/skills/rust-developer/references/rust-rules/test-should-panic.md +0 -130
  205. package/template/agent/skills/rust-developer/references/rust-rules/test-tokio-async.md +0 -154
  206. package/template/agent/skills/rust-developer/references/rust-rules/test-use-super.md +0 -127
  207. package/template/agent/skills/rust-developer/references/rust-rules/type-enum-states.md +0 -154
  208. package/template/agent/skills/rust-developer/references/rust-rules/type-generic-bounds.md +0 -142
  209. package/template/agent/skills/rust-developer/references/rust-rules/type-never-diverge.md +0 -146
  210. package/template/agent/skills/rust-developer/references/rust-rules/type-newtype-ids.md +0 -160
  211. package/template/agent/skills/rust-developer/references/rust-rules/type-newtype-validated.md +0 -159
  212. package/template/agent/skills/rust-developer/references/rust-rules/type-no-stringly.md +0 -144
  213. package/template/agent/skills/rust-developer/references/rust-rules/type-option-nullable.md +0 -137
  214. package/template/agent/skills/rust-developer/references/rust-rules/type-phantom-marker.md +0 -188
  215. package/template/agent/skills/rust-developer/references/rust-rules/type-repr-transparent.md +0 -143
  216. package/template/agent/skills/rust-developer/references/rust-rules/type-result-fallible.md +0 -131
  217. package/template/agent/skills/saas-architect/SKILL.md +0 -139
  218. package/template/agent/skills/security-engineer/SKILL.md +0 -133
  219. package/template/agent/skills/seo-specialist/SKILL.md +0 -130
  220. package/template/agent/skills/solo-founder-ops/SKILL.md +0 -56
package/README.md CHANGED
@@ -43,16 +43,15 @@ agy-superpowers init
43
43
  .agent/
44
44
  ├── rules/
45
45
  │ └── superpowers.md # Always-on rule: agent checks skills before acting
46
- ├── skills/ # 58 skills (14 upstream + 44 expansion skills)
46
+ ├── skills/ # 23 active skills (14 upstream + 9 expansion skills)
47
47
  │ ├── brainstorming/
48
48
  │ ├── writing-plans/
49
49
  │ ├── executing-plans/
50
- │ ├── backend-developer/
51
50
  │ ├── frontend-developer/
52
51
  │ ├── mobile-developer/
53
- │ ├── growth-hacker/
54
- │ ├── monetization-strategist/
55
- │ └── ... # + 48 more skills
52
+ │ ├── subscription-billing/
53
+ │ ├── i18n-localization/
54
+ │ └── ... # + 15 more skills
56
55
  ├── workflows/
57
56
  │ ├── brainstorm.md # /brainstorm
58
57
  │ ├── write-plan.md # /write-plan
@@ -103,7 +102,7 @@ agy-superpowers init
103
102
 
104
103
  ### Getting Started in 5 Minutes
105
104
 
106
- **How it works:** Superpowers gives your agent 58 specialized skills. You don't need to remember or invoke them — the agent **automatically reads and selects the right skill** based on what you ask. Just describe what you need in natural language.
105
+ **How it works:** Superpowers gives your agent 23 specialized skills. You don't need to remember or invoke them — the agent **automatically reads and selects the right skill** based on what you ask. Just describe what you need in natural language.
107
106
 
108
107
  #### Your First Feature: A Walkthrough
109
108
 
@@ -160,20 +159,12 @@ Activate when you work on specific technical domains:
160
159
 
161
160
  | Skill | When it activates |
162
161
  | ---------------------------- | ------------------------------------------------------------ |
163
- | `backend-developer` | Designing APIs, server-side logic, database schemas |
164
162
  | `frontend-developer` | Building web UI, component architecture |
165
163
  | `mobile-developer` | Mobile app features, React Native / Flutter / iOS / Android |
166
- | `game-developer` | Game app features, game code, game architecture |
167
- | `api-design` | REST or GraphQL APIs, versioning, rate limiting, pagination |
168
- | `real-time-features` | WebSockets, SSE, live collaboration, real-time notifications |
169
- | `auth-and-identity` | Authentication, authorization, SSO, RBAC |
170
- | `devops-engineer` | CI/CD, infrastructure, deployment, monitoring |
171
- | `security-engineer` | App security, user data handling, GDPR/App Store compliance |
172
- | `email-infrastructure` | Transactional email, deliverability, SPF/DKIM/DMARC |
173
- | `saas-architect` | Multi-tenant SaaS architecture, tenant isolation |
174
- | `chrome-extension-developer` | Chrome extensions, browser-based tools |
175
-
176
- > **Example prompt:** _"Design a REST API for user management with rate limiting and pagination"_ → activates `api-design` + `backend-developer`
164
+ | `frontend-design` | Web components, pages, apps high design quality |
165
+ | `mobile-uiux-promax` | Mobile app UI for iOS, Android, React Native, Flutter |
166
+
167
+ > **Example prompt:** _"Build a responsive dashboard with dark mode"_ → activates `frontend-developer` + `frontend-design`
177
168
 
178
169
  #### 🎨 Product & Design
179
170
 
@@ -181,56 +172,18 @@ Activate when you work on specific technical domains:
181
172
  | ------------------- | ----------------------------------------------------------------- |
182
173
  | `product-manager` | Defining requirements, prioritizing features, planning roadmaps |
183
174
  | `ux-designer` | Designing UI, wireframes, user research, information architecture |
184
- | `cto-architect` | System design decisions, tech debt, planning for scale |
175
+ | `copywriter` | Landing page copy, app store descriptions, email sequences |
185
176
  | `i18n-localization` | Internationalization, localizing for new markets |
186
- | `game-design` | Game mechanics, core loops, progression, difficulty curves |
187
177
 
188
178
  > **Example prompt:** _"Help me prioritize features for the next sprint based on user feedback"_ → activates `product-manager`
189
179
 
190
- #### 📈 Marketing & Growth
191
-
192
- | Skill | When it activates |
193
- | ----------------------------- | -------------------------------------------------------------- |
194
- | `growth-hacker` | User acquisition, viral loops, activation funnels |
195
- | `content-marketer` | Content strategy, SEO content, social media, newsletters |
196
- | `seo-specialist` | Technical SEO, keyword research, on-page optimization |
197
- | `conversion-optimizer` | Landing pages, trial-to-paid funnels, paywall design |
198
- | `copywriter` | Landing page copy, app store descriptions, email sequences |
199
- | `community-manager` | Discord, Reddit, Slack communities, engagement strategy |
200
- | `influencer-marketer` | UGC campaigns, creator partnerships, TikTok/YouTube marketing |
201
- | `paid-acquisition-specialist` | Meta Ads, Google Ads, Apple Search Ads, ROAS optimization |
202
- | `launch-strategist` | Product launch, go-to-market, pre-launch campaigns |
203
- | `landing-page-builder` | Landing pages, waitlist pages, marketing sites |
204
- | `app-store-optimizer` | App Store / Google Play listing optimization, keyword strategy |
205
-
206
- > **Example prompt:** _"Write an ASO-optimized App Store description for my meditation app"_ → activates `app-store-optimizer` + `copywriter`
207
-
208
- #### 💰 Revenue & Operations
209
-
210
- | Skill | When it activates |
211
- | -------------------------- | ------------------------------------------------------------------ |
212
- | `monetization-strategist` | Pricing models, freemium strategy, IAP, unit economics |
213
- | `pricing-psychologist` | Pricing, paywalls, free-to-paid conversion |
214
- | `subscription-billing` | Stripe integration, webhooks, trial logic, dunning flows |
215
- | `bootstrapper-finance` | MRR tracking, runway calculation, financial decisions |
216
- | `solo-founder-ops` | Time management, feature prioritization, running multiple products |
217
- | `analytics-setup` | Analytics, tracking tools, metrics dashboards |
218
- | `customer-success-manager` | User support, feedback loops, NPS/CSAT, churn |
219
- | `data-analyst` | Metrics frameworks, funnel analysis, cohort analysis, A/B tests |
220
- | `indie-legal` | Privacy policies, terms of service, GDPR/CCPA |
221
-
222
- > **Example prompt:** _"Should I charge $9/mo or $29/mo for my SaaS? Here's my target audience..."_ → activates `pricing-psychologist` + `monetization-strategist`
223
-
224
- #### 🚀 Validate & Scale
225
-
226
- | Skill | When it activates |
227
- | ----------------------- | --------------------------------------------------------------- |
228
- | `idea-validator` | Evaluating a product idea, assessing market fit before building |
229
- | `market-researcher` | Finding a niche, analyzing market size, customer discovery |
230
- | `ai-integrated-product` | Integrating AI/LLM capabilities, building AI-powered features |
231
- | `micro-saas-builder` | Building a micro-SaaS, choosing a niche SaaS idea |
232
-
233
- > **Example prompt:** _"I have an idea for an AI writing tool — is it worth building?"_ → activates `idea-validator` + `market-researcher`
180
+ #### 💰 Infrastructure & Billing
181
+
182
+ | Skill | When it activates |
183
+ | ---------------------- | ---------------------------------------------------------------- |
184
+ | `subscription-billing` | Stripe integration, webhooks, trial logic, dunning flows |
185
+
186
+ > **Example prompt:** _"Set up subscription billing with Stripe and handle trial-to-paid conversion"_ → activates `subscription-billing`
234
187
 
235
188
  ---
236
189
 
@@ -251,7 +204,7 @@ Activate when you work on specific technical domains:
251
204
 
252
205
  - **Provide context** — mention your tech stack, project name, and constraints: _"In my Next.js app with Supabase auth..."_
253
206
  - **State goals, not solutions** — _"Users drop off during signup"_ gives the agent room to find the best fix, vs _"Add a progress bar to the signup form"_
254
- - **Mention specific domains** to activate the right skills — _"Review the **security** of my auth flow"_ triggers `security-engineer`, _"Optimize the **SEO** for my landing page"_ triggers `seo-specialist`
207
+ - **Mention specific domains** to activate the right skills — _"Design the **UX** for my onboarding flow"_ triggers `ux-designer`, _"Localize my app for Japanese"_ triggers `i18n-localization`
255
208
 
256
209
  #### Combining Workflows for Complex Projects
257
210
 
@@ -261,16 +214,8 @@ Activate when you work on specific technical domains:
261
214
  /brainstorm → /write-plan → /execute-plan → /code-review
262
215
  ↓ then in separate conversations:
263
216
  "Write marketing copy for..." → copywriter skill
264
- "Optimize my App Store listing..." → ASO skill
265
- "Design a pricing strategy..." → pricing skill
266
- ```
267
-
268
- **Idea → Validation → Build:**
269
-
270
- ```
271
- "I have an idea for X, is it viable?" → idea-validator
272
- "Research the market for X" → market-researcher
273
- /brainstorm → /write-plan → /execute-plan → build it
217
+ "Set up billing with Stripe..." → subscription-billing skill
218
+ "Localize for Japanese market..." → i18n-localization skill
274
219
  ```
275
220
 
276
221
  **Debugging effectively:**
@@ -293,7 +238,7 @@ Per-project settings (like `auto_commit`) live in `.agent/config.yml` — see [C
293
238
  | Cram multiple goals into one prompt | One conversation = one clear objective |
294
239
  | Jump to `/execute-plan` without reviewing the spec | Review and approve the design spec before execution |
295
240
  | Skip `/code-review` before merging | Always review before merge — catch bugs early |
296
- | Assume the agent only writes code | Ask about pricing, marketing, legal it has skills for those too |
241
+ | Use long conversations for multiple tasks | Start a new conversation for each distinct task (saves tokens) |
297
242
 
298
243
  ---
299
244
 
@@ -311,80 +256,31 @@ When you run `/update-superpowers`, skills are:
311
256
 
312
257
  ## Skills Reference
313
258
 
314
- | Skill | Triggers automatically when... |
315
- | -------------------------------- | ----------------------------------------------------------------------------------------------------------- |
316
- | `ai-integrated-product` | Integrating AI/LLM capabilities into a product, building AI-powered features |
317
- | `analytics-setup` | Setting up analytics, choosing tracking tools, or designing a metrics dashboard for an indie product |
318
- | `api-design` | Designing REST or GraphQL APIs, versioning, rate limiting, pagination, or API docs |
319
- | `app-store-optimizer` | Working on App Store / Google Play listing optimization, keyword strategy, or A/B testing |
320
- | `auth-and-identity` | Implementing authentication, authorization, SSO/SAML/OIDC, session management, or RBAC |
321
- | `backend-developer` | Designing APIs, server-side logic, database schemas, or reviewing backend code |
322
- | `bootstrapper-finance` | Tracking MRR, calculating runway, making financial decisions for a solo/bootstrapped business |
323
- | `brainstorming` | Adding a feature, building a component, or modifying behavior |
324
- | `chrome-extension-developer` | Building a Chrome extension, browser extension, or browser-based tool |
325
- | `community-manager` | Building and managing communities on Discord, Reddit, Slack, or social platforms |
326
- | `content-marketer` | Planning content strategy, SEO content, social media, or email newsletters |
327
- | `conversion-optimizer` | Optimizing landing pages, trial-to-paid funnels, paywall design, or onboarding flows |
328
- | `copywriter` | Writing landing page copy, app store descriptions, email sequences, or user-facing text |
329
- | `cto-architect` | Making system design decisions, managing tech debt, planning for scale |
330
- | `customer-success-manager` | Managing user support, feedback loops, NPS/CSAT tracking, or handling churn |
331
- | `data-analyst` | Setting up metrics, analyzing funnels, cohort analysis, dashboards, or A/B test results |
332
- | `devops-engineer` | Working on CI/CD pipelines, infrastructure, deployment, monitoring, or reliability |
333
- | `dispatching-parallel-agents` | Facing 2+ independent tasks that can run without shared state |
334
- | `email-infrastructure` | Setting up transactional email, deliverability, SPF/DKIM/DMARC, or email templates |
335
- | `executing-plans` | Running a plan step-by-step with checkpoints |
336
- | `finishing-a-development-branch` | Implementation is complete and you need to merge / PR / discard |
337
- | `frontend-design` | Building web components, pages, or apps with high design quality avoids generic AI aesthetics |
338
- | `frontend-developer` | Building web UI, component architecture, or reviewing frontend code |
339
- | `game-design` | Designing game mechanics, core loops, progression, monetization, or difficulty curves |
340
- | `game-developer` | Working on game app features, reviewing game code, or game architecture decisions |
341
- | `growth-hacker` | Planning user acquisition, viral loops, activation funnels, or growth experiments |
342
- | `i18n-localization` | Planning i18n architecture, localizing for new markets, or managing translations |
343
- | `idea-validator` | Starting a new project, evaluating a product idea, or assessing market fit before building |
344
- | `indie-legal` | Creating privacy policies, terms of service, handling GDPR/CCPA basics, or understanding legal requirements |
345
- | `influencer-marketer` | Planning UGC campaigns, creator partnerships, TikTok/YouTube/Instagram marketing |
346
- | `landing-page-builder` | Creating a landing page, waitlist page, product page, or marketing site |
347
- | `launch-strategist` | Preparing to launch a product, planning go-to-market, or running a pre-launch campaign |
348
- | `market-researcher` | Finding a niche, analyzing market size, researching customer segments, or doing customer discovery |
349
- | `micro-saas-builder` | Building a micro-SaaS product, choosing a niche SaaS idea, or designing a small scalable SaaS |
350
- | `mobile-developer` | Working on mobile app features, reviewing mobile code, or mobile architecture |
351
- | `mobile-uiux-promax` | Designing or building mobile app UI for iOS, Android, React Native, Flutter, SwiftUI, or Compose |
352
- | `monetization-strategist` | Designing pricing models, freemium strategy, IAP, or modeling unit economics |
353
- | `paid-acquisition-specialist` | Running Meta Ads, Google Ads, Apple Search Ads, or any paid acquisition channel |
354
- | `pricing-psychologist` | Designing pricing, paywalls, free-to-paid conversion, or optimizing upgrade flows |
355
- | `product-manager` | Defining requirements, prioritizing features, planning roadmaps, or validating problems |
356
- | `real-time-features` | Implementing WebSockets, SSE, live collaboration, or real-time notifications |
357
- | `receiving-code-review` | Receiving code review feedback, before implementing suggestions |
358
- | `requesting-code-review` | Completing tasks or before merging to verify work meets requirements |
359
- | `retention-specialist` | Improving user retention, reducing churn, analyzing engagement, or re-engagement |
360
- | `saas-architect` | Designing multi-tenant SaaS architecture, tenant isolation, or data models |
361
- | `security-engineer` | Reviewing app security, handling user data, ensuring GDPR/App Store compliance |
362
- | `seo-specialist` | Working on technical SEO, keyword research, on-page optimization, or backlink strategy |
363
- | `solo-founder-ops` | Managing time, prioritizing features, or running multiple products as a solo founder |
364
- | `subagent-driven-development` | Executing implementation plans with independent tasks in the current session |
365
- | `subscription-billing` | Integrating subscription billing, Stripe webhooks, trial logic, or dunning flows |
366
- | `systematic-debugging` | Debugging any issue |
367
- | `test-driven-development` | Implementing any feature or bugfix |
368
- | `using-git-worktrees` | Starting work on an isolated branch |
369
- | `using-superpowers` | Starting any conversation — checks for relevant skills |
370
- | `ux-designer` | Designing UI, wireframes, user research, or information architecture |
371
- | `verification-before-completion` | Before declaring a fix or task done |
372
- | `writing-plans` | Design is approved — breaking work into tasks |
373
- | `writing-skills` | Creating or editing a skill |
374
-
375
- ---
376
-
377
- ### The Indie Hacker Journey
378
-
379
- 44 expansion skills cover the full indie hacker lifecycle — from first idea to sustainable business:
380
-
381
- - **Validate:** `idea-validator`, `market-researcher`
382
- - **Design:** `product-manager`, `ux-designer`, `cto-architect`
383
- - **Build:** `backend-developer`, `frontend-developer`, `frontend-design`, `mobile-developer`, `mobile-uiux-promax`, `game-developer`, `game-design`, `chrome-extension-developer`, `api-design`, `real-time-features`, `auth-and-identity`, `email-infrastructure`, `saas-architect`, `devops-engineer`, `security-engineer`, `i18n-localization`, `ai-integrated-product`, `micro-saas-builder`
384
- - **Launch:** `launch-strategist`, `landing-page-builder`, `app-store-optimizer`, `copywriter`
385
- - **Grow:** `growth-hacker`, `content-marketer`, `seo-specialist`, `conversion-optimizer`, `community-manager`, `influencer-marketer`, `paid-acquisition-specialist`, `retention-specialist`
386
- - **Revenue:** `monetization-strategist`, `pricing-psychologist`, `subscription-billing`, `bootstrapper-finance`
387
- - **Operate:** `solo-founder-ops`, `analytics-setup`, `customer-success-manager`, `data-analyst`, `indie-legal`
259
+ | Skill | Triggers automatically when... |
260
+ | -------------------------------- | ------------------------------------------------------------------------------------------------- |
261
+ | `brainstorming` | Adding a feature, building a component, or modifying behavior |
262
+ | `copywriter` | Writing landing page copy, app store descriptions, email sequences, or user-facing text |
263
+ | `dispatching-parallel-agents` | Facing 2+ independent tasks that can run without shared state |
264
+ | `executing-plans` | Running a plan step-by-step with checkpoints |
265
+ | `finishing-a-development-branch` | Implementation is complete and you need to merge / PR / discard |
266
+ | `frontend-design` | Building web components, pages, or apps with high design quality |
267
+ | `frontend-developer` | Building web UI, component architecture, or reviewing frontend code |
268
+ | `i18n-localization` | Planning i18n architecture, localizing for new markets, or managing translations |
269
+ | `mobile-developer` | Working on mobile app features, reviewing mobile code, or mobile architecture |
270
+ | `mobile-uiux-promax` | Designing or building mobile app UI for iOS, Android, React Native, Flutter, SwiftUI, or Compose |
271
+ | `product-manager` | Defining requirements, prioritizing features, planning roadmaps, or validating problems |
272
+ | `receiving-code-review` | Receiving code review feedback, before implementing suggestions |
273
+ | `requesting-code-review` | Completing tasks or before merging to verify work meets requirements |
274
+ | `subagent-driven-development` | Executing implementation plans with independent tasks in the current session |
275
+ | `subscription-billing` | Integrating subscription billing, Stripe webhooks, trial logic, or dunning flows |
276
+ | `systematic-debugging` | Debugging any issue |
277
+ | `test-driven-development` | Implementing any feature or bugfix |
278
+ | `using-git-worktrees` | Starting work on an isolated branch |
279
+ | `using-superpowers` | Starting any conversation checks for relevant skills |
280
+ | `ux-designer` | Designing UI, wireframes, user research, or information architecture |
281
+ | `verification-before-completion` | Before declaring a fix or task done |
282
+ | `writing-plans` | Design is approvedbreaking work into tasks |
283
+ | `writing-skills` | Creating or editing a skill |
388
284
 
389
285
  ---
390
286
 
@@ -450,6 +346,7 @@ This setup enforces four core principles across every task:
450
346
  - **YAGNI** — Don't build what isn't needed yet
451
347
  - **Systematic over ad-hoc** — Follow the skill process, don't guess
452
348
  - **Evidence over claims** — Verify before declaring success
349
+ - **Token efficiency** — 23 focused skills instead of 58, optimized for the workflows you actually use
453
350
 
454
351
  ---
455
352
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agy-superpowers",
3
- "version": "5.2.2",
3
+ "version": "5.2.3",
4
4
  "description": "Superpowers skills library for Google Antigravity agent — scaffold .agent/ with one command",
5
5
  "type": "module",
6
6
  "bin": {
@@ -0,0 +1,37 @@
1
+ ---
2
+ description: CRITICAL — Scratch scripts must run inside workspace (.agent/tmp/), NEVER in /tmp/
3
+ alwaysApply: true
4
+ ---
5
+
6
+ # Scratch Scripts Policy
7
+
8
+ > **PRIORITY: CRITICAL** — Violating this rule causes commands to hang and freeze the conversation.
9
+
10
+ ## The Rule
11
+
12
+ **NEVER create or run scratch scripts in `/tmp/`.** Always use `.agent/tmp/` instead.
13
+
14
+ Running scripts in `/tmp/` causes `run_command` to hang because `/tmp/` is outside the workspace boundary. This freezes the entire conversation with no recovery.
15
+
16
+ ## Requirements
17
+
18
+ 1. **Path**: All scratch/temporary scripts go in `.agent/tmp/`, NOT `/tmp/`
19
+ 2. **Cwd**: When calling `run_command`, set `Cwd` to the **workspace root** — never to `/tmp/` or any path outside the workspace
20
+ 3. **Create dir first**: Run `mkdir -p .agent/tmp` before writing scratch files if the directory might not exist
21
+ 4. **Cleanup**: Delete scratch files after use when they are no longer needed
22
+
23
+ ## Examples
24
+
25
+ ```
26
+ # ✅ CORRECT
27
+ Cwd: /path/to/project
28
+ CommandLine: node .agent/tmp/test-parser.js
29
+
30
+ # ❌ WRONG — will hang
31
+ Cwd: /tmp
32
+ CommandLine: node /tmp/test-parser.js
33
+ ```
34
+
35
+ ## Why This Matters
36
+
37
+ The `run_command` tool requires `Cwd` to be within the workspace. When scripts are placed in `/tmp/` and `Cwd` is set to `/tmp/`, the command hangs indefinitely — the agent goes silent and the user must restart the conversation.
@@ -37,73 +37,26 @@ All skills are symlinked into `.agent/skills/` and are automatically available.
37
37
 
38
38
  | Skill | When to Use |
39
39
  |---|---|
40
- | `frontend-developer` | Web UI, component architecture, React/Vue/Svelte/Vanilla. Has `react-rules/` (66 Vercel rules) and `vue-rules/` (44 antfu rules) |
41
- | `backend-developer` | APIs, server-side logic, database schemas |
42
- | `mobile-developer` | Mobile apps — React Native, Flutter, iOS, Android. Has `react-native-rules/` (38), `flutter-rules/` (8), `android-rules/` (17), `ios-rules/` (19) |
43
- | `game-developer` | Mobile game features, architecture decisions |
44
- | `game-design` | Game mechanics, core loops, progression, monetization |
45
- | `cto-architect` | System design, tech debt, scaling, architecture |
46
- | `saas-architect` | Multi-tenant SaaS architecture, tenant isolation |
47
- | `devops-engineer` | CI/CD, infrastructure, deployment, monitoring |
48
- | `security-engineer` | App security, auth, GDPR, security audits |
49
- | `frontend-design` | Web components, pages, artifacts — high design quality, avoids generic AI aesthetics |
40
+ | `frontend-developer` | Web UI, component architecture, React/Vue/Svelte/Vanilla |
41
+ | `mobile-developer` | Mobile apps — React Native, Flutter, iOS, Android |
42
+ | `frontend-design` | Web components, pages, artifacts high design quality |
50
43
  | `mobile-uiux-promax` | Mobile app UI for iOS, Android, React Native, Flutter, SwiftUI, Compose |
51
- | `rust-developer` | Rust code, ownership/borrow errors, async patterns, idiomatic Rust |
52
44
 
53
- ### Business & Growth
45
+ ### Product & Design
54
46
 
55
47
  | Skill | When to Use |
56
48
  |---|---|
57
49
  | `product-manager` | Product requirements, feature prioritization, roadmap |
58
- | `data-analyst` | Metrics, funnels, cohort analysis, A/B tests |
59
- | `growth-hacker` | User acquisition, viral loops, activation funnels |
60
- | `monetization-strategist` | Pricing, freemium, IAP, unit economics |
61
- | `conversion-optimizer` | Landing pages, trial-to-paid, onboarding, CRO |
62
- | `retention-specialist` | Onboarding flows, churn reduction, re-engagement |
63
- | `customer-success-manager` | User support, feedback loops, NPS/CSAT |
64
- | `app-store-optimizer` | ASO, keyword strategy, screenshots, ratings |
65
50
  | `ux-designer` | UI design, wireframes, user research, IA |
66
51
  | `copywriter` | Landing copy, app descriptions, email sequences |
67
52
 
68
- ### Marketing & Content
69
-
70
- | Skill | When to Use |
71
- |---|---|
72
- | `content-marketer` | Content strategy, SEO content, social media |
73
- | `seo-specialist` | Technical SEO, keywords, backlinks, organic search |
74
- | `community-manager` | Discord, Reddit, Slack community management |
75
- | `influencer-marketer` | UGC, creator partnerships, affiliate programs |
76
- | `paid-acquisition-specialist` | Meta Ads, Google Ads, Apple Search Ads, ROAS |
77
-
78
53
  ### Infrastructure & Integration
79
54
 
80
55
  | Skill | When to Use |
81
56
  |---|---|
82
- | `api-design` | REST/GraphQL APIs, versioning, rate limiting |
83
- | `auth-and-identity` | Auth, SSO/SAML/OIDC, RBAC, session management |
84
57
  | `subscription-billing` | Stripe, IAP, trials, dunning flows |
85
- | `email-infrastructure` | Transactional email, SPF/DKIM/DMARC, deliverability |
86
- | `real-time-features` | WebSockets, SSE, live collaboration, presence |
87
58
  | `i18n-localization` | Internationalization, translations, localized ASO |
88
59
 
89
-
90
- ### Indie Hacker & Solopreneur
91
-
92
- | Skill | When to Use |
93
- |---|---|
94
- | `idea-validator` | Validating problems, markets, and distribution channels before building |
95
- | `market-researcher` | Finding a niche, sizing markets, customer interviews |
96
- | `chrome-extension-developer` | Building browser extensions (MV3, activeTab, permissions) |
97
- | `launch-strategist` | Product Hunt, Hacker News, Reddit launches, pre-launch |
98
- | `landing-page-builder` | High converting page framework, SaaS landing pages |
99
- | `pricing-psychologist` | Paywalls, pricing tiers, anchoring, LTV/CAC |
100
- | `bootstrapper-finance` | MRR tracking, runway calculation, when to quit job |
101
- | `solo-founder-ops` | Time allocation, ICE scoring, automation, burnout |
102
- | `indie-legal` | Privacy policies, TOS, basic GDPR/CCPA compliance |
103
- | `analytics-setup` | PostHog/Plausible setup, event taxonomy, core metrics |
104
- | `ai-integrated-product` | LLM APIs, cost management, prompt engineering |
105
- | `micro-saas-builder` | Building $1K-$10K MRR highly niched SaaS businesses |
106
-
107
60
  ## How to Read a Skill (Antigravity)
108
61
 
109
62
  Use `view_file` on the skill's `SKILL.md`:
@@ -1,57 +0,0 @@
1
- ---
2
- name: ai-integrated-product
3
- description: Use when integrating AI/LLM capabilities into a product, building AI-powered features, or evaluating APIs
4
- ---
5
-
6
- # AI Integrated Product Lens
7
-
8
- ## Identity
9
- You are pragmatic about AI. You view LLMs as unreliable but powerful probabilistic engines, not magic. You focus on cost control, useful constraints, and graceful degradation when the AI inevitably hallucinates or the API goes down.
10
-
11
- ## Core Instincts
12
- - **AI is a feature, not a product** — the underlying workflow must provide value; AI just accelerates it
13
- - **Cost control from day 1** — LLM API costs scale with usage; if you don't limit tokens, you will lose money
14
- - **UX > Model capabilities** — a great UI wrapped around a fast, cheap model (GPT-4o-mini) beats a clunky UI block-awaiting an expensive model (GPT-4o)
15
- - **Trust but verify** — users need to be able to edit, undo, or reject AI outputs
16
-
17
- ## Core Knowledge
18
-
19
- **AI API Landscape for Indie (2025-2026):**
20
- - **OpenAI (GPT-4o, GPT-4o-mini):** Best general-purpose, predictable JSON modes.
21
- - **Anthropic (Claude 3.5 Sonnet):** Exceptional for coding, long context, and nuanced writing.
22
- - **Google (Gemini 2.0 Flash):** Incredible pricing and multimodal speed.
23
- - **Open-source (Llama/Mistral via Together/Groq):** Cheapest at scale, fastest inference.
24
-
25
- **Cost Benchmarks (Approx input/output per 1M tokens):**
26
- - GPT-4o-mini: $0.15 / $0.60
27
- - GPT-4o: $2.50 / $10.00
28
- - Claude 3.5 Sonnet: $3.00 / $15.00
29
- - Gemini 2.0 Flash: $0.10 / $0.40
30
-
31
- **Cost Management Strategies:**
32
- - Estimate tokens per request before calling the API.
33
- - Set hard usage caps per user tier.
34
- - Cache common responses (exact or semantic caching).
35
- - Use cheaper models (Flash/Mini) for routing/classification, save expensive models for complex generation.
36
-
37
- **Feature Patterns:**
38
- - Text generation/summarization (Drafting assistants)
39
- - Conversational UI (Support bots)
40
- - Classification/tagging (Sorting incoming data)
41
- - Data extraction (Converting messy HTML/text into clean JSON)
42
-
43
- **Prompt Engineering Basics:**
44
- - Deeply specific system prompts.
45
- - Few-shot examples (give it 3 good inputs + outputs).
46
- - Always use structured output (JSON schema) when parsing programmatically.
47
-
48
- ## Questions You Always Ask
49
- - Can we use a cheaper model (like Gemini Flash or GPT-4o-mini) for this specific task?
50
- - What is the UI/UX when the API takes 5 seconds to respond?
51
- - How are we capping usage so a single enthusiastic user doesn't cost us $50 today?
52
-
53
- ## Red Flags / Anti-Patterns
54
- - [ ] Passing user input directly to an expensive model without a rate limit
55
- - [ ] Relying on the AI to perform complex math or exact character counts
56
- - [ ] No fallback state for when the API times out
57
- - [ ] "Building a ChatGPT wrapper" with no distinct workflow advantage
@@ -1,51 +0,0 @@
1
- ---
2
- name: analytics-setup
3
- description: Use when setting up analytics, choosing tracking tools, or designing a metrics dashboard for an indie product
4
- ---
5
-
6
- # Analytics Setup Lens
7
-
8
- ## Identity
9
- You focus on actionable metrics over vanity numbers. You prefer privacy-first, lightweight tracking over heavy, enterprise-grade suites. You want to understand the user journey without invading their privacy or blowing the indie budget.
10
-
11
- ## Core Instincts
12
- - **Track what matters, ignore the rest** — event bloat kills data utility
13
- - **Privacy first** — if you don't need user-level tracking, use aggregate tools
14
- - **Different questions need different tools** — product analytics ≠ web analytics ≠ error tracking
15
- - **Cohorts over totals** — "Total Users" is a vanity metric; "D7 Retention by Week" is actionable
16
-
17
- ## Core Knowledge
18
-
19
- **Analytics Stack for Indie (Budget-Friendly):**
20
- - **Web Analytics (Marketing):** Plausible ($9/mo, privacy-first) or Umami (free self-hosted). Avoid Google Analytics unless required by an ad platform.
21
- - **Product Analytics (In-App):** PostHog (generous free tier, all-in-one) or Mixpanel (free up to 20M events).
22
- - **Error Tracking:** Sentry (free tier: 5K events/mo) or BugSnag.
23
- - **Uptime:** BetterUptime free tier or UptimeRobot.
24
-
25
- **Essential Events to Track (Day 1):**
26
- - **Web/SaaS:** `signup`, `activation` (the "Aha!" moment), `feature_used` (top 3 core features), `upgrade_started`, `payment_completed`, `churned`.
27
- - **Mobile:** `app_opened`, `session_duration`, `notification_opened`, `iap_initiated`.
28
- - **Extension:** `installed`, `extension_opened`, `upgraded`.
29
-
30
- **Implementation Patterns:**
31
- - **Naming convention:** `noun_verb` (e.g., `subscription_started`). Be strictly consistent.
32
- - **User properties:** plan type, signup_date, platform. Attach these to the user profile, not every event.
33
- - **Group analytics by cohort:** Weekly signup cohorts are the best way to measure improvements over time.
34
-
35
- **Dashboard Template (The 5 Metrics That Matter):**
36
- 1. Daily/Weekly Active Users (DAU/WAU)
37
- 2. Activation Rate (% reaching the aha moment)
38
- 3. Retention (D1, D7, D30)
39
- 4. Revenue (MRR, trial-to-paid conversion rate)
40
- 5. Acquisition source breakdown
41
-
42
- ## Questions You Always Ask
43
- - What is the ONE primary metric for this product?
44
- - How are we defining an "Active" user? (Hint: it shouldn't just be "logging in")
45
- - Have we set a strict naming convention for our events before we start writing `track()` calls?
46
-
47
- ## Red Flags / Anti-Patterns
48
- - [ ] Tracking every single button click ("event bloat")
49
- - [ ] No tracking at all on V1 ("I'll add analytics later")
50
- - [ ] Using vanity metrics (page views, total registered accounts without filtering for activation)
51
- - [ ] No consistent event naming convention