@su-record/vibe 2.7.16 → 2.7.18

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 (249) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +153 -134
  3. package/LICENSE +21 -21
  4. package/README.md +449 -449
  5. package/agents/architect-low.md +41 -41
  6. package/agents/architect-medium.md +59 -59
  7. package/agents/architect.md +80 -80
  8. package/agents/build-error-resolver.md +115 -115
  9. package/agents/compounder.md +261 -261
  10. package/agents/diagrammer.md +178 -178
  11. package/agents/docs/api-documenter.md +99 -99
  12. package/agents/docs/changelog-writer.md +93 -93
  13. package/agents/e2e-tester.md +294 -294
  14. package/agents/explorer-low.md +42 -42
  15. package/agents/explorer-medium.md +59 -59
  16. package/agents/explorer.md +48 -48
  17. package/agents/implementer-low.md +43 -43
  18. package/agents/implementer-medium.md +52 -52
  19. package/agents/implementer.md +54 -54
  20. package/agents/junior-mentor.md +141 -141
  21. package/agents/planning/requirements-analyst.md +84 -84
  22. package/agents/planning/ux-advisor.md +83 -83
  23. package/agents/qa/acceptance-tester.md +86 -86
  24. package/agents/qa/edge-case-finder.md +93 -93
  25. package/agents/refactor-cleaner.md +143 -143
  26. package/agents/research/best-practices-agent.md +199 -199
  27. package/agents/research/codebase-patterns-agent.md +157 -157
  28. package/agents/research/framework-docs-agent.md +188 -188
  29. package/agents/research/security-advisory-agent.md +213 -213
  30. package/agents/review/architecture-reviewer.md +107 -107
  31. package/agents/review/complexity-reviewer.md +116 -116
  32. package/agents/review/data-integrity-reviewer.md +88 -88
  33. package/agents/review/git-history-reviewer.md +103 -103
  34. package/agents/review/performance-reviewer.md +86 -86
  35. package/agents/review/python-reviewer.md +150 -150
  36. package/agents/review/rails-reviewer.md +139 -139
  37. package/agents/review/react-reviewer.md +144 -144
  38. package/agents/review/security-reviewer.md +80 -80
  39. package/agents/review/simplicity-reviewer.md +140 -140
  40. package/agents/review/test-coverage-reviewer.md +116 -116
  41. package/agents/review/typescript-reviewer.md +127 -127
  42. package/agents/searcher.md +54 -54
  43. package/agents/simplifier.md +120 -120
  44. package/agents/tester.md +49 -49
  45. package/agents/ui/ui-a11y-auditor.md +93 -93
  46. package/agents/ui/ui-antipattern-detector.md +94 -94
  47. package/agents/ui/ui-dataviz-advisor.md +69 -69
  48. package/agents/ui/ui-design-system-gen.md +57 -57
  49. package/agents/ui/ui-industry-analyzer.md +49 -49
  50. package/agents/ui/ui-layout-architect.md +65 -65
  51. package/agents/ui/ui-stack-implementer.md +68 -68
  52. package/agents/ui/ux-compliance-reviewer.md +81 -81
  53. package/agents/ui-previewer.md +258 -258
  54. package/commands/vibe.analyze.md +379 -379
  55. package/commands/vibe.review.md +607 -607
  56. package/commands/vibe.run.md +2124 -2124
  57. package/commands/vibe.spec.md +1195 -1195
  58. package/commands/vibe.spec.review.md +569 -569
  59. package/commands/vibe.utils.md +413 -413
  60. package/commands/vibe.verify.md +484 -484
  61. package/dist/cli/collaborator.js +52 -52
  62. package/dist/cli/commands/evolution.js +12 -12
  63. package/dist/cli/commands/info.js +51 -51
  64. package/dist/cli/commands/init.js +5 -5
  65. package/dist/cli/commands/remove.js +14 -14
  66. package/dist/cli/commands/sentinel.js +27 -27
  67. package/dist/cli/commands/skills.js +5 -5
  68. package/dist/cli/commands/slack.js +10 -10
  69. package/dist/cli/commands/telegram.js +12 -12
  70. package/dist/cli/commands/upgrade.d.ts +3 -3
  71. package/dist/cli/commands/upgrade.d.ts.map +1 -1
  72. package/dist/cli/commands/upgrade.js +24 -3
  73. package/dist/cli/commands/upgrade.js.map +1 -1
  74. package/dist/cli/detect.js +32 -32
  75. package/dist/cli/index.js +51 -51
  76. package/dist/cli/llm/claude-commands.js +16 -16
  77. package/dist/cli/llm/config.js +18 -18
  78. package/dist/cli/llm/gemini-commands.js +16 -16
  79. package/dist/cli/llm/gpt-commands.js +19 -19
  80. package/dist/cli/llm/help.js +21 -21
  81. package/dist/cli/postinstall/cursor-agents.js +32 -32
  82. package/dist/cli/postinstall/cursor-rules.js +83 -83
  83. package/dist/cli/postinstall/cursor-skills.js +743 -743
  84. package/dist/cli/setup/Provisioner.js +42 -42
  85. package/dist/infra/lib/DeepInit.js +24 -24
  86. package/dist/infra/lib/IterationTracker.js +11 -11
  87. package/dist/infra/lib/PythonParser.js +108 -108
  88. package/dist/infra/lib/ReviewRace.js +96 -96
  89. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  90. package/dist/infra/lib/SkillQualityGate.js +9 -9
  91. package/dist/infra/lib/SkillRepository.js +159 -159
  92. package/dist/infra/lib/UltraQA.js +99 -99
  93. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  94. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  95. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  96. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  97. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  98. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  99. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  100. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  101. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  102. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  103. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  104. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  105. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  106. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  107. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  108. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  109. package/dist/infra/lib/gemini/orchestration.js +5 -5
  110. package/dist/infra/lib/gpt/orchestration.js +4 -4
  111. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  112. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  113. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  114. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  115. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  116. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  117. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  118. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  119. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts +52 -0
  120. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts.map +1 -0
  121. package/dist/infra/lib/telemetry/SkillTelemetry.js +117 -0
  122. package/dist/infra/lib/telemetry/SkillTelemetry.js.map +1 -0
  123. package/dist/infra/lib/telemetry/SkillTelemetry.test.d.ts +2 -0
  124. package/dist/infra/lib/telemetry/SkillTelemetry.test.d.ts.map +1 -0
  125. package/dist/infra/lib/telemetry/SkillTelemetry.test.js +91 -0
  126. package/dist/infra/lib/telemetry/SkillTelemetry.test.js.map +1 -0
  127. package/dist/infra/orchestrator/AgentManager.js +12 -12
  128. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  129. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  130. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  131. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  132. package/dist/test-helpers/index.d.ts +36 -0
  133. package/dist/test-helpers/index.d.ts.map +1 -0
  134. package/dist/test-helpers/index.js +85 -0
  135. package/dist/test-helpers/index.js.map +1 -0
  136. package/dist/test-helpers/index.test.d.ts +2 -0
  137. package/dist/test-helpers/index.test.d.ts.map +1 -0
  138. package/dist/test-helpers/index.test.js +92 -0
  139. package/dist/test-helpers/index.test.js.map +1 -0
  140. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  141. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  142. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  143. package/dist/tools/memory/getMemoryGraph.js +12 -12
  144. package/dist/tools/memory/getSessionContext.js +9 -9
  145. package/dist/tools/memory/linkMemories.js +14 -14
  146. package/dist/tools/memory/listMemories.js +4 -4
  147. package/dist/tools/memory/recallMemory.js +4 -4
  148. package/dist/tools/memory/saveMemory.js +4 -4
  149. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  150. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  151. package/dist/tools/semantic/astGrep.test.js +6 -6
  152. package/dist/tools/spec/prdParser.test.js +171 -171
  153. package/dist/tools/spec/specGenerator.js +169 -169
  154. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  155. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  156. package/hooks/gemini-hooks.json +73 -73
  157. package/hooks/hooks.json +137 -137
  158. package/hooks/scripts/code-check.js +77 -77
  159. package/hooks/scripts/context-save.js +212 -212
  160. package/hooks/scripts/hud-status.js +291 -291
  161. package/hooks/scripts/keyword-detector.js +214 -214
  162. package/hooks/scripts/llm-orchestrate.js +475 -475
  163. package/hooks/scripts/post-edit.js +32 -32
  164. package/hooks/scripts/pre-tool-guard.js +125 -125
  165. package/hooks/scripts/prompt-dispatcher.js +185 -185
  166. package/hooks/scripts/sentinel-guard.js +104 -104
  167. package/hooks/scripts/session-start.js +106 -106
  168. package/hooks/scripts/stop-notify.js +209 -209
  169. package/hooks/scripts/utils.js +100 -100
  170. package/languages/csharp-unity.md +515 -515
  171. package/languages/gdscript-godot.md +470 -470
  172. package/languages/ruby-rails.md +489 -489
  173. package/languages/typescript-angular.md +433 -433
  174. package/languages/typescript-astro.md +416 -416
  175. package/languages/typescript-electron.md +406 -406
  176. package/languages/typescript-nestjs.md +524 -524
  177. package/languages/typescript-svelte.md +407 -407
  178. package/languages/typescript-tauri.md +365 -365
  179. package/package.json +123 -121
  180. package/skills/agents-md/SKILL.md +120 -120
  181. package/skills/arch-guard/SKILL.md +180 -180
  182. package/skills/brand-assets/SKILL.md +146 -146
  183. package/skills/capability-loop/SKILL.md +167 -167
  184. package/skills/characterization-test/SKILL.md +206 -206
  185. package/skills/commerce-patterns/SKILL.md +63 -63
  186. package/skills/commit-push-pr/SKILL.md +75 -75
  187. package/skills/context7-usage/SKILL.md +105 -105
  188. package/skills/core-capabilities/SKILL.md +13 -13
  189. package/skills/e2e-commerce/SKILL.md +61 -61
  190. package/skills/exec-plan/SKILL.md +147 -147
  191. package/skills/frontend-design/SKILL.md +12 -12
  192. package/skills/git-worktree/SKILL.md +72 -72
  193. package/skills/handoff/SKILL.md +109 -109
  194. package/skills/parallel-research/SKILL.md +87 -87
  195. package/skills/priority-todos/SKILL.md +63 -63
  196. package/skills/seo-checklist/SKILL.md +57 -57
  197. package/skills/techdebt/SKILL.md +122 -122
  198. package/skills/tool-fallback/SKILL.md +103 -103
  199. package/skills/typescript-advanced-types/SKILL.md +66 -66
  200. package/skills/ui-ux-pro-max/SKILL.md +221 -221
  201. package/skills/vercel-react-best-practices/SKILL.md +59 -59
  202. package/skills/video-production/SKILL.md +51 -51
  203. package/vibe/config.json +29 -29
  204. package/vibe/constitution.md +227 -227
  205. package/vibe/rules/principles/communication-guide.md +98 -98
  206. package/vibe/rules/principles/development-philosophy.md +52 -52
  207. package/vibe/rules/principles/quick-start.md +102 -102
  208. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  209. package/vibe/rules/quality/checklist.md +276 -276
  210. package/vibe/rules/quality/performance.md +236 -236
  211. package/vibe/rules/quality/testing-strategy.md +440 -440
  212. package/vibe/rules/standards/anti-patterns.md +541 -541
  213. package/vibe/rules/standards/code-structure.md +291 -291
  214. package/vibe/rules/standards/complexity-metrics.md +313 -313
  215. package/vibe/rules/standards/git-workflow.md +237 -237
  216. package/vibe/rules/standards/naming-conventions.md +198 -198
  217. package/vibe/rules/standards/security.md +305 -305
  218. package/vibe/rules/writing/document-style.md +74 -74
  219. package/vibe/setup.sh +31 -31
  220. package/vibe/templates/constitution-template.md +252 -252
  221. package/vibe/templates/contract-backend-template.md +526 -526
  222. package/vibe/templates/contract-frontend-template.md +599 -599
  223. package/vibe/templates/feature-template.md +96 -96
  224. package/vibe/templates/spec-template.md +221 -221
  225. package/vibe/ui-ux-data/charts.csv +26 -26
  226. package/vibe/ui-ux-data/colors.csv +97 -97
  227. package/vibe/ui-ux-data/icons.csv +101 -101
  228. package/vibe/ui-ux-data/landing.csv +31 -31
  229. package/vibe/ui-ux-data/products.csv +96 -96
  230. package/vibe/ui-ux-data/react-performance.csv +45 -45
  231. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  232. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  233. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  234. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  235. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  236. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  237. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  238. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  239. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  240. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  241. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  242. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  243. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  244. package/vibe/ui-ux-data/styles.csv +68 -68
  245. package/vibe/ui-ux-data/typography.csv +57 -57
  246. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  247. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  248. package/vibe/ui-ux-data/version.json +31 -31
  249. package/vibe/ui-ux-data/web-interface.csv +31 -31
