device-lane-proof

Use when a change touches device or Appium behaviour (driver, gestures, locators, ios/adb helpers, runner) and the Definition of Done requires running the focused device lane, or when a PR needs on-device screenshot proof. Explains how to run a real spec on a booted simulator/emulator and where the evidence lands.

Ir a la instalación

Repositorio: BenSheridanEdwards/NativeProof
Última actividad en el origen: 7 de julio de 2026 a las 12:43
Idioma detectado de SKILL.md: inglés
Estrellas: 1
Forks: 2

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

npx skills add https://github.com/BenSheridanEdwards/NativeProof --skill device-lane-proof

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

release-changelog

Use when cutting a NativeProof release, bumping the package version, or writing a CHANGELOG entry. Covers the Keep a Changelog entry format and the GitHub-Release-driven npm publish flow.

2026-07-07

verify-generated-project

Use when a change touches the CLI, init/onboard scaffolding, or the generated project surface (src/cli.ts, templates, runner-config) and the Definition of Done requires proof that the generated project still works. Produces that proof from the packed tarball, not from the repo checkout.

2026-07-07

pr-inline-screenshot-proof

Use when opening or updating a GitHub pull request that needs screenshots, videos, or proof artifacts rendered inline in the PR description instead of shown as plain links.

2026-07-01

Ver todos los de este repositorio

Device Lane Proof

Unit tests fake the driver; they cannot prove that a gesture lands on a real screen. The Definition of Done requires the focused device lane for device/Appium behaviour changes — a real spec, on a real booted target, exercising exactly the changed behaviour. "Focused" means one small spec that hits the change, not the whole suite.

Required Pattern

Confirm a booted target exists:

xcrun simctl list devices booted   # iOS: expect at least one Booted device
adb devices                        # Android: expect a device/emulator line

No booted target and no way to boot one? Stop and write the exact reason in the PR ("Full device coverage not run: ..."). Do not fake the lane.

Get a runnable project pointed at a real app artifact. Either reuse an existing local E2E project, or scaffold one from the packed tarball (see .agents/skills/verify-generated-project/SKILL.md) and run nativeproof onboard <path-to-.app|.apk|ios-repo>.

Write or adapt one focused spec that exercises the changed behaviour using direct native.* calls and plain expect, then run it:

npx nativeproof --ios     # or --android

Collect evidence. NativeProof writes a screenshot + redacted page-source pair for every meaningful step into .e2e-artifacts/ (or the configured artifacts.dir). Pick the screenshots that show the changed behaviour.

Commit the chosen screenshots under docs/proof/<short-scope>/ on the PR branch and embed them inline per .agents/skills/pr-inline-screenshot-proof/SKILL.md. Include the exact command run and its pass/fail output in the PR proof section.

Hard Failures

Proof screenshots taken from a fake/mock driver run — the lane exists precisely because mocks cannot prove device behaviour.

Running the lane against an app or spec that never exercises the changed code path.

Silently skipping the lane. Skipping is allowed; hiding the skip is not — the PR must state why it was not run.

Verification

The spec run exits 0 (or the failure is the point and is explained), .e2e-artifacts/ contains the step screenshots, and the PR body embeds the relevant ones inline with ![alt](...png?raw=1).