vibesuite 1.3.3 → 2.0.2
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.
- package/README.md +75 -6
- package/assets/.agent/skills/avoid-feature-creep/SKILL.md +307 -0
- package/assets/.agent/skills/avoid-feature-creep/agents/openai.yaml +3 -0
- package/assets/.agent/skills/avoid-feature-creep/assets/large-logo.png +0 -0
- package/assets/.agent/skills/avoid-feature-creep/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/convex/SKILL.md +62 -0
- package/assets/.agent/skills/convex/agents/openai.yaml +3 -0
- package/assets/.agent/skills/convex/assets/large-logo.png +0 -0
- package/assets/.agent/skills/convex/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/convex-agents/SKILL.md +516 -0
- package/assets/.agent/skills/convex-agents/agents/openai.yaml +3 -0
- package/assets/.agent/skills/convex-agents/assets/large-logo.png +0 -0
- package/assets/.agent/skills/convex-agents/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/convex-best-practices/SKILL.md +369 -0
- package/assets/.agent/skills/convex-best-practices/agents/openai.yaml +3 -0
- package/assets/.agent/skills/convex-best-practices/assets/large-logo.png +0 -0
- package/assets/.agent/skills/convex-best-practices/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/convex-component-authoring/SKILL.md +457 -0
- package/assets/.agent/skills/convex-component-authoring/agents/openai.yaml +3 -0
- package/assets/.agent/skills/convex-component-authoring/assets/large-logo.png +0 -0
- package/assets/.agent/skills/convex-component-authoring/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/convex-cron-jobs/SKILL.md +604 -0
- package/assets/.agent/skills/convex-cron-jobs/agents/openai.yaml +3 -0
- package/assets/.agent/skills/convex-cron-jobs/assets/large-logo.png +0 -0
- package/assets/.agent/skills/convex-cron-jobs/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/convex-file-storage/SKILL.md +467 -0
- package/assets/.agent/skills/convex-file-storage/agents/openai.yaml +3 -0
- package/assets/.agent/skills/convex-file-storage/assets/large-logo.png +0 -0
- package/assets/.agent/skills/convex-file-storage/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/convex-functions/SKILL.md +458 -0
- package/assets/.agent/skills/convex-functions/agents/openai.yaml +3 -0
- package/assets/.agent/skills/convex-functions/assets/large-logo.png +0 -0
- package/assets/.agent/skills/convex-functions/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/convex-http-actions/SKILL.md +733 -0
- package/assets/.agent/skills/convex-http-actions/agents/openai.yaml +3 -0
- package/assets/.agent/skills/convex-http-actions/assets/large-logo.png +0 -0
- package/assets/.agent/skills/convex-http-actions/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/convex-migrations/SKILL.md +712 -0
- package/assets/.agent/skills/convex-migrations/agents/openai.yaml +3 -0
- package/assets/.agent/skills/convex-migrations/assets/large-logo.png +0 -0
- package/assets/.agent/skills/convex-migrations/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/convex-realtime/SKILL.md +443 -0
- package/assets/.agent/skills/convex-realtime/agents/openai.yaml +3 -0
- package/assets/.agent/skills/convex-realtime/assets/large-logo.png +0 -0
- package/assets/.agent/skills/convex-realtime/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/convex-schema-validator/SKILL.md +400 -0
- package/assets/.agent/skills/convex-schema-validator/agents/openai.yaml +3 -0
- package/assets/.agent/skills/convex-schema-validator/assets/large-logo.png +0 -0
- package/assets/.agent/skills/convex-schema-validator/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/convex-security-audit/SKILL.md +539 -0
- package/assets/.agent/skills/convex-security-audit/agents/openai.yaml +3 -0
- package/assets/.agent/skills/convex-security-audit/assets/large-logo.png +0 -0
- package/assets/.agent/skills/convex-security-audit/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/convex-security-check/SKILL.md +378 -0
- package/assets/.agent/skills/convex-security-check/agents/openai.yaml +3 -0
- package/assets/.agent/skills/convex-security-check/assets/large-logo.png +0 -0
- package/assets/.agent/skills/convex-security-check/assets/small-logo.svg +17 -0
- package/assets/.agent/skills/github-ops/SKILL.md +4 -4
- package/assets/.agent/skills/google-trends/SKILL.md +7 -7
- package/assets/.agent/skills/optimize-agent-context/SKILL.md +97 -0
- package/assets/.agent/skills/youtube-pipeline/SKILL.md +10 -10
- package/assets/.agent/workflows/LEGACY/init_smart_ops.md +2 -2
- package/assets/.agent/workflows/agent_reset.md +4 -6
- package/assets/.agent/workflows/mode-orchestrator.md +17 -22
- package/assets/.agent/workflows/mode-visionary.md +3 -10
- package/assets/.agent/workflows/optimize-agent-context.md +54 -0
- package/assets/.agent/workflows/remotion-build.md +17 -17
- package/assets/.agent/workflows/stitch.md +4 -4
- package/assets/VibeCode-Agents/vibe-orchestrator.yaml +14 -33
- package/assets/VibeCode-Agents/vibe-visionary.yaml +3 -13
- package/package.json +1 -1
- package/src/cli.js +416 -20
- package/src/harness.js +281 -0
- package/src/store.js +239 -0
- package/assets/VibeCode-Agents/custom_modes.yaml +0 -979
package/README.md
CHANGED
|
@@ -9,17 +9,33 @@
|
|
|
9
9
|
|
|
10
10
|
## 🚀 Quick Start (Recommended)
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
### Option A: Global Install (Best for Multi-IDE Users) ⭐
|
|
13
|
+
|
|
14
|
+
Install skills **once** and have them available across all your AI harnesses (Antigravity, KiloCode, Windsurf, Cursor, Gemini CLI):
|
|
13
15
|
|
|
14
16
|
```bash
|
|
15
|
-
# Using
|
|
16
|
-
|
|
17
|
+
# Using pnpm
|
|
18
|
+
pnpm dlx vibesuite install
|
|
19
|
+
|
|
20
|
+
# Using npx
|
|
21
|
+
npx vibesuite install
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
This will:
|
|
25
|
+
- 🔍 **Auto-detect** which AI harnesses are installed on your machine
|
|
26
|
+
- 📦 **Create a global store** at `~/.vibesuite/`
|
|
27
|
+
- 📡 **Sync skills & workflows** to every detected harness's global directory
|
|
28
|
+
- 🔄 **Sync KiloCode YAMLs** to both CLI and VS Code extension paths
|
|
29
|
+
|
|
30
|
+
### Option B: Per-Project Setup
|
|
17
31
|
|
|
18
|
-
|
|
32
|
+
Spawn VibeCode into a single project's `.agent/` folder:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
19
35
|
pnpm dlx vibesuite init
|
|
20
36
|
```
|
|
21
37
|
|
|
22
|
-
This interactive CLI
|
|
38
|
+
This interactive CLI lets you choose:
|
|
23
39
|
- ✅ **.agent Folder** (For Cursor/Windsurf workflows)
|
|
24
40
|
- ✅ **Kilo Code Agents** (YAML definitions)
|
|
25
41
|
- ✅ **Legacy Protocols** (Manual prompts)
|
|
@@ -46,6 +62,12 @@ Coding-focused skills for everyday development:
|
|
|
46
62
|
npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill ai-sdk --skill code-review --skill component-analysis --skill nextjs-standards --skill security-audit --skill spawn-task --skill stitch --skill sync-docs
|
|
47
63
|
```
|
|
48
64
|
|
|
65
|
+
### Convex Development Suite
|
|
66
|
+
Complete Convex backend development skills:
|
|
67
|
+
```bash
|
|
68
|
+
npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill convex --skill convex-agents --skill convex-best-practices --skill convex-component-authoring --skill convex-cron-jobs --skill convex-file-storage --skill convex-functions --skill convex-http-actions --skill convex-migrations --skill convex-realtime --skill convex-schema-validator --skill convex-security-audit --skill convex-security-check
|
|
69
|
+
```
|
|
70
|
+
|
|
49
71
|
### AI Media Suite (Paid / Advanced)
|
|
50
72
|
Specialized skills requiring API keys or paid services:
|
|
51
73
|
```bash
|
|
@@ -55,9 +77,55 @@ npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill
|
|
|
55
77
|
### Full Standard Suite (Free)
|
|
56
78
|
Everything else (SEO, research, workflow tools):
|
|
57
79
|
```bash
|
|
58
|
-
npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill agent-recovery --skill algorithmic-art --skill audit-website --skill building-native-ui --skill code-review --skill component-analysis --skill context7 --skill copywriting --skill crafting-effective-readmes --skill docx --skill domain-name-brainstormer --skill frontend-design --skill gemini --skill git-worktree --skill github-ops --skill google-trends --skill high-fidelity-extraction --skill jules --skill marketing-ideas --skill monorepo-management --skill nextjs-standards --skill pdf --skill pptx --skill pricing-strategy --skill programmatic-seo --skill prompt-engineering --skill remotion --skill security-audit --skill seo-ready --skill skill-creator --skill social-content --skill spawn-task --skill stitch --skill subagent-driven-development --skill sync-docs --skill twitter-automation --skill ui-ux-pro-max --skill upgrading-expo --skill webapp-testing --skill web-design-guidelines --skill xlsx --skill youtube-pipeline
|
|
80
|
+
npx -y skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill agent-recovery --skill algorithmic-art --skill audit-website --skill avoid-feature-creep --skill building-native-ui --skill code-review --skill component-analysis --skill context7 --skill convex --skill convex-agents --skill convex-best-practices --skill convex-component-authoring --skill convex-cron-jobs --skill convex-file-storage --skill convex-functions --skill convex-http-actions --skill convex-migrations --skill convex-realtime --skill convex-schema-validator --skill convex-security-audit --skill convex-security-check --skill copywriting --skill crafting-effective-readmes --skill docx --skill domain-name-brainstormer --skill frontend-design --skill gemini --skill git-worktree --skill github-ops --skill google-trends --skill high-fidelity-extraction --skill jules --skill marketing-ideas --skill monorepo-management --skill nextjs-standards --skill optimize-agent-context --skill pdf --skill pptx --skill pricing-strategy --skill programmatic-seo --skill prompt-engineering --skill remotion --skill security-audit --skill seo-ready --skill skill-creator --skill social-content --skill spawn-task --skill stitch --skill subagent-driven-development --skill sync-docs --skill twitter-automation --skill ui-ux-pro-max --skill upgrading-expo --skill webapp-testing --skill web-design-guidelines --skill xlsx --skill youtube-pipeline
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## 🌐 Global Skills Router (v2.0)
|
|
86
|
+
|
|
87
|
+
VibeSuite v2.0 introduces the **Global Skills Router** — install skills once, route to every AI harness automatically. No symlinks, no admin privileges, works on Mac & Windows.
|
|
88
|
+
|
|
89
|
+
### Supported Harnesses
|
|
90
|
+
|
|
91
|
+
| Harness | Global Skills Path | Global Workflows Path |
|
|
92
|
+
|---|---|---|
|
|
93
|
+
| **Antigravity** | `~/.gemini/antigravity/skills/` | `~/.gemini/antigravity/global_workflows/` |
|
|
94
|
+
| **KiloCode** | `~/.kilocode/skills/` | `~/.kilocode/workflows/` |
|
|
95
|
+
| **Windsurf** | `~/.codeium/windsurf/skills/` | `~/.codeium/windsurf/global_workflows/` |
|
|
96
|
+
| **Cursor** | `~/.cursor/skills/` | _(uses rules)_ |
|
|
97
|
+
| **Gemini CLI** | `~/.gemini/skills/` | — |
|
|
98
|
+
|
|
99
|
+
### CLI Commands
|
|
100
|
+
|
|
101
|
+
| Command | What It Does |
|
|
102
|
+
|---|---|
|
|
103
|
+
| `vibesuite install` | One-time global setup — detect harnesses, create store, sync everything |
|
|
104
|
+
| `vibesuite sync` | Re-sync from `~/.vibesuite/` to all linked harnesses |
|
|
105
|
+
| `vibesuite add <url>` | Fetch skills from any GitHub repo into your global store |
|
|
106
|
+
| `vibesuite harnesses` | Show detected harnesses and global store status |
|
|
107
|
+
| `vibesuite init` | Per-project `.agent/` setup (backward compatible) |
|
|
108
|
+
| `vibesuite update` | Update resources from GitHub (supports global store) |
|
|
109
|
+
|
|
110
|
+
### Example: Add Remote Skills
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
# Pull skills from any GitHub repo into your global store
|
|
114
|
+
pnpm dlx vibesuite add https://github.com/JStaRFilms/VibeCode-Protocol-Suite
|
|
115
|
+
|
|
116
|
+
# Check what's detected
|
|
117
|
+
pnpm dlx vibesuite harnesses
|
|
118
|
+
|
|
119
|
+
# Re-sync after adding new skills
|
|
120
|
+
pnpm dlx vibesuite sync
|
|
59
121
|
```
|
|
60
122
|
|
|
123
|
+
### KiloCode YAML Auto-Sync
|
|
124
|
+
|
|
125
|
+
When KiloCode is detected, `vibesuite install` automatically syncs `custom_modes.yaml` to **both** locations:
|
|
126
|
+
- CLI: `~/.kilocode/cli/global/settings/custom_modes.yaml`
|
|
127
|
+
- Extension: `%APPDATA%/Antigravity/User/globalStorage/kilocode.kilo-code/settings/custom_modes.yaml`
|
|
128
|
+
|
|
61
129
|
---
|
|
62
130
|
|
|
63
131
|
## 🌟 What is VibeCode?
|
|
@@ -326,6 +394,7 @@ This is a living system! If you discover improvements:
|
|
|
326
394
|
- **Subagent Development**: From [obra/superpowers](https://github.com/obra/superpowers) — advanced implementation planning.
|
|
327
395
|
- **Context7**: From [upstash/context7](https://github.com/upstash/context7) — fresh library documentation fetcher.
|
|
328
396
|
- **Audit Website**: From [squirrelscan/skills](https://github.com/squirrelscan/skills) — professional website auditor.
|
|
397
|
+
- **Convex Skills**: From [waynesutton/convexskills](https://github.com/waynesutton/convexskills) — complete Convex development suite including **Functions**, **Schema Validation**, **Realtime**, **Agents**, **File Storage**, **Migrations**, **HTTP Actions**, **Cron Jobs**, **Component Authoring**, **Best Practices**, **Security Audit**, **Security Check**, **Avoid Feature Creep**, and **Optimize Agent Context**.
|
|
329
398
|
- **Gemini CLI**: Custom VibeCode skill for large-context processing with Gemini 3 Pro.
|
|
330
399
|
- **Google Stitch Skills**: From [google-labs-code/stitch-skills](https://github.com/google-labs-code/stitch-skills) — Design-to-code suite including **design-md**, **enhance-prompt**, **stitch-loop**, **react-components**, and **shadcn-ui**.
|
|
331
400
|
- **Jules**: From [sanjay3290/ai-skills](https://github.com/sanjay3290/ai-skills) — delegate coding tasks to Google Jules AI agent.
|
|
@@ -0,0 +1,307 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: avoid-feature-creep
|
|
3
|
+
description: Prevent feature creep when building software, apps, and AI-powered products. Use this skill when planning features, reviewing scope, building MVPs, managing backlogs, or when a user says "just one more feature." Helps developers and AI agents stay focused, ship faster, and avoid bloated products.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Avoid Feature Creep for Agents
|
|
7
|
+
|
|
8
|
+
Stop building features nobody needs. This skill helps you ship products that solve real problems without drowning in unnecessary complexity.
|
|
9
|
+
|
|
10
|
+
Feature creep kills products. It delays launches, burns budgets, exhausts teams, and creates software nobody wants to use. The most successful products do fewer things well.
|
|
11
|
+
|
|
12
|
+
## The Core Problem
|
|
13
|
+
|
|
14
|
+
Feature creep is the gradual accumulation of features beyond what your product needs to deliver value. It happens slowly, then all at once.
|
|
15
|
+
|
|
16
|
+
**Warning signs you're in trouble:**
|
|
17
|
+
- Release scope keeps growing without clear user value
|
|
18
|
+
- You're copying competitor features without validating need
|
|
19
|
+
- Stakeholders keep adding "just one more thing"
|
|
20
|
+
- The codebase is getting harder to maintain
|
|
21
|
+
- Users complain the product is confusing or bloated
|
|
22
|
+
- You haven't shipped in months
|
|
23
|
+
|
|
24
|
+
**What it costs:**
|
|
25
|
+
- Development time on features 80% of users never touch
|
|
26
|
+
- Increased bug surface area
|
|
27
|
+
- Team burnout and context switching
|
|
28
|
+
- Delayed time-to-market
|
|
29
|
+
- Technical debt that compounds
|
|
30
|
+
- User confusion and abandonment
|
|
31
|
+
|
|
32
|
+
## Decision Framework
|
|
33
|
+
|
|
34
|
+
Before adding ANY feature, run through this checklist:
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
1. VALIDATE THE PROBLEM
|
|
38
|
+
□ Does this solve a real, validated user pain point?
|
|
39
|
+
□ Have we talked to actual users about this need?
|
|
40
|
+
□ What evidence supports building this?
|
|
41
|
+
|
|
42
|
+
2. CHECK ALIGNMENT
|
|
43
|
+
□ Does this support the core product vision?
|
|
44
|
+
□ Would this delay our current release?
|
|
45
|
+
□ What are we NOT building if we build this?
|
|
46
|
+
|
|
47
|
+
3. MEASURE IMPACT
|
|
48
|
+
□ How will we know if this feature succeeds?
|
|
49
|
+
□ What KPIs will change?
|
|
50
|
+
□ Can we quantify the value (time saved, revenue, retention)?
|
|
51
|
+
|
|
52
|
+
4. ASSESS COMPLEXITY
|
|
53
|
+
□ What's the true cost (build + test + maintain + document)?
|
|
54
|
+
□ Does this add dependencies or technical debt?
|
|
55
|
+
□ Can we ship a simpler version first?
|
|
56
|
+
|
|
57
|
+
5. FINAL GUT CHECK
|
|
58
|
+
□ Would we delay launch by a month for this feature?
|
|
59
|
+
□ Is this a differentiator or just table stakes?
|
|
60
|
+
□ Would removing this harm the core experience?
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
If you can't answer YES to questions 1-3 with evidence, do not build the feature.
|
|
64
|
+
|
|
65
|
+
## Scope Management Rules
|
|
66
|
+
|
|
67
|
+
**Rule 1: Define and Defend Your MVP**
|
|
68
|
+
|
|
69
|
+
Write down exactly what "done" means before you start. Document what you're NOT building. Reference this constantly.
|
|
70
|
+
|
|
71
|
+
```markdown
|
|
72
|
+
## MVP Scope Document Template
|
|
73
|
+
|
|
74
|
+
### Core Problem
|
|
75
|
+
[One sentence describing the user problem]
|
|
76
|
+
|
|
77
|
+
### Success Criteria
|
|
78
|
+
[How we know we've solved it]
|
|
79
|
+
|
|
80
|
+
### In Scope (v1)
|
|
81
|
+
- Feature A: [brief description]
|
|
82
|
+
- Feature B: [brief description]
|
|
83
|
+
|
|
84
|
+
### Explicitly Out of Scope
|
|
85
|
+
- Feature X: Deferred to v2
|
|
86
|
+
- Feature Y: Will not build unless [condition]
|
|
87
|
+
- Feature Z: Not our problem to solve
|
|
88
|
+
|
|
89
|
+
### Non-Negotiables
|
|
90
|
+
- Ship by [date]
|
|
91
|
+
- Budget: [hours/dollars]
|
|
92
|
+
- Core user: [specific persona]
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
**Rule 2: Use Version Control for Scope**
|
|
96
|
+
|
|
97
|
+
Treat scope like code. Track changes. Require approval for additions.
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
# Create a scope document and track it
|
|
101
|
+
git add SCOPE.md
|
|
102
|
+
git commit -m "Initial MVP scope definition"
|
|
103
|
+
|
|
104
|
+
# Any scope changes require explicit commits
|
|
105
|
+
git commit -m "SCOPE CHANGE: Added feature X - approved by [stakeholder] - impact: +2 weeks"
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
**Rule 3: The 48-Hour Rule**
|
|
109
|
+
|
|
110
|
+
When someone requests a new feature, wait 48 hours before adding it to the backlog. Most "urgent" requests feel less urgent after reflection.
|
|
111
|
+
|
|
112
|
+
**Rule 4: Budget-Based Scoping**
|
|
113
|
+
|
|
114
|
+
Every feature has a cost. When something new comes in, something else must go out.
|
|
115
|
+
|
|
116
|
+
"Yes, we can add that. Which of these three features should we cut to make room?"
|
|
117
|
+
|
|
118
|
+
## Saying No
|
|
119
|
+
|
|
120
|
+
Saying no to features is a skill. Here are templates:
|
|
121
|
+
|
|
122
|
+
**To stakeholders:**
|
|
123
|
+
> "That's an interesting idea. Based on our user research, it doesn't solve our core user's top three problems. Let's add it to the v2 consideration list and revisit after we validate the MVP."
|
|
124
|
+
|
|
125
|
+
**To executives:**
|
|
126
|
+
> "I understand the value this could bring. If we add this, we'll delay launch by [X weeks] and deprioritize [Y feature]. Here are the trade-offs - which path should we take?"
|
|
127
|
+
|
|
128
|
+
**To users:**
|
|
129
|
+
> "Thanks for the feedback. We're focused on [core problem] right now. I've logged this for future consideration. Can you tell me more about why this would be valuable?"
|
|
130
|
+
|
|
131
|
+
**To yourself:**
|
|
132
|
+
> "Is this scratching my own itch or solving a real user problem? Would I bet the release date on this?"
|
|
133
|
+
|
|
134
|
+
**To AI agents (Claude, Opus, Codex, Ralph, Cursor):**
|
|
135
|
+
> "Stop. Before we add this feature, answer: Does this solve the core user problem we defined at the start of this session? If not, add it to a DEFERRED.md file and stay focused on the current scope."
|
|
136
|
+
|
|
137
|
+
When working with AI coding agents:
|
|
138
|
+
- State your scope constraints at the start of every session
|
|
139
|
+
- Agents will suggest improvements. Most are out of scope.
|
|
140
|
+
- Treat agent suggestions like stakeholder requests: apply the 48-hour rule
|
|
141
|
+
- If an agent keeps pushing a feature, ask "Why?" three times to find the real need
|
|
142
|
+
|
|
143
|
+
## AI-Specific Guidelines
|
|
144
|
+
|
|
145
|
+
When building AI-powered products, feature creep has extra risks:
|
|
146
|
+
|
|
147
|
+
**AI Feature Creep Red Flags:**
|
|
148
|
+
- Adding AI because "everyone else is"
|
|
149
|
+
- Building AI summaries without validating users want them
|
|
150
|
+
- Multiple AI features without clear differentiation
|
|
151
|
+
- AI capabilities that don't connect to core user workflows
|
|
152
|
+
|
|
153
|
+
**AI Feature Discipline:**
|
|
154
|
+
1. One AI feature at a time
|
|
155
|
+
2. Validate the use case with users first
|
|
156
|
+
3. Measure actual usage, not just availability
|
|
157
|
+
4. Question: "Does the AI make the core task faster or better?"
|
|
158
|
+
|
|
159
|
+
**Before adding any AI feature, answer:**
|
|
160
|
+
- What specific task does this automate?
|
|
161
|
+
- How is this better than the non-AI alternative?
|
|
162
|
+
- What happens when the AI is wrong?
|
|
163
|
+
- Can we ship without this AI feature?
|
|
164
|
+
|
|
165
|
+
## Backlog Hygiene
|
|
166
|
+
|
|
167
|
+
A messy backlog enables feature creep. Clean it ruthlessly.
|
|
168
|
+
|
|
169
|
+
**Monthly Backlog Audit:**
|
|
170
|
+
```
|
|
171
|
+
For each item older than 30 days:
|
|
172
|
+
1. Has anyone asked about this since it was added?
|
|
173
|
+
2. Does it still align with current product vision?
|
|
174
|
+
3. If we never built this, would anyone notice?
|
|
175
|
+
|
|
176
|
+
If the answer to all three is "no" → Delete it.
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
**Priority Framework (MoSCoW):**
|
|
180
|
+
- **Must Have**: Product doesn't work without it
|
|
181
|
+
- **Should Have**: Important but not critical for launch
|
|
182
|
+
- **Could Have**: Nice but can wait
|
|
183
|
+
- **Won't Have**: Explicitly out of scope
|
|
184
|
+
|
|
185
|
+
Be honest: Most "Should Haves" are actually "Could Haves" in disguise.
|
|
186
|
+
|
|
187
|
+
## AI Session Discipline
|
|
188
|
+
|
|
189
|
+
**Session Start Check:**
|
|
190
|
+
Before coding with any AI assistant (Claude, Cursor, OpenCode), state:
|
|
191
|
+
- What specific feature you're building
|
|
192
|
+
- What's explicitly out of scope for this session
|
|
193
|
+
- When you'll stop and ship
|
|
194
|
+
|
|
195
|
+
**Mid-Session Check:**
|
|
196
|
+
Every 30-60 minutes, ask your AI:
|
|
197
|
+
"Are we building the right thing today, or are we adding scope?"
|
|
198
|
+
|
|
199
|
+
If the answer is "adding scope," stop. Commit what you have. Start fresh.
|
|
200
|
+
|
|
201
|
+
**Session End Check:**
|
|
202
|
+
Before closing an AI coding session:
|
|
203
|
+
- What did we actually build vs. what we planned?
|
|
204
|
+
- Did scope expand? Why?
|
|
205
|
+
- What should we defer to the next session?
|
|
206
|
+
|
|
207
|
+
**Daily AI Check:**
|
|
208
|
+
At the end of each day working with AI assistants:
|
|
209
|
+
```
|
|
210
|
+
1. Features completed today: [list]
|
|
211
|
+
2. Scope additions today: [list]
|
|
212
|
+
3. Was each addition validated? [yes/no]
|
|
213
|
+
4. Tomorrow's focus: [single item]
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
**Sprint Planning Guard Rails:**
|
|
217
|
+
- No new features mid-sprint without removing something
|
|
218
|
+
- Capacity for bug fixes and debt paydown (20% minimum)
|
|
219
|
+
- Clear definition of done for each item
|
|
220
|
+
|
|
221
|
+
**Stakeholder Management:**
|
|
222
|
+
Create a single source of truth for scope decisions:
|
|
223
|
+
|
|
224
|
+
```markdown
|
|
225
|
+
## Scope Decision Log
|
|
226
|
+
|
|
227
|
+
| Date | Request | Source | Decision | Rationale | Trade-off |
|
|
228
|
+
|------|---------|--------|----------|-----------|-----------|
|
|
229
|
+
| 2025-01-15 | Add export to PDF | PM | Deferred v2 | Not core to MVP | Would delay launch 2 weeks |
|
|
230
|
+
| 2025-01-16 | Dark mode | User feedback | Approved | User research shows demand | Removed social sharing |
|
|
231
|
+
| 2025-01-17 | Add caching layer | Claude | Deferred | Premature optimization | Stay focused on core feature |
|
|
232
|
+
| 2025-01-17 | Refactor to hooks | Cursor | Rejected | Works fine as is | Technical scope creep |
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
**Agents as Stakeholders:**
|
|
236
|
+
AI coding agents are now stakeholders in your project. They have opinions. They make suggestions. Treat them like any other stakeholder:
|
|
237
|
+
|
|
238
|
+
- **Log agent suggestions** in your scope decision log with the agent name as source
|
|
239
|
+
- **Apply the same rigor** you would to a PM or executive request
|
|
240
|
+
- **Agents optimize for different things** (code quality, patterns, completeness) than you might need right now
|
|
241
|
+
- **"The agent suggested it" is not a valid reason** to add a feature
|
|
242
|
+
|
|
243
|
+
Common agent-driven scope creep patterns:
|
|
244
|
+
- "Let me also add error handling for edge cases you haven't hit yet"
|
|
245
|
+
- "This would be cleaner with a refactor"
|
|
246
|
+
- "You should probably add tests for this"
|
|
247
|
+
- "Let me add TypeScript types for these additional scenarios"
|
|
248
|
+
|
|
249
|
+
Each of these might be good ideas. None of them are your current scope unless you decide they are.
|
|
250
|
+
|
|
251
|
+
## Recovery: You're Already Bloated
|
|
252
|
+
|
|
253
|
+
If feature creep has already happened:
|
|
254
|
+
|
|
255
|
+
**Step 1: Audit Current Features**
|
|
256
|
+
- List every feature
|
|
257
|
+
- Check usage data for each
|
|
258
|
+
- Identify features with <5% engagement
|
|
259
|
+
|
|
260
|
+
**Step 2: Categorize**
|
|
261
|
+
- Core: Users can't accomplish their goal without it
|
|
262
|
+
- Supporting: Makes core better
|
|
263
|
+
- Peripheral: Nice but not necessary
|
|
264
|
+
- Bloat: Nobody uses it
|
|
265
|
+
|
|
266
|
+
**Step 3: Remove or Hide**
|
|
267
|
+
- Deprecate bloat with warning period
|
|
268
|
+
- Move peripheral features behind advanced settings
|
|
269
|
+
- Communicate changes clearly to users
|
|
270
|
+
|
|
271
|
+
**Step 4: Prevent Recurrence**
|
|
272
|
+
- Add feature creep checks to your PR/code review process
|
|
273
|
+
- Require usage metrics before features graduate from beta
|
|
274
|
+
- Build feature flags so you can easily remove experiments
|
|
275
|
+
|
|
276
|
+
## Quick Reference Commands
|
|
277
|
+
|
|
278
|
+
When reviewing any feature request, ask:
|
|
279
|
+
|
|
280
|
+
```
|
|
281
|
+
1. "What user problem does this solve?"
|
|
282
|
+
2. "What's the smallest version we could ship?"
|
|
283
|
+
3. "What are we NOT building to make room for this?"
|
|
284
|
+
4. "How will we measure success?"
|
|
285
|
+
5. "What happens if we never build this?"
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
If you can't answer these clearly → Do not proceed.
|
|
289
|
+
|
|
290
|
+
## The Golden Rule
|
|
291
|
+
|
|
292
|
+
**Ship something small that works. Then iterate based on real usage data.**
|
|
293
|
+
|
|
294
|
+
Users don't remember features. They remember whether your product solved their problem.
|
|
295
|
+
|
|
296
|
+
Every feature you don't build is:
|
|
297
|
+
- Time you get back
|
|
298
|
+
- Bugs you don't have to fix
|
|
299
|
+
- Documentation you don't have to write
|
|
300
|
+
- Code you don't have to maintain
|
|
301
|
+
- Confusion you don't add
|
|
302
|
+
|
|
303
|
+
The best products aren't the ones with the most features. They're the ones that do the right things exceptionally well.
|
|
304
|
+
|
|
305
|
+
---
|
|
306
|
+
|
|
307
|
+
*"Perfection is achieved not when there is nothing more to add, but when there is nothing left to take away."* - Antoine de Saint-Exupéry
|
|
Binary file
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
|
|
2
|
+
<g clip-path="url(#clip0_3_23)">
|
|
3
|
+
<g clip-path="url(#clip1_3_23)">
|
|
4
|
+
<path d="M10.0643 12.5735C12.3769 12.3166 14.5572 11.0843 15.7577 9.02756C15.1892 14.1148 9.62646 17.3302 5.08583 15.356C4.66743 15.1746 4.30728 14.8728 4.06013 14.4848C3.03973 12.8825 2.7043 10.8437 3.18626 8.99344C4.56327 11.37 7.3632 12.8267 10.0643 12.5735Z" fill="#F3B01C"/>
|
|
5
|
+
<path d="M3.1018 7.50072C2.16436 9.66714 2.12376 12.2034 3.27303 14.2907C-0.771507 11.2479 -0.72737 4.7362 3.2236 1.72378C3.58904 1.44535 4.02333 1.2801 4.47881 1.25494C6.3519 1.15614 8.25501 1.88006 9.58963 3.22909C6.87799 3.25604 4.23695 4.99308 3.1018 7.50072Z" fill="#8D2676"/>
|
|
6
|
+
<path d="M10.8974 3.89562C9.52924 1.98794 7.38779 0.68921 5.04156 0.649695C9.57686 -1.40888 15.1555 1.92867 15.7629 6.86314C15.8194 7.32119 15.7452 7.78824 15.5421 8.20138C14.6948 9.92223 13.1236 11.2569 11.2876 11.7508C12.6328 9.25579 12.4668 6.20748 10.8974 3.89562Z" fill="#EE342F"/>
|
|
7
|
+
</g>
|
|
8
|
+
</g>
|
|
9
|
+
<defs>
|
|
10
|
+
<clipPath id="clip0_3_23">
|
|
11
|
+
<rect width="16" height="16" fill="white"/>
|
|
12
|
+
</clipPath>
|
|
13
|
+
<clipPath id="clip1_3_23">
|
|
14
|
+
<rect width="16" height="16" fill="white"/>
|
|
15
|
+
</clipPath>
|
|
16
|
+
</defs>
|
|
17
|
+
</svg>
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: convex
|
|
3
|
+
displayName: Convex Development
|
|
4
|
+
description: Umbrella skill for all Convex development patterns. Routes to specific skills like convex-functions, convex-realtime, convex-agents, etc.
|
|
5
|
+
version: 1.0.0
|
|
6
|
+
author: Convex
|
|
7
|
+
tags: [convex, backend, database, realtime]
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Convex Development Skills
|
|
11
|
+
|
|
12
|
+
This is an index skill for Convex development. Use specific skills for detailed guidance:
|
|
13
|
+
|
|
14
|
+
## Core Development
|
|
15
|
+
|
|
16
|
+
| Skill | Command | Use When |
|
|
17
|
+
|-------|---------|----------|
|
|
18
|
+
| Functions | `/convex-functions` | Writing queries, mutations, actions |
|
|
19
|
+
| Schema | `/convex-schema-validator` | Defining database schemas and validators |
|
|
20
|
+
| Realtime | `/convex-realtime` | Building reactive subscriptions |
|
|
21
|
+
| HTTP Actions | `/convex-http-actions` | Webhooks and HTTP endpoints |
|
|
22
|
+
|
|
23
|
+
## Data & Storage
|
|
24
|
+
|
|
25
|
+
| Skill | Command | Use When |
|
|
26
|
+
|-------|---------|----------|
|
|
27
|
+
| File Storage | `/convex-file-storage` | File uploads, serving, storage |
|
|
28
|
+
| Migrations | `/convex-migrations` | Schema evolution, data backfills |
|
|
29
|
+
|
|
30
|
+
## Advanced Patterns
|
|
31
|
+
|
|
32
|
+
| Skill | Command | Use When |
|
|
33
|
+
|-------|---------|----------|
|
|
34
|
+
| Agents | `/convex-agents` | Building AI agents with tools |
|
|
35
|
+
| Cron Jobs | `/convex-cron-jobs` | Scheduled background tasks |
|
|
36
|
+
| Components | `/convex-component-authoring` | Reusable Convex packages |
|
|
37
|
+
|
|
38
|
+
## Security
|
|
39
|
+
|
|
40
|
+
| Skill | Command | Use When |
|
|
41
|
+
|-------|---------|----------|
|
|
42
|
+
| Security Check | `/convex-security-check` | Quick security audit checklist |
|
|
43
|
+
| Security Audit | `/convex-security-audit` | Deep security review |
|
|
44
|
+
|
|
45
|
+
## Guidelines
|
|
46
|
+
|
|
47
|
+
| Skill | Command | Use When |
|
|
48
|
+
|-------|---------|----------|
|
|
49
|
+
| Best Practices | `/convex-best-practices` | General patterns and guidelines |
|
|
50
|
+
|
|
51
|
+
## Quick Start
|
|
52
|
+
|
|
53
|
+
For most tasks:
|
|
54
|
+
1. Start with `/convex-best-practices` for general patterns
|
|
55
|
+
2. Use `/convex-functions` for writing backend logic
|
|
56
|
+
3. Use `/convex-schema-validator` for data modeling
|
|
57
|
+
4. Use specific skills as needed for your use case
|
|
58
|
+
|
|
59
|
+
## Documentation
|
|
60
|
+
|
|
61
|
+
- Primary: https://docs.convex.dev
|
|
62
|
+
- LLM-optimized: https://docs.convex.dev/llms.txt
|
|
Binary file
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
|
|
2
|
+
<g clip-path="url(#clip0_3_23)">
|
|
3
|
+
<g clip-path="url(#clip1_3_23)">
|
|
4
|
+
<path d="M10.0643 12.5735C12.3769 12.3166 14.5572 11.0843 15.7577 9.02756C15.1892 14.1148 9.62646 17.3302 5.08583 15.356C4.66743 15.1746 4.30728 14.8728 4.06013 14.4848C3.03973 12.8825 2.7043 10.8437 3.18626 8.99344C4.56327 11.37 7.3632 12.8267 10.0643 12.5735Z" fill="#F3B01C"/>
|
|
5
|
+
<path d="M3.1018 7.50072C2.16436 9.66714 2.12376 12.2034 3.27303 14.2907C-0.771507 11.2479 -0.72737 4.7362 3.2236 1.72378C3.58904 1.44535 4.02333 1.2801 4.47881 1.25494C6.3519 1.15614 8.25501 1.88006 9.58963 3.22909C6.87799 3.25604 4.23695 4.99308 3.1018 7.50072Z" fill="#8D2676"/>
|
|
6
|
+
<path d="M10.8974 3.89562C9.52924 1.98794 7.38779 0.68921 5.04156 0.649695C9.57686 -1.40888 15.1555 1.92867 15.7629 6.86314C15.8194 7.32119 15.7452 7.78824 15.5421 8.20138C14.6948 9.92223 13.1236 11.2569 11.2876 11.7508C12.6328 9.25579 12.4668 6.20748 10.8974 3.89562Z" fill="#EE342F"/>
|
|
7
|
+
</g>
|
|
8
|
+
</g>
|
|
9
|
+
<defs>
|
|
10
|
+
<clipPath id="clip0_3_23">
|
|
11
|
+
<rect width="16" height="16" fill="white"/>
|
|
12
|
+
</clipPath>
|
|
13
|
+
<clipPath id="clip1_3_23">
|
|
14
|
+
<rect width="16" height="16" fill="white"/>
|
|
15
|
+
</clipPath>
|
|
16
|
+
</defs>
|
|
17
|
+
</svg>
|