VibeReview
Use the VibeReview headless CLI to capture evidence from an actual browser-game playtest.
Preflight
- Read the target repository's instructions and review ledgers.
- Locate a headless
vibereviewbinary. Prefer a project-relative build, then the known development checkout. Inspect unknown symlinks before executing them. - Reject GUI app-bundle executables and do not assume a bare
vibereviewcommand is the CLI. - Verify the selected binary with
--version. - Open and play the game with the available browser-control capability before capturing evidence. Use an existing authenticated browser only when the session requires it.
Session workflow
Use the verified CLI path for all commands:
"<vibereview-cli>" start --project <path> [--title <title>]
"<vibereview-cli>" capture --project <path> --note <text> [--severity note|polish|issue|blocksRelease] [--rating 1...5] [--tags a,b,c]
"<vibereview-cli>" capture --project <path> --note-file <path-or->
"<vibereview-cli>" end --project <path>
"<vibereview-cli>" status [--project <path>]
"<vibereview-cli>" list
- Start or inspect the intended session.
- Capture only after observing the relevant state. Write concrete notes describing the action, observed result, and user impact.
- Use
blocksReleaseonly for evidence that genuinely blocks release. - End the session and inspect the written artifacts.
- Check
git statusbecause VibeReview may add media and mutate review ledgers.
Spiral-HTML integration
Before classifying findings, read AGENTS.md, docs/PLAYTEST.html, docs/FOLLOWUPS.html, docs/OPEN_QUESTIONS.html, and docs/FUN_FACTOR_AUDIT.html when present.
- Preserve append-only
data-*entries. - Map severe evidence to a
blocks-releasefollow-up unless the CLI already created one. - Put ambiguous product choices in
OPEN_QUESTIONS.htmlwith options and a recommended default. - Put experience-level gaps in
FUN_FACTOR_AUDIT.html; do not mark implementation coverage complete merely because evidence was captured. - For legacy Markdown projects, preserve artifacts without silently converting the ledger format.
Finish with the session ID, captured evidence, ledger changes, follow-ups, and any unverified behavior.