@@ -1,75 +1,75 @@
1
- ---
2
- name: commit-push-pr
3
- description: "Commit, push, and create PR in one go. Auto-activates on commit, PR, push keywords."
4
- triggers: [commit, push, PR, pull request, merge]
5
- priority: 70
6
- ---
7
-
8
- # Commit-Push-PR
9
-
10
- ## Pre-checks
11
-
12
- ```bash
13
- git status # What's changed
14
- git diff --stat # Review changes
15
- git log --oneline -5 # Recent commits for style
16
- ```
17
-
18
- ## Workflow
19
-
20
- 1. Review and stage changed files
21
- 2. Write commit message (Conventional Commits)
22
- 3. Push to remote branch
23
- 4. Create PR with `gh pr create`
24
-
25
- ## Commit Message Format
26
-
27
- ```
28
- [type] title (under 50 chars)
29
-
30
- body (optional, 72 char wrap)
31
-
32
- Co-Authored-By: Claude <noreply@anthropic.com>
33
- ```
34
-
35
- Types: `feat` | `fix` | `docs` | `style` | `refactor` | `test` | `chore` | `perf`
36
-
37
- ## Security Checks (CRITICAL)
38
-
39
- ```bash
40
- # Before committing — detect sensitive files
41
- git diff --cached --name-only | grep -E '\.(env|pem|key)$|credentials|secret'
42
- ```
43
-
44
- **Never commit:** `.env`, `.env.local`, `*.pem`, `*.key`, `credentials.json`, `service-account.json`
45
-
46
- > If sensitive files are staged, **immediately warn and abort**.
47
-
48
- ## Branch Protection
49
-
50
- - **No direct commits/pushes to main/master**
51
- - If on main: create a new branch first
52
- - **Never** `--force` push to main/master
53
-
54
- ## PR Format
55
-
56
- ```bash
57
- gh pr create \
58
- --title "[type] title" \
59
- --body "## Changes
60
- - Key changes
61
-
62
- ## Related Issues
63
- - Closes #issue-number
64
-
65
- ## Testing
66
- - Test methods and results"
67
- ```
68
-
69
- ## Done Criteria (K4)
70
-
71
- - [ ] No sensitive files in commit
72
- - [ ] Commit message follows Conventional Commits
73
- - [ ] Co-Authored-By line included
74
- - [ ] Not pushing directly to main/master
75
- - [ ] PR created with clear description
1
+ ---
2
+ name: commit-push-pr
3
+ description: "Commit, push, and create PR in one go. Auto-activates on commit, PR, push keywords."
4
+ triggers: [commit, push, PR, pull request, merge]
5
+ priority: 70
6
+ ---
7
+
8
+ # Commit-Push-PR
9
+
10
+ ## Pre-checks
11
+
12
+ ```bash
13
+ git status # What's changed
14
+ git diff --stat # Review changes
15
+ git log --oneline -5 # Recent commits for style
16
+ ```
17
+
18
+ ## Workflow
19
+
20
+ 1. Review and stage changed files
21
+ 2. Write commit message (Conventional Commits)
22
+ 3. Push to remote branch
23
+ 4. Create PR with `gh pr create`
24
+
25
+ ## Commit Message Format
26
+
27
+ ```
28
+ [type] title (under 50 chars)
29
+
30
+ body (optional, 72 char wrap)
31
+
32
+ Co-Authored-By: Claude <noreply@anthropic.com>
33
+ ```
34
+
35
+ Types: `feat` | `fix` | `docs` | `style` | `refactor` | `test` | `chore` | `perf`
36
+
37
+ ## Security Checks (CRITICAL)
38
+
39
+ ```bash
40
+ # Before committing — detect sensitive files
41
+ git diff --cached --name-only | grep -E '\.(env|pem|key)$|credentials|secret'
42
+ ```
43
+
44
+ **Never commit:** `.env`, `.env.local`, `*.pem`, `*.key`, `credentials.json`, `service-account.json`
45
+
46
+ > If sensitive files are staged, **immediately warn and abort**.
47
+
48
+ ## Branch Protection
49
+
50
+ - **No direct commits/pushes to main/master**
51
+ - If on main: create a new branch first
52
+ - **Never** `--force` push to main/master
53
+
54
+ ## PR Format
55
+
56
+ ```bash
57
+ gh pr create \
58
+ --title "[type] title" \
59
+ --body "## Changes
60
+ - Key changes
61
+
62
+ ## Related Issues
63
+ - Closes #issue-number
64
+
65
+ ## Testing
66
+ - Test methods and results"
67
+ ```
68
+
69
+ ## Done Criteria (K4)
70
+
71
+ - [ ] No sensitive files in commit
72
+ - [ ] Commit message follows Conventional Commits
73
+ - [ ] Co-Authored-By line included
74
+ - [ ] Not pushing directly to main/master
75
+ - [ ] PR created with clear description
@@ -1,105 +1,105 @@
1
- ---
2
- name: context7-usage
3
- description: "Context7 plugin for latest library documentation. Auto-activates when docs, documentation, latest version, official docs, API reference, or library help is needed."
4
- triggers: [docs, documentation, latest version, official docs, API reference, library help, context7]
5
- priority: 60
6
- ---
7
-
8
- # Context7 Usage
9
-
10
- Guide for searching latest library/framework documentation using Context7 plugin with subagent isolation.
11
-
12
- ## Why Subagent Approach?
13
-
14
- | Approach | Problem |
15
- |----------|---------|
16
- | Direct plugin call | Docs content fills main context, causing bloat |
17
- | Subagent isolation | Docs queried in separate context, only results returned |
18
-
19
- **Benefits:**
20
-
21
- - Prevents context bloat during long coding sessions
22
- - Solves knowledge cutoff problem with latest docs
23
- - Main context stays focused on implementation
24
-
25
- ## When to Use
26
-
27
- | Situation | Example |
28
- |-----------|---------|
29
- | Latest API check | "React 19 use() hook usage" |
30
- | Version differences | "Next.js 15 changes" |
31
- | Official docs needed | "Prisma schema syntax" |
32
- | Migration guide | "Vue 2 → Vue 3 migration" |
33
-
34
- ## How It Works
35
-
36
- ```
37
- User asks library question
38
-
39
- Skill detects docs need
40
-
41
- Spawn docs-researcher subagent (haiku)
42
-
43
- Subagent calls context7 in isolated context
44
-
45
- Returns only relevant info to main context
46
- ```
47
-
48
- ## Usage
49
-
50
- ### Automatic (Recommended)
51
-
52
- Just ask library/API questions naturally:
53
-
54
- ```
55
- "How do I use React 19 use() hook?"
56
- "What's new in Next.js 15?"
57
- "Prisma many-to-many relation syntax"
58
- ```
59
-
60
- The skill auto-detects and spawns a docs-researcher subagent.
61
-
62
- ### Manual Command
63
-
64
- ```
65
- /context7:docs <library> [query]
66
- ```
67
-
68
- Examples:
69
-
70
- ```
71
- /context7:docs react hooks
72
- /context7:docs next.js app router
73
- /context7:docs prisma relations
74
- ```
75
-
76
- ## Implementation Pattern
77
-
78
- When you detect a library/API documentation need, spawn a subagent:
79
-
80
- ```
81
- Task tool call:
82
- - subagent_type: Explore
83
- - model: haiku
84
- - prompt: "Use context7 to find [library] documentation about [topic]. Return only the relevant API usage examples and key points."
85
- ```
86
-
87
- The subagent handles the context7 calls and returns a summary, keeping main context clean.
88
-
89
- ## Fallback Chain
90
-
91
- ```
92
- context7 plugin not installed
93
-
94
- Prompt user: /plugin install context7
95
-
96
- If still unavailable: Web Search for official docs
97
- ```
98
-
99
- ## Installation
100
-
101
- If context7 is not installed, guide user:
102
-
103
- ```bash
104
- /plugin install context7
105
- ```
1
+ ---
2
+ name: context7-usage
3
+ description: "Context7 plugin for latest library documentation. Auto-activates when docs, documentation, latest version, official docs, API reference, or library help is needed."
4
+ triggers: [docs, documentation, latest version, official docs, API reference, library help, context7]
5
+ priority: 60
6
+ ---
7
+
8
+ # Context7 Usage
9
+
10
+ Guide for searching latest library/framework documentation using Context7 plugin with subagent isolation.
11
+
12
+ ## Why Subagent Approach?
13
+
14
+ | Approach | Problem |
15
+ |----------|---------|
16
+ | Direct plugin call | Docs content fills main context, causing bloat |
17
+ | Subagent isolation | Docs queried in separate context, only results returned |
18
+
19
+ **Benefits:**
20
+
21
+ - Prevents context bloat during long coding sessions
22
+ - Solves knowledge cutoff problem with latest docs
23
+ - Main context stays focused on implementation
24
+
25
+ ## When to Use
26
+
27
+ | Situation | Example |
28
+ |-----------|---------|
29
+ | Latest API check | "React 19 use() hook usage" |
30
+ | Version differences | "Next.js 15 changes" |
31
+ | Official docs needed | "Prisma schema syntax" |
32
+ | Migration guide | "Vue 2 → Vue 3 migration" |
33
+
34
+ ## How It Works
35
+
36
+ ```
37
+ User asks library question
38
+
39
+ Skill detects docs need
40
+
41
+ Spawn docs-researcher subagent (haiku)
42
+
43
+ Subagent calls context7 in isolated context
44
+
45
+ Returns only relevant info to main context
46
+ ```
47
+
48
+ ## Usage
49
+
50
+ ### Automatic (Recommended)
51
+
52
+ Just ask library/API questions naturally:
53
+
54
+ ```
55
+ "How do I use React 19 use() hook?"
56
+ "What's new in Next.js 15?"
57
+ "Prisma many-to-many relation syntax"
58
+ ```
59
+
60
+ The skill auto-detects and spawns a docs-researcher subagent.
61
+
62
+ ### Manual Command
63
+
64
+ ```
65
+ /context7:docs <library> [query]
66
+ ```
67
+
68
+ Examples:
69
+
70
+ ```
71
+ /context7:docs react hooks
72
+ /context7:docs next.js app router
73
+ /context7:docs prisma relations
74
+ ```
75
+
76
+ ## Implementation Pattern
77
+
78
+ When you detect a library/API documentation need, spawn a subagent:
79
+
80
+ ```
81
+ Task tool call:
82
+ - subagent_type: Explore
83
+ - model: haiku
84
+ - prompt: "Use context7 to find [library] documentation about [topic]. Return only the relevant API usage examples and key points."
85
+ ```
86
+
87
+ The subagent handles the context7 calls and returns a summary, keeping main context clean.
88
+
89
+ ## Fallback Chain
90
+
91
+ ```
92
+ context7 plugin not installed
93
+
94
+ Prompt user: /plugin install context7
95
+
96
+ If still unavailable: Web Search for official docs
97
+ ```
98
+
99
+ ## Installation
100
+
101
+ If context7 is not installed, guide user:
102
+
103
+ ```bash
104
+ /plugin install context7
105
+ ```
@@ -1,13 +1,13 @@
1
- ---
2
- name: core-capabilities
3
- description: "DEPRECATED — content covered by CLAUDE.md. Context thresholds and workflow guidance are in CLAUDE.md."
4
- ---
5
-
6
- # Core Capabilities (Deprecated)
7
-
8
- This skill's content is covered by CLAUDE.md:
9
- - Workflow: `/vibe.spec` → `/vibe.run` → `/vibe.trace` → review → Done
10
- - Context thresholds: 70% checkpoint, 80% warning, 90% critical
11
- - Magic keywords: `ultrawork`, `ralph`, `ralplan`, `verify`, `quick`
12
-
13
- Refer to CLAUDE.md directly for all framework capabilities.
1
+ ---
2
+ name: core-capabilities
3
+ description: "DEPRECATED — content covered by CLAUDE.md. Context thresholds and workflow guidance are in CLAUDE.md."
4
+ ---
5
+
6
+ # Core Capabilities (Deprecated)
7
+
8
+ This skill's content is covered by CLAUDE.md:
9
+ - Workflow: `/vibe.spec` → `/vibe.run` → `/vibe.trace` → review → Done
10
+ - Context thresholds: 70% checkpoint, 80% warning, 90% critical
11
+ - Magic keywords: `ultrawork`, `ralph`, `ralplan`, `verify`, `quick`
12
+
13
+ Refer to CLAUDE.md directly for all framework capabilities.
@@ -1,61 +1,61 @@
1
- ---
2
- name: e2e-commerce
3
- description: "E2E test scenarios for commerce checkout and payment flows"
4
- triggers: [e2e commerce, checkout test, payment test, order flow test]
5
- priority: 65
6
- ---
7
-
8
- # E2E Commerce Test Scenarios
9
-
10
- ## Pre-check (K1)
11
-
12
- > Are you testing a checkout/payment/order flow? If testing simple CRUD or non-transactional features, standard E2E patterns suffice — this skill is not needed.
13
-
14
- ## Must-Test Scenarios
15
-
16
- ### P0 — Blocks Deployment
17
-
18
- | Scenario | What to Verify | Gotcha |
19
- |----------|---------------|--------|
20
- | **Happy path checkout** | Cart → Shipping → Payment → Order confirmation | Verify order status text, not just URL change |
21
- | **Payment failure** | Error message shown, stock released | Check stock is RELEASED after failure, not just error displayed |
22
- | **Duplicate payment** | Only 1 order created on double-click | `Promise.all([click(), click()])` then verify order count via API |
23
- | **Out of stock** | Blocks checkout with clear message | Simulate stock depletion mid-checkout via test API |
24
-
25
- ### P1 — Should Pass
26
-
27
- | Scenario | What to Verify | Gotcha |
28
- |----------|---------------|--------|
29
- | **Coupon calculation** | Discount amount and total correct | Test percentage AND fixed amount coupons separately |
30
- | **Webhook resilience** | Order completes even with delayed webhook | Configure 5s delay, verify processing→complete transition |
31
- | **Cart merge on login** | Guest cart merged into user cart | User cart takes priority for duplicate items |
32
- | **Partial refund** | Refunded amount correct, order updated | Verify remaining amount, not just refund event |
33
-
34
- ### P2 — Nice to Have
35
-
36
- | Scenario | What to Verify |
37
- |----------|---------------|
38
- | Multiple payment methods | Each method completes checkout |
39
- | Guest checkout | Full flow without login |
40
- | Order cancellation | Refund triggered, stock restored |
41
-
42
- ## Test Environment Gotchas
43
-
44
- | Gotcha | Fix |
45
- |--------|-----|
46
- | Using real PG sandbox in CI | Use MSW (`setupServer`) for mock PG responses |
47
- | Flaky tests from timing | Use `waitForSelector`/`waitForURL`, never `sleep` |
48
- | Test data leaks between tests | Seed in `beforeAll`, clean in `afterAll` |
49
- | Hardcoded test card numbers | Document: `4000000000000002` = decline |
50
-
51
- ## Related
52
-
53
- See `commerce-patterns` skill for implementation gotchas (idempotency, atomic stock, payment state machine) that these tests verify.
54
-
55
- ## Done Criteria (K4)
56
-
57
- - [ ] All P0 scenarios pass in CI
58
- - [ ] P1 scenarios written and tracked
59
- - [ ] Test data seeded/cleaned per suite
60
- - [ ] No flaky tests (no arbitrary waits)
61
- - [ ] Mock PG server configured for CI
1
+ ---
2
+ name: e2e-commerce
3
+ description: "E2E test scenarios for commerce checkout and payment flows"
4
+ triggers: [e2e commerce, checkout test, payment test, order flow test]
5
+ priority: 65
6
+ ---
7
+
8
+ # E2E Commerce Test Scenarios
9
+
10
+ ## Pre-check (K1)
11
+
12
+ > Are you testing a checkout/payment/order flow? If testing simple CRUD or non-transactional features, standard E2E patterns suffice — this skill is not needed.
13
+
14
+ ## Must-Test Scenarios
15
+
16
+ ### P0 — Blocks Deployment
17
+
18
+ | Scenario | What to Verify | Gotcha |
19
+ |----------|---------------|--------|
20
+ | **Happy path checkout** | Cart → Shipping → Payment → Order confirmation | Verify order status text, not just URL change |
21
+ | **Payment failure** | Error message shown, stock released | Check stock is RELEASED after failure, not just error displayed |
22
+ | **Duplicate payment** | Only 1 order created on double-click | `Promise.all([click(), click()])` then verify order count via API |
23
+ | **Out of stock** | Blocks checkout with clear message | Simulate stock depletion mid-checkout via test API |
24
+
25
+ ### P1 — Should Pass
26
+
27
+ | Scenario | What to Verify | Gotcha |
28
+ |----------|---------------|--------|
29
+ | **Coupon calculation** | Discount amount and total correct | Test percentage AND fixed amount coupons separately |
30
+ | **Webhook resilience** | Order completes even with delayed webhook | Configure 5s delay, verify processing→complete transition |
31
+ | **Cart merge on login** | Guest cart merged into user cart | User cart takes priority for duplicate items |
32
+ | **Partial refund** | Refunded amount correct, order updated | Verify remaining amount, not just refund event |
33
+
34
+ ### P2 — Nice to Have
35
+
36
+ | Scenario | What to Verify |
37
+ |----------|---------------|
38
+ | Multiple payment methods | Each method completes checkout |
39
+ | Guest checkout | Full flow without login |
40
+ | Order cancellation | Refund triggered, stock restored |
41
+
42
+ ## Test Environment Gotchas
43
+
44
+ | Gotcha | Fix |
45
+ |--------|-----|
46
+ | Using real PG sandbox in CI | Use MSW (`setupServer`) for mock PG responses |
47
+ | Flaky tests from timing | Use `waitForSelector`/`waitForURL`, never `sleep` |
48
+ | Test data leaks between tests | Seed in `beforeAll`, clean in `afterAll` |
49
+ | Hardcoded test card numbers | Document: `4000000000000002` = decline |
50
+
51
+ ## Related
52
+
53
+ See `commerce-patterns` skill for implementation gotchas (idempotency, atomic stock, payment state machine) that these tests verify.
54
+
55
+ ## Done Criteria (K4)
56
+
57
+ - [ ] All P0 scenarios pass in CI
58
+ - [ ] P1 scenarios written and tracked
59
+ - [ ] Test data seeded/cleaned per suite
60
+ - [ ] No flaky tests (no arbitrary waits)
61
+ - [ ] Mock PG server configured for CI