100xprism 2.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (207) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +196 -0
  3. package/VERSION +1 -0
  4. package/adapters/antigravity.sh +14 -0
  5. package/adapters/claude-code.sh +160 -0
  6. package/adapters/codex.sh +13 -0
  7. package/adapters/copilot.sh +13 -0
  8. package/adapters/cursor.sh +13 -0
  9. package/adapters/gemini.sh +13 -0
  10. package/adapters/lib/__pycache__/modules.cpython-312.pyc +0 -0
  11. package/adapters/lib/modules.py +592 -0
  12. package/adapters/lib/shared.sh +83 -0
  13. package/adapters/lib/sync_plugins.py +113 -0
  14. package/adapters/windsurf.sh +15 -0
  15. package/bin/100xprism.js +29 -0
  16. package/get.sh +24 -0
  17. package/install-project.sh +82 -0
  18. package/install.sh +281 -0
  19. package/lib/adapters/windows.js +429 -0
  20. package/lib/bootstrap.js +33 -0
  21. package/lib/init.js +19 -0
  22. package/lib/install.js +18 -0
  23. package/lib/migrate.js +52 -0
  24. package/lib/platform.js +22 -0
  25. package/lib/update.js +29 -0
  26. package/modules/_lib/reference.md +77 -0
  27. package/modules/a11y-auditor/SKILL.md +151 -0
  28. package/modules/ab-test-setup/SKILL.md +266 -0
  29. package/modules/ab-test-setup/evals/evals.json +105 -0
  30. package/modules/ab-test-setup/references/sample-size-guide.md +263 -0
  31. package/modules/ab-test-setup/references/test-templates.md +277 -0
  32. package/modules/ad-creative/SKILL.md +362 -0
  33. package/modules/ad-creative/evals/evals.json +90 -0
  34. package/modules/ad-creative/references/generative-tools.md +637 -0
  35. package/modules/ad-creative/references/platform-specs.md +213 -0
  36. package/modules/ai-seo/SKILL.md +398 -0
  37. package/modules/ai-seo/evals/evals.json +90 -0
  38. package/modules/ai-seo/references/content-patterns.md +285 -0
  39. package/modules/ai-seo/references/platform-ranking-factors.md +152 -0
  40. package/modules/analytics-tracking/SKILL.md +309 -0
  41. package/modules/analytics-tracking/evals/evals.json +90 -0
  42. package/modules/analytics-tracking/references/event-library.md +260 -0
  43. package/modules/analytics-tracking/references/ga4-implementation.md +300 -0
  44. package/modules/analytics-tracking/references/gtm-implementation.md +390 -0
  45. package/modules/architect/SKILL.md +282 -0
  46. package/modules/branch/SKILL.md +105 -0
  47. package/modules/churn-prevention/SKILL.md +424 -0
  48. package/modules/churn-prevention/evals/evals.json +93 -0
  49. package/modules/churn-prevention/references/cancel-flow-patterns.md +316 -0
  50. package/modules/churn-prevention/references/dunning-playbook.md +408 -0
  51. package/modules/cloud-security/SKILL.md +240 -0
  52. package/modules/cold-email/SKILL.md +178 -0
  53. package/modules/cold-email/evals/evals.json +94 -0
  54. package/modules/cold-email/references/benchmarks.md +83 -0
  55. package/modules/cold-email/references/follow-up-sequences.md +81 -0
  56. package/modules/cold-email/references/frameworks.md +90 -0
  57. package/modules/cold-email/references/personalization.md +79 -0
  58. package/modules/cold-email/references/subject-lines.md +53 -0
  59. package/modules/commit/SKILL.md +195 -0
  60. package/modules/competitor-alternatives/SKILL.md +256 -0
  61. package/modules/competitor-alternatives/evals/evals.json +93 -0
  62. package/modules/competitor-alternatives/references/content-architecture.md +271 -0
  63. package/modules/competitor-alternatives/references/templates.md +223 -0
  64. package/modules/connect/SKILL.md +894 -0
  65. package/modules/content-strategy/SKILL.md +359 -0
  66. package/modules/content-strategy/evals/evals.json +90 -0
  67. package/modules/context-dump/SKILL.md +67 -0
  68. package/modules/copy-editing/SKILL.md +447 -0
  69. package/modules/copy-editing/evals/evals.json +89 -0
  70. package/modules/copy-editing/references/plain-english-alternatives.md +394 -0
  71. package/modules/copywriting/SKILL.md +271 -0
  72. package/modules/copywriting/evals/evals.json +111 -0
  73. package/modules/copywriting/references/cold-email-benchmarks.md +83 -0
  74. package/modules/copywriting/references/cold-email-follow-ups.md +81 -0
  75. package/modules/copywriting/references/cold-email-frameworks.md +90 -0
  76. package/modules/copywriting/references/cold-email-personalization.md +79 -0
  77. package/modules/copywriting/references/cold-email-subject-lines.md +53 -0
  78. package/modules/copywriting/references/copy-frameworks.md +344 -0
  79. package/modules/copywriting/references/email-copy-guidelines.md +113 -0
  80. package/modules/copywriting/references/email-types.md +515 -0
  81. package/modules/copywriting/references/natural-transitions.md +272 -0
  82. package/modules/copywriting/references/sequence-templates.md +168 -0
  83. package/modules/data-query/SKILL.md +58 -0
  84. package/modules/data-viz/SKILL.md +225 -0
  85. package/modules/db/SKILL.md +205 -0
  86. package/modules/db/db-engines/_router.md +24 -0
  87. package/modules/db/db-engines/athena.md +16 -0
  88. package/modules/db/db-engines/cloud-sql.md +16 -0
  89. package/modules/db/db-engines/databricks.md +14 -0
  90. package/modules/db/db-engines/oracle.md +14 -0
  91. package/modules/db/db-engines/postgres.md +15 -0
  92. package/modules/db/db-engines/presto.md +14 -0
  93. package/modules/db/db-engines/snowflake.md +14 -0
  94. package/modules/docs/SKILL.md +100 -0
  95. package/modules/email-sequence/SKILL.md +309 -0
  96. package/modules/email-sequence/evals/evals.json +93 -0
  97. package/modules/email-sequence/references/copy-guidelines.md +113 -0
  98. package/modules/email-sequence/references/email-types.md +515 -0
  99. package/modules/email-sequence/references/sequence-templates.md +168 -0
  100. package/modules/enterprise-design/SKILL.md +75 -0
  101. package/modules/eval/SKILL.md +105 -0
  102. package/modules/figma-translator/SKILL.md +49 -0
  103. package/modules/fix-bugs/SKILL.md +104 -0
  104. package/modules/form-cro/SKILL.md +429 -0
  105. package/modules/form-cro/evals/evals.json +90 -0
  106. package/modules/free-tool-strategy/SKILL.md +178 -0
  107. package/modules/free-tool-strategy/evals/evals.json +90 -0
  108. package/modules/free-tool-strategy/references/tool-types.md +217 -0
  109. package/modules/gate/SKILL.md +232 -0
  110. package/modules/grill-me/SKILL.md +59 -0
  111. package/modules/interaction-engineer/SKILL.md +49 -0
  112. package/modules/issue/SKILL.md +272 -0
  113. package/modules/launch/SKILL.md +345 -0
  114. package/modules/launch-strategy/SKILL.md +353 -0
  115. package/modules/launch-strategy/evals/evals.json +91 -0
  116. package/modules/lint/SKILL.md +126 -0
  117. package/modules/marketing-ideas/SKILL.md +167 -0
  118. package/modules/marketing-ideas/evals/evals.json +90 -0
  119. package/modules/marketing-ideas/references/ideas-by-category.md +366 -0
  120. package/modules/marketing-psychology/SKILL.md +455 -0
  121. package/modules/marketing-psychology/evals/evals.json +88 -0
  122. package/modules/motion-designer/SKILL.md +214 -0
  123. package/modules/onboarding-cro/SKILL.md +220 -0
  124. package/modules/onboarding-cro/evals/evals.json +92 -0
  125. package/modules/onboarding-cro/references/experiments.md +258 -0
  126. package/modules/orchestrate/SKILL.md +77 -0
  127. package/modules/page-cro/SKILL.md +182 -0
  128. package/modules/page-cro/evals/evals.json +111 -0
  129. package/modules/page-cro/references/experiments.md +248 -0
  130. package/modules/page-cro/references/paywall-experiments.md +164 -0
  131. package/modules/paid-ads/SKILL.md +315 -0
  132. package/modules/paid-ads/evals/evals.json +90 -0
  133. package/modules/paid-ads/references/ad-copy-templates.md +207 -0
  134. package/modules/paid-ads/references/audience-targeting.md +243 -0
  135. package/modules/paid-ads/references/platform-setup-checklists.md +277 -0
  136. package/modules/paywall-upgrade-cro/SKILL.md +227 -0
  137. package/modules/paywall-upgrade-cro/evals/evals.json +93 -0
  138. package/modules/paywall-upgrade-cro/references/experiments.md +164 -0
  139. package/modules/popup-cro/SKILL.md +453 -0
  140. package/modules/popup-cro/evals/evals.json +94 -0
  141. package/modules/pr/SKILL.md +203 -0
  142. package/modules/pricing-strategy/SKILL.md +231 -0
  143. package/modules/pricing-strategy/evals/evals.json +90 -0
  144. package/modules/pricing-strategy/references/research-methods.md +152 -0
  145. package/modules/pricing-strategy/references/tier-structure.md +232 -0
  146. package/modules/product-marketing-context/SKILL.md +241 -0
  147. package/modules/product-marketing-context/evals/evals.json +85 -0
  148. package/modules/programmatic-seo/SKILL.md +238 -0
  149. package/modules/programmatic-seo/evals/evals.json +94 -0
  150. package/modules/programmatic-seo/references/playbooks.md +308 -0
  151. package/modules/push/SKILL.md +202 -0
  152. package/modules/referral-program/SKILL.md +255 -0
  153. package/modules/referral-program/evals/evals.json +89 -0
  154. package/modules/referral-program/references/affiliate-programs.md +164 -0
  155. package/modules/referral-program/references/program-examples.md +143 -0
  156. package/modules/release/SKILL.md +293 -0
  157. package/modules/revops/SKILL.md +343 -0
  158. package/modules/revops/evals/evals.json +91 -0
  159. package/modules/revops/references/automation-playbooks.md +290 -0
  160. package/modules/revops/references/lifecycle-definitions.md +278 -0
  161. package/modules/revops/references/routing-rules.md +203 -0
  162. package/modules/revops/references/scoring-models.md +247 -0
  163. package/modules/sales-enablement/SKILL.md +349 -0
  164. package/modules/sales-enablement/evals/evals.json +91 -0
  165. package/modules/sales-enablement/references/deck-frameworks.md +263 -0
  166. package/modules/sales-enablement/references/demo-scripts.md +355 -0
  167. package/modules/sales-enablement/references/objection-library.md +270 -0
  168. package/modules/sales-enablement/references/one-pager-templates.md +208 -0
  169. package/modules/schema-markup/SKILL.md +179 -0
  170. package/modules/schema-markup/evals/evals.json +87 -0
  171. package/modules/schema-markup/references/schema-examples.md +398 -0
  172. package/modules/security/SKILL.md +138 -0
  173. package/modules/seo-audit/SKILL.md +412 -0
  174. package/modules/seo-audit/evals/evals.json +136 -0
  175. package/modules/seo-audit/references/ai-writing-detection.md +200 -0
  176. package/modules/seo-audit/references/content-patterns.md +285 -0
  177. package/modules/seo-audit/references/platform-ranking-factors.md +152 -0
  178. package/modules/signup-flow-cro/SKILL.md +359 -0
  179. package/modules/signup-flow-cro/evals/evals.json +88 -0
  180. package/modules/site-architecture/SKILL.md +357 -0
  181. package/modules/site-architecture/evals/evals.json +88 -0
  182. package/modules/site-architecture/references/mermaid-templates.md +216 -0
  183. package/modules/site-architecture/references/navigation-patterns.md +305 -0
  184. package/modules/site-architecture/references/site-type-templates.md +293 -0
  185. package/modules/social-content/SKILL.md +278 -0
  186. package/modules/social-content/evals/evals.json +92 -0
  187. package/modules/social-content/references/platforms.md +170 -0
  188. package/modules/social-content/references/post-templates.md +177 -0
  189. package/modules/social-content/references/reverse-engineering.md +195 -0
  190. package/modules/spec/SKILL.md +81 -0
  191. package/modules/subagents/SKILL.md +123 -0
  192. package/modules/techdebt/SKILL.md +71 -0
  193. package/modules/terminal-setup/SKILL.md +49 -0
  194. package/modules/test/SKILL.md +493 -0
  195. package/modules/test/references/e2e-patterns.md +294 -0
  196. package/modules/update-claude-md/SKILL.md +52 -0
  197. package/modules/visual-system-architect/SKILL.md +53 -0
  198. package/package.json +44 -0
  199. package/plugins/plugins.json +43 -0
  200. package/shell/aliases.sh +24 -0
  201. package/shell/check-update.sh +212 -0
  202. package/templates/.env.example +199 -0
  203. package/templates/docker-compose.md +46 -0
  204. package/templates/node-frontend.md +56 -0
  205. package/templates/node-fullstack.md +59 -0
  206. package/templates/python-api.md +57 -0
  207. package/update.sh +231 -0
