proof-capture

Record video, capture numbered screenshots, and generate a PR-ready proof package for a feature. Validates that the recording shows the expected feature before presenting results.

Usage

/rn-dev-agent:proof-capture <feature-slug> [description of flow to execute]

Examples

/rn-dev-agent:proof-capture profile-edit navigate to profile, edit name, save, verify update
/rn-dev-agent:proof-capture dark-mode toggle dark mode on settings, check all screens

What Gets Produced

Artifact	Path	Description
Video	docs/proof/<slug>/flow-<platform>.mp4	Screen recording of the entire flow
Labeled video	docs/proof/<slug>/flow-<platform>-labeled.mp4	Video with timed step description bar
GIF	docs/proof/<slug>/flow-<platform>.gif	Animated GIF for inline PR display
Screenshots	docs/proof/<slug>/01-<step>.jpg	Numbered screenshots at each state change
PROOF.md	docs/proof/<slug>/PROOF.md	Flow table with step/screenshot/action/verification
PR-BODY.md	docs/proof/<slug>/PR-BODY.md	Ready-to-paste PR description

Steps

1. Parse arguments — extract feature slug and flow description
2. Environment check — confirm app is running, dismiss Dev Client picker if present
3. Start recording — begin video capture on the active simulator
4. Execute the flow — navigate and interact through each step, capture numbered screenshots
5. Stop recording — end video, convert to GIF
6. Label the video — add timed step descriptions as a text bar
7. Validate — verify recording shows the expected feature, all screenshots exist, no errors
8. Write PROOF.md — date, device info, flow table, state snapshots
9. Generate PR body — ready-to-paste PR description with embedded screenshots

When to Use

• After implementing a feature and wanting PR-ready proof
• To re-record proof after fixing review findings
• Standalone proof capture without the full 8-phase pipeline

Prerequisites

• iOS Simulator or Android Emulator running with the app loaded
• Metro dev server running
• ffmpeg for GIF conversion and video labeling (brew install ffmpeg)