Understand software before you change it. Paste a repo or URL, inspect the evidence, explore, think, plan.
npm run dev # localhost:5173
npm run health # stack + services
npm run verify:ui # every browser action, checked from CLI
npm run verify:live-site # black-box check of the served appSee CHANGELOG.md for the release history and TESTING.md for the testing contract.
GitHub Actions owns CI and verification (.github/workflows/ci.yml). Vercel owns deployment.
Checkout
↓
npm ci
↓
npm run lint
↓
npm run typecheck
↓
npm test
↓
npm run build
↓
security/bundle check (no OpenRouter key in dist/)
Runs on every PR and push to main. Post-deploy verify:live-site gets its own workflow once the Vercel URL exists.