# voiceover

Runs demo-driven feature workflows by agreeing on a voiceover script before opening a git worktree, building code, and filing a PR.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 7523 repo stars
- Author: Devin-AXIS
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Devin-AXIS/iPolloWork/tree/HEAD/.opencode/commands/voiceover.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/voiceover

## What it does

This command swaps out standard PRDs for a narrator script describing an end-user walkthrough. The agent drafts spoken narration frame by frame before touching any code. If an action sounds awkward when spoken aloud, the design gets revised immediately. Coding stays blocked until the draft receives explicit approval.

Once confirmed, the process branches off into a separate directory via `git worktree` based on `dev`. It stores the narration markdown in `evals/voiceovers/<flow-id>.md` and initializes files using `pnpm fraimz scaffold`. An executor subagent handles implementation while the `fraimz` skill runs validation checks on each frame. The flow finishes with `gh pr create` and proof reporting. The workflow fails immediately if `fraimz` or `gh` are absent from the shell environment.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/voiceover.md` — Call it with /voiceover. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/voiceover.md` — Call it with /prompts:voiceover. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/voiceover.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/voiceover.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Devin-AXIS/iPolloWork/tree/HEAD/.opencode/commands/voiceover.md

## When to use it
- draft demo narration scripts to define requirements before coding
- spin up isolated branches using git worktree
- scaffold testable feature flows via pnpm fraimz
- open pull requests with verification proofs attached

## Example prompts
- /voiceover Add CSV export for monthly billing reports
- /voiceover Implement one-time email passcode login

## Similar
- [om-auto-create-pr](https://affpapa.org/en/nevibecode/skills/om-auto-create-pr.md) — skill · 4700 installs
- [ce-worktree](https://affpapa.org/en/nevibecode/skills/ce-worktree.md) — skill · 3200 installs
- [graph](https://affpapa.org/en/nevibecode/skills/graph.md) — skill · 267 installs
- [todo-worktree](https://affpapa.org/en/nevibecode/commands/todo-worktree.md) — command · ★ 1357 repo stars
- [pro-workflow](https://affpapa.org/en/nevibecode/skills/pro-workflow.md) — skill · ★ 2966 repo stars
- [om-auto-create-pr-loop](https://affpapa.org/en/nevibecode/skills/om-auto-create-pr-loop.md) — skill · 4700 installs

From the same set: [devin-axis/ipollowork](https://affpapa.org/en/nevibecode/by/devin-axis/ipollowork.md) — 42 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
