Skip to content

AgentiaPT/vela-slides / .claude/skills/burst-bug-hunter

burst-bug-hunter

Verified

Time-boxed adversarial bug-hunting of a LIVE app driven by MULTI-STEP PLAYWRIGHT BURSTS against a persistent warm browser — not one LLM turn per CLI step. The app is opened ONCE; the agent submits full scripts that run to completion unattended (one structured result per burst); reset to a known initial state between scenarios; inherit the implementer's driver verbs instead of re-predicting selectors. Generic / repo-agnostic: all app specifics come from the repo's own config. Use when hunting bugs in a browser-drivable app under a hard wall-clock budget.

FileKindSize
.gitignoreother20 B
SKILL.mdskill md5.9 KB
assets/driver-server.mjsscript20.4 KB
assets/example-burst.mjsscript1.3 KB
assets/start-hunt.shexecutablescript744 B
assets/test-timeout-isolation.mjsscript18.9 KB
assets/vrunexecutablescript2.0 KB

assets/vrun

View on GitHub
#!/usr/bin/env bash
# vrun — submit a multi-step Playwright job (burst) to the persistent warm-app server
# and block until it returns the full structured result. One call = one whole burst.
#
#   vrun <job.mjs>            run a job file (export async function run(page, ctx))
#   vrun --reset              reset app to known initial state
#   vrun --shutdown           stop the server
#   vrun --inline 'CODE'      run an inline body: `export async function run(page,ctx){ CODE }`
#   vrun --finding '{json}'   append one finding line to $VDRIVE/findings.jsonl (no server round-trip)
#
# Env: VDRIVE=<workdir> (default /tmp/burst-drive)
set -euo pipefail
WORK="${VDRIVE:-/tmp/burst-drive}"
INBOX="$WORK/inbox"; OUTBOX="$WORK/outbox"
mkdir -p "$INBOX" "$OUTBOX"

if [ "${1:-}" = "--finding" ]; then printf '%s\n' "$2" >> "$WORK/findings.jsonl"; echo "recorded"; exit 0; fi

id="j$(date +%s%N)"
case "${1:-}" in
  --reset)    id="reset-$id"; : > "$INBOX/$id.mjs" ;;
  --shutdown) id="shutdown-$id"; : > "$INBOX/$id.mjs" ;;
  --inline)   printf 'export async function run(page, ctx){\n%s\n}\n' "$2" > "$INBOX/$id.mjs" ;;
  *)          [ -f "${1:-}" ] || { echo "vrun: job file not found: ${1:-}" >&2; exit 2; }
              cp "$1" "$INBOX/$id.mjs" ;;
esac

# Client wait is bounded to a few seconds over the server's job cap (VRUN_WAIT, default
# 15s). The server ALWAYS writes a result within its JOB_TIMEOUT_MS (~8s) even for a
# hung burst, so THIS job's own call never blocks longer than this. A job queued right
# behind one that just timed out may also wait on the server's bounded recovery budget
# (recoverBudgetMs, default 5s) — repo configs must keep jobTimeoutMs + recoverBudgetMs
# comfortably under VRUN_WAIT. Never 180s.
WAIT_ITERS=$(( ${VRUN_WAIT:-15} * 5 ))
for _ in $(seq 1 "$WAIT_ITERS"); do
  if [ -f "$OUTBOX/$id.json" ]; then cat "$OUTBOX/$id.json"; rm -f "$OUTBOX/$id.json"; exit 0; fi
  sleep 0.2
done
echo '{"ok":false,"error":"vrun: no server result within '"${VRUN_WAIT:-15}"'s (server down or overloaded)"}' >&2; exit 1
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall