Skip to content

Kartik-Doye/Ravengard-AI-Recruiter / .agents/skills/roadtest

roadtest

Verified

Verifies a small set of critical user journeys in a real browser using user-facing locators, isolated state, rendered outcomes, and relevant console or network evidence. Use when browser-dependent behavior must be exercised like a user.

FileKindSize
SKILL.mdskill md10.3 KB
references/evidence-bundle.mdmarkdown2.6 KB
references/research.mdmarkdown793 B
scripts/test-matrixother2.1 KB

references/evidence-bundle.md

View on GitHub
# Evidence bundle: format and storage

The bundle makes "it worked" auditable. Directory per run:

```text
docs/reports/roadtest-<slug>/
  report.md                    ← human-readable summary (format below)
  2026-09-14-login/            ← one dir per critical path
    01-initial-load.png
    02-form-filled.png
    03-after-submit.png
    console.log                ← full console capture for the path
    network.log                ← failed/slow requests with status + timing
    result.txt                 ← PASS / FAIL + one-line reason
```

`<slug>`: short kebab-case feature or release name, with an optional date
if runs repeat over time.

## report.md format

```markdown
<!-- generated by roadtest on YYYY-MM-DD HH:MM -->
# Roadtest: <slug>

**Rung:** browser (1) | HTTP (2) | static (3)
**Environment:** URL · viewport(s) · browser/tool · app commit/branch

| Path | Result | Evidence |
| --- | --- | --- |
| Login with magic link | PASS | 2026-09-14-login/ |
| Create order end-to-end | FAIL | 2026-09-14-order/ (500 on submit) |

## Findings
- console: 2 unhandled promise rejections on /checkout (evidence: …)
- network: POST /api/orders → 500 (trace id in network.log)
- responsive: checkout form unusable at 390px (screenshot 03)
- automation: healed locator on 'Submit' button (data-testid missing, fell back to XPath)

## Unverified
- payment provider redirect: sandbox unavailable this run
```

## Capture rules

- Screenshot **at the assertion moment**: the state the result claim is
  about, named sequentially (`01-…`, `02-…`).
- Console/network logs: full session capture per path, failures
  highlighted at the top of the excerpt in report.md.
- A PASS with no screenshots is an unverified claim: rung discipline
  applies to us too.
- Failed paths keep their failing evidence; don't overwrite with the
  post-fix re-run: the re-run is a new path dir (or `-rerun` suffix).

## Screenshot discipline

A screenshot alone does not prove a flow works: it proves one pixel
state at one moment. Every screenshot pair must be tied to the
assertion it evidences ("after submit: order visible in table"), and
the result.txt records the checks that passed (console clean, network
clean, interaction worked), not just "looks right".

## What does NOT go in the bundle

- Credentials, tokens, session cookies (mask in screenshots; redact in
  logs: evidence files ship with the repo).
- Personal/test data beyond what the flow requires; use obviously-fake
  payloads (`test@example.com`, `REDACTED`).
- Video dumps when screenshots suffice: the bundle should be reviewable
  in a browser tab, not a media player.
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall