Skip to content

epistex-dev/poteto-kit / example/.agents/skills/verify-app

verify-app

Verified

Run the real Notes app in headless Chromium, drive it through a feature's scenarios, and produce evidence (screenshot, console log, CDP performance trace, report). Use after any change to src/ and before claiming a feature works, a bug is fixed, or opening a PR. Also use to reproduce a vague bug report or screenshot.

references/worktree-isolation.md

View on GitHub
# Running several copies at once

Parallel agents often work in separate copies or git worktrees of this project. Each copy must be able to build and serve without colliding with the others, and without silently connecting to someone else's server.

## What the verify command does
- It derives the preview port from a hash of the absolute project path (range 20000-31999). The same path always gets the same port; two copies get different ports with high probability.
- If that port is held by another process, it refuses with exit code 3 and names the pid and command. It never falls back to a different port on its own, because a silently different server could be another copy's stale build.
- Pass `--port <n>` to choose a port explicitly. An explicit port is used as given, but it is probed first: if another process holds it, verify refuses with exit 3 and names the holder, and it only drives a server whose `/.verify-build.json` nonce matches the build it just made.
- This example derives a port per project path for every copy, whereas the template's default/`--worktree` model is the alternative for apps with a fixed dev port.
- Artifacts go to `artifacts/` inside the copy, so copies do not overwrite each other. `VERIFY_ARTIFACTS_DIR` overrides it.

## Doctor
Run `npm run verify -- doctor` first whenever a run behaves oddly. It is read-only and reports: the project path, the node version against `engines`, whether the directory is a main git checkout, a linked worktree or neither, which browser binary will be used, whether `dist/` is fresh relative to `src/` and whether it was built with `INJECT_BUG`, and whether the derived port is free or who holds it. Exit code 1 means a blocking problem; a stale `dist/` is only a warning because verify rebuilds it.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall