# spec-first-mvp

The spec-first-mvp skill stops development before implementation and requires a short spec, a list of throwaway probes, and a go/no-go decision point.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 475 repo stars
- Author: cnfjlhj
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cnfjlhj/ai-collab-playbook/tree/HEAD/skills/full/spec-first-mvp/SKILL.md
- Updated: 2026-10-13
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/spec-first-mvp

## What it does

The skill inserts a validation step between idea and code. It forces the agent to turn the initial idea into a spec seed: the problem, user context, first hypothesis, explicit non-goals, and a pass/fail signal. Then the agent proposes 1–3 throwaway probes — a static page, one prompt with example I/O, or a minimal scoring script. Each probe tests one risky assumption.

After running the probe, the agent updates the spec with evidence rather than expanding the original fantasy unchanged. Only when the result is measured and the go/no-go decision is made does the skill hand off control — to brainstorming, planning, or direct execution. This is a text workflow, no external tools required.

The skill is useful for tools, research helpers, personal knowledge systems, and product concepts whose shape is still unstable.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill spec-first-mvp -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/spec-first-mvp/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/spec-first-mvp/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill spec-first-mvp -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/spec-first-mvp/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill spec-first-mvp -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/spec-first-mvp/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cnfjlhj/ai-collab-playbook skills/full/spec-first-mvp
```

2. **Manually: put the files in place**
- File: `.github/skills/spec-first-mvp/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill spec-first-mvp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cnfjlhj/ai-collab-playbook --path skills/full/spec-first-mvp
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/spec-first-mvp/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/cnfjlhj/ai-collab-playbook/tree/HEAD/skills/full/spec-first-mvp/SKILL.md

## When to use it
- stop implementation before the scope is stable
- separate the real problem from guesses and wishful extras
- test a risky assumption with a throwaway probe
- update the spec with evidence after an experiment
- make a go/no-go decision based on a measurable signal

## Example prompts
- Stop, don't write code yet — first turn this idea into a spec seed
- Propose three throwaway probes to test whether this concept works
- Update the spec with what we learned from the probe and decide whether to continue

## Similar
- [pol-probe](https://affpapa.org/en/nevibecode/skills/pol-probe.md) — skill · 2500 installs
- [spec-impl](https://affpapa.org/en/nevibecode/skills/spec-impl.md) — skill · 4900 installs
- [build-mvp](https://affpapa.org/en/nevibecode/skills/build-mvp.md) — skill · 1700 installs
- [gsd-mvp-phase](https://affpapa.org/en/nevibecode/skills/gsd-mvp-phase.md) — skill · 570 installs
- [spec](https://affpapa.org/en/nevibecode/skills/codewithmukesh-spec.md) — skill · 3900 installs
- [cursor-spec-interviewer](https://affpapa.org/en/nevibecode/skills/cursor-spec-interviewer.md) — skill · 2700 installs

From the same set: [cnfjlhj/ai-collab-playbook](https://affpapa.org/en/nevibecode/by/cnfjlhj/ai-collab-playbook.md) — 18 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