@@ -0,0 +1,75 @@
1
+ ---
2
+ name: enterprise-design
3
+ description: Produce a comprehensive technical blueprint for a web product or SaaS, suitable for implementation in Figma Make, engineering sprints, and cloud deployment.
4
+ category: design
5
+ tier: on-demand
6
+ slash_command: /enterprise-design
7
+ model: opus
8
+ ---
9
+
10
+ # Enterprise Design — Technical Blueprint Generator
11
+
12
+ Produce a comprehensive technical blueprint for a web product or SaaS, suitable for implementation in Figma Make, engineering sprints, and cloud deployment.
13
+
14
+ ## How to use
15
+ - `/enterprise-design <product or feature>` — full blueprint
16
+ - `/enterprise-design ia` — information architecture + sitemap only
17
+ - `/enterprise-design api` — API surface definition only
18
+ - `/enterprise-design data` — data architecture + entity model only
19
+ - `/enterprise-design ux` — user journeys + component inventory only
20
+ - `/enterprise-design stack` — tech stack recommendation only
21
+ - `/enterprise-design review` — audit current project against enterprise standards
22
+
23
+ ---
24
+
25
+ ## Step 0 — Load context
26
+
27
+ ```bash
28
+ PROJECT_ROOT=$(git rev-parse --show-toplevel)
29
+ INSTRUCTION_FILE=$(for f in CLAUDE.md AGENTS.md .cursorrules .windsurfrules .github/copilot-instructions.md GEMINI.md; do [ -f "$PROJECT_ROOT/$f" ] && echo "$PROJECT_ROOT/$f" && break; done)
30
+ [ -n "$INSTRUCTION_FILE" ] && head -100 "$INSTRUCTION_FILE"
31
+ ```
32
+
33
+ Establish: site/product type, primary audience, core capabilities (3–5), technical priorities.
34
+
35
+ ---
36
+
37
+ ## Deliverables
38
+
39
+ Produce a structured technical blueprint covering:
40
+
41
+ ### 1. Information Architecture
42
+ Complete sitemap with primary, secondary, semantic, and neutral path hierarchy. URL conventions (kebab-case, hierarchy reflects ownership, pagination via query params).
43
+
44
+ ### 2. User Journey Mapping
45
+ Three critical conversion paths: acquisition→activation, free→paid, core workflow loop. Include drop-off points and success metrics.
46
+
47
+ ### 3. Data Architecture
48
+ Entity relationships and schema models. Indexing strategy (FK indexes, composite for pagination, GIN for full-text). Caching tier (Redis key patterns + TTLs). Analytics tier (event schema for BigQuery).
49
+
50
+ ### 4. API Surface Definition
51
+ Core REST endpoints (auth, primary entity CRUD, billing, admin). Standard response envelope. Third-party integrations table. Rate limiting per tier.
52
+
53
+ ### 5. Component Inventory (30+)
54
+ Layout, navigation, data display, form, feedback, and feature-specific components. For each: purpose + key props.
55
+
56
+ ### 6. Page Blueprints
57
+ Structural wireframe descriptions for: landing page, dashboard, detail/entity view, settings page.
58
+
59
+ ### 7. Technology Stack
60
+ Recommended stack with rationale for: frontend, styling, state, backend, database, cache, auth, payments, email, hosting, CI/CD, observability, IaC.
61
+
62
+ ### 8. Performance Benchmarks
63
+ Core Web Vitals targets (LCP < 1.8s, INP < 100ms, CLS < 0.05). API latency targets (P50/P95). Performance budget per page.
64
+
65
+ ### 9. SEO Framework
66
+ URL conventions, meta structure per page type, schema markup strategy, Core Web Vitals for SEO.
67
+
68
+ ### 10. Enterprise Considerations (if applicable)
69
+ Domain-Driven Design bounded contexts, API governance, zero-trust security, multi-region DR. Only include if product is at scale (> 10K users / multi-team / regulated).
70
+
71
+ ---
72
+
73
+ ## Output Format
74
+
75
+ Structured specification with clear headings, bullet points, and numbered lists throughout. Suitable for direct handoff to Figma Make or engineering sprint planning.
@@ -0,0 +1,105 @@
1
+ ---
2
+ name: eval
3
+ description: Run a module's evals to check it triggers correctly and produces good output. Use when the user wants to evaluate a skill, run evals, grade eval assertions, score skill quality, or asks "do my skills still trigger correctly" or "did this change break a skill". Fans eval cases out to parallel subagents and has Haiku 4.5 grade each assertion into a pass/fail scorecard.
4
+ category: quality
5
+ tier: on-demand
6
+ slash_command: /eval
7
+ allowed-tools: Bash Read Agent
8
+ ---
9
+
10
+ # Eval — Run skill evals and score them
11
+
12
+ Turns the dormant `modules/<slug>/evals/evals.json` files into a real, graded scorecard:
13
+ does the skill trigger on its prompts, and does its output satisfy each assertion?
14
+
15
+ The deterministic engine is `scripts/eval-harness.py` (discovery, validation, work-list,
16
+ scorecard rendering — no model calls). **Grading is your job**: fan the cases out to
17
+ subagents and have Haiku 4.5 judge every assertion with structured output. Installed path
18
+ is `~/100xprism/scripts/eval-harness.py`; in a checkout it's `scripts/eval-harness.py`.
19
+
20
+ ## Phase 0 — Pick the target
21
+
22
+ ```bash
23
+ # one module, everything, or just what changed on this branch:
24
+ python3 ~/100xprism/scripts/eval-harness.py validate --module <slug>
25
+ python3 ~/100xprism/scripts/eval-harness.py validate --all
26
+ python3 ~/100xprism/scripts/eval-harness.py validate --changed origin/main
27
+ ```
28
+
29
+ Fix any structural errors before grading — a malformed eval file can't be scored.
30
+
31
+ ## Phase 1 — Get the work-list
32
+
33
+ ```bash
34
+ python3 ~/100xprism/scripts/eval-harness.py plan --module <slug> --json
35
+ ```
36
+
37
+ This emits `{ "modules": [ { "module", "cases": [ { id, prompt, expected_output,
38
+ assertions[], files[] } ] } ] }`. Each `(case, assertion)` is one unit of work.
39
+
40
+ ## Phase 2 — Grade with parallel subagents (Haiku 4.5)
41
+
42
+ For each case, dispatch **one subagent** (use the **subagents** skill / `Agent` tool, or a
43
+ Workflow fan-out) that:
44
+
45
+ 1. **Runs the prompt against the skill.** Load the target skill (its SKILL.md) as
46
+ context, then answer the case `prompt` exactly as the assistant would — this is the
47
+ *candidate response*. Note whether the skill would have auto-triggered on that prompt
48
+ (trigger accuracy) separately from output quality.
49
+ 2. **Grades each assertion.** Spawn a Haiku 4.5 grader (`model: claude-haiku-4-5`) that,
50
+ given the prompt, the candidate response, the `expected_output`, and one assertion,
51
+ returns **structured output**:
52
+
53
+ ```json
54
+ { "module": "<slug>", "case_id": <id>, "assertion": "<text>", "passed": true|false, "reason": "<one line>" }
55
+ ```
56
+
57
+ Run cases in parallel (independent), cap concurrency sanely, and collect every grader
58
+ object into one results array. Default cheap (Haiku) and only escalate a genuinely
59
+ ambiguous assertion to a stronger model.
60
+
61
+ Write the collected array to a results file:
62
+
63
+ ```bash
64
+ # results.json = the JSON array of grader objects from every subagent
65
+ ```
66
+
67
+ ## Phase 3 — Render the scorecard
68
+
69
+ ```bash
70
+ python3 ~/100xprism/scripts/eval-harness.py score --results results.json
71
+ ```
72
+
73
+ Produces a per-assertion ✓/✗ scorecard with reasons, per-case and overall tallies, and
74
+ exits non-zero if any assertion failed. Use `--json` for machine output.
75
+
76
+ ```
77
+ === marketing-psychology ===
78
+ case 1: 6/7 assertions passed
79
+ ✓ Checks for product-marketing-context.md
80
+ ✗ References specific mental models by name — named only two of the taxonomy
81
+ scorecard: 41/43 assertions passed across 1 module(s)
82
+ ```
83
+
84
+ ## Trigger-overlap lint (no model needed)
85
+
86
+ Catch skills that would fire on each other's prompts before they ever reach grading:
87
+
88
+ ```bash
89
+ python3 ~/100xprism/scripts/trigger-overlap.py # report flagged pairs
90
+ python3 ~/100xprism/scripts/trigger-overlap.py --strict # fail on NEW (non-allow-listed) overlaps
91
+ ```
92
+
93
+ Intentional overlaps live in `scripts/trigger-overlap-allow.txt`. If a real change adds a
94
+ new high-overlap pair, either differentiate the two descriptions or add the pair to the
95
+ allow-list with a note.
96
+
97
+ ## Principles
98
+
99
+ - **Default cheap.** Haiku grades; escalate only ambiguous assertions.
100
+ - **Structured output, not prose.** Every grader returns the object above so the scorecard
101
+ is deterministic.
102
+ - **Separate trigger accuracy from output quality.** A skill can answer well yet never
103
+ have triggered — report both.
104
+ - **Per-PR vs nightly.** Grade only `--changed` modules on a PR; the nightly CI run covers
105
+ all modules that ship evals.
@@ -0,0 +1,49 @@
1
+ ---
2
+ name: figma-translator
3
+ description: Translate any technical specification into five precise, self-contained Figma Make prompts ready to paste and generate. Use when you have an enterprise-design, visual-system-architect, or copywriting output and need to convert it into Figma Make–compatible prompts covering hero, features, social proof, CTA, and mobile views.
4
+ category: design
5
+ tier: on-demand
6
+ allowed-tools: Read Write
7
+ ---
8
+
9
+ You are a specialist in translating technical specifications into optimized Figma Make prompts. Convert the provided specification into five separate, high-precision prompts.
10
+
11
+ ## Required Input
12
+
13
+ Paste the full technical specification to translate:
14
+ ```
15
+ [PASTE SPECIFICATION HERE]
16
+ ```
17
+
18
+ ## Each Prompt Must
19
+
20
+ 1. **Begin with the final visual outcome** — what does the finished screen look like?
21
+ 2. **Embed brand identity context** — color, typography, and tone
22
+ 3. **Define interaction behaviors** — hover, click, scroll, and animated transitions
23
+ 4. **Specify responsive adaptation** — how it adapts across breakpoints
24
+ 5. **Clearly request structural sections** — hero, feature grid, CTA, footer
25
+
26
+ ## Required Format Per Prompt
27
+
28
+ ```
29
+ "Create a [TYPE] website with a [MOOD] aesthetic.
30
+ Use [PRIMARY COLOR] and [FONT SYSTEM].
31
+ Include:
32
+ 1) Hero with [SPECIFIC ELEMENTS]
33
+ 2) Interactive feature grid with [DEFINED BEHAVIORS]
34
+ 3) Conversion-focused CTA block
35
+ 4) Structured footer.
36
+ Ensure full responsiveness and smooth [ANIMATION STYLE] transitions."
37
+ ```
38
+
39
+ ## Principles
40
+
41
+ - Each prompt must be self-contained — Figma Make has no memory between prompts
42
+ - Specificity is everything: vague prompts produce generic output
43
+ - Lead with visual outcome, not technical requirements
44
+ - Name colors, font names, and animation styles explicitly — no abstract descriptions
45
+ - Five prompts should cover: hero, features, social proof, CTA flow, and mobile view
46
+
47
+ ## Output
48
+
49
+ Return exactly 5 numbered Figma Make prompts, ready to copy-paste.
@@ -0,0 +1,104 @@
1
+ ---
2
+ name: fix-bugs
3
+ description: Autonomously fix bugs from any source — Slack threads, failing CI tests, docker logs, or a plain description. Use when you have a bug report or failing test and want Claude to investigate and fix without step-by-step guidance.
4
+ category: engineering
5
+ tier: core
6
+ slash_command: /fix
7
+ allowed-tools: Bash Read Grep Glob Edit Write
8
+ ---
9
+
10
+ # Fix — Autonomous Bug Fixer
11
+
12
+ Fix the bug described or linked. Investigate and fix without step-by-step guidance.
13
+
14
+ ## Do NOT ask for permission — investigate and fix autonomously.
15
+
16
+ ## How to use
17
+ - `/fix` — fix the most recent failing CI run
18
+ - `/fix <description>` — fix from plain description
19
+ - `/fix <docker logs paste>` — trace error to root cause and fix
20
+ - `/fix <Slack URL or paste>` — read thread, extract bug report, fix
21
+
22
+ ---
23
+
24
+ ## Phase 1 — Gather context
25
+
26
+ Read the error in full — message, stack trace, or thread. Do not skip this step.
27
+
28
+ **If the root cause is not obvious from the error/stack/logs → invoke the
29
+ `systematic-debugging` skill first to diagnose before attempting any fix.** `/fix` assumes
30
+ you know (or can quickly find) what's broken; for mysterious failures, diagnosis comes
31
+ first. Don't guess.
32
+
33
+ Detect the stack so context-gathering matches the project (canonical block — source:
34
+ `_lib/reference.md`):
35
+
36
+ ```bash
37
+ PROJECT_ROOT=$(git rev-parse --show-toplevel); cd "$PROJECT_ROOT"
38
+ CI_SYSTEM=""; ls "$PROJECT_ROOT"/.github/workflows/*.y*ml >/dev/null 2>&1 && CI_SYSTEM=github-actions
39
+ TEST_RUNNER=""
40
+ grep -q '"vitest"' package.json */package.json 2>/dev/null && TEST_RUNNER=vitest
41
+ [ -z "$TEST_RUNNER" ] && grep -q '"jest"' package.json */package.json 2>/dev/null && TEST_RUNNER=jest
42
+ [ -z "$TEST_RUNNER" ] && { [ -f pyproject.toml ] || ls requirements*.txt >/dev/null 2>&1; } && TEST_RUNNER=pytest
43
+ [ -z "$TEST_RUNNER" ] && [ -f go.mod ] && TEST_RUNNER="go test"
44
+ [ -z "$TEST_RUNNER" ] && [ -f Cargo.toml ] && TEST_RUNNER="cargo test"
45
+
46
+ # If fixing CI on a GitHub-Actions repo with gh available: read the most recent failure
47
+ if [ "$CI_SYSTEM" = github-actions ] && command -v gh >/dev/null 2>&1; then
48
+ gh run list --limit 3
49
+ gh run view --log-failed "$(gh run list --limit 1 --json databaseId -q '.[0].databaseId')" 2>/dev/null | tail -80
50
+ fi
51
+ ```
52
+
53
+ For non-GitHub CI, read the failing job from that provider (GitLab/CircleCI UI or CLI).
54
+ For docker logs: parse for ERROR/CRITICAL lines, identify service + file.
55
+ For Slack thread: extract the bug report and reproduction steps.
56
+
57
+ ---
58
+
59
+ ## Phase 2 — Locate the code
60
+
61
+ Find the exact file(s) and line(s) responsible. Use Grep/Glob aggressively — do not guess.
62
+
63
+ ```bash
64
+ cd "$PROJECT_ROOT"
65
+ git log --oneline -10
66
+ git status
67
+ ```
68
+
69
+ Read the surrounding code. Understand the intent before touching anything.
70
+
71
+ ---
72
+
73
+ ## Phase 3 — Fix
74
+
75
+ Make the **minimal correct change**. Do not refactor unrelated code. Do not add workarounds or feature flags — fix the root cause.
76
+
77
+ If the root cause cannot be determined: say so clearly. Do not guess.
78
+
79
+ ---
80
+
81
+ ## Phase 4 — Verify
82
+
83
+ Run the specific failing test or reproduce the failure condition, using the
84
+ **detected** `$TEST_RUNNER` from Phase 1 (or just defer to `/test`, which auto-detects
85
+ every layer):
86
+
87
+ ```bash
88
+ # Target only the failing test(s) — substitute the file/name that was failing.
89
+ case "$TEST_RUNNER" in
90
+ vitest|jest) npx "$TEST_RUNNER" run <failing-test> 2>&1 | tail -30 ;;
91
+ pytest) ./venv/bin/pytest <failing-test> -v --tb=short -q 2>&1 | tail -30 ;;
92
+ "go test") go test ./<pkg> -run '<TestName>' 2>&1 | tail -30 ;;
93
+ "cargo test") cargo test <test_name> 2>&1 | tail -30 ;;
94
+ *) echo "No test runner detected — run /test, or reproduce the failure manually" ;;
95
+ esac
96
+ ```
97
+
98
+ **GATE: The specific failure condition no longer occurs.**
99
+
100
+ ---
101
+
102
+ ## Phase 5 — Summarize
103
+
104
+ One sentence: what was wrong and what you changed. Then run `/commit`.