modem-dev/ossrules / public/files/kody/.agents/skills/preview-manual-test
preview-manual-test
UnverifiedDiscover, wait for, sign in, create specific user data, and assert a PR preview deploy. Use on medium or high risk PRs, after pushing a ready-for-review PR, or when the user asks to test the preview URL.
Manual preview testing
Read
docs/contributing/preview-manual-testing.md.
Do not improvise gh comment scraping, local E2E against the preview URL, or
raw D1 seeding of preview resources.
Prefer control-kody when you also need doctor,
local login, Feature Map lookup, or a /health SHA check:
npm run control-kody -- preview -- --request 'GET /onboarding.json' --check /onboarding/step-2
Command
npm run preview:manual-test
On medium or high risk, do not stop at the default health/login smoke. The
seed user (me@kentcdodds.com / ilikecode, username user-me) has no
secrets, packages, or jobs until you create them. Script that data and the
assertions as the same logged-in user:
npm run preview:manual-test -- \
--request 'POST /onboarding/checklist-dismiss.json {}' \
--request 'GET /onboarding.json' \
--check /onboarding/step-2
--request spec: METHOD /path [status] [json-body] (default success: 2xx).
Use the JSON APIs the UI uses (/account/*.json in
packages/worker/universal/routes.ts). --json includes
session.cookieHeader; --cookie-file writes it for follow-up curl.
--pr, --url, --no-wait, --skip-login, --help as documented.
When
After the PR is ready for review (drafts and forks have no preview) and you
have pushed the commits you want to exercise. Typical triggers: visual-recap
risk is medium (extends) or high (adds); auth, workers, or
deploy-path behavior changed; the user asked to try the preview.
This does not replace npm run validate.
After the scripted session
- Open the printed URL. On Cloud Agents, use the
computerUsesubagent. - Sign in at
/loginwith the seed credentials. Button label is Sign in. - Confirm the data you created and exercise the UI this PR changes. Stay on the preview origin.
- Record what you saw on the PR.
GET /mcp is 401 without OAuth; /admin is 403 (seed account is not admin).
Neither is a regression.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |