// Run the full WealthWise pre-PR checklist and report a pass/fail for each gate. Triggers when asked to "run pre-PR checks", "check if this is ready to merge", "validate before opening a PR", or "run the full check". Does NOT trigger implicitly.
Execute the Flywheel bead lifecycle — find, claim, implement, review, close
Manage the WealthWise Docker/Podman Compose development environment. Triggers when asked to "start Docker", "start Podman", "bring up the containers", "stop Docker", "show Docker logs", or "restart the dev environment". Does NOT trigger implicitly.
Check the health of the running WealthWise API, web app, and MongoDB services. Triggers when asked to "check if the app is running", "verify the API is up", "is the server healthy", or "show service status".
Scaffold a complete new API endpoint for the WealthWise Express API. Triggers when asked to "add an endpoint", "create a route", "build an API for <entity>", or scaffold any new REST resource end-to-end. Does not trigger for frontend-only tasks.
Seed the WealthWise MongoDB database with categories or demo data. Triggers when asked to "seed the database", "add demo data", "populate categories", or "set up test data". Does NOT trigger implicitly during general development tasks.
Scaffold a new Mongoose model and its CRUD service for the WealthWise API. Triggers when asked to "create a model", "add a Mongoose schema", or add the data layer for a new entity without a full endpoint. Does NOT scaffold routes, controllers, or frontend code. Use $api-endpoint for the full stack.
| name | pre-pr |
| description | Run the full WealthWise pre-PR checklist and report a pass/fail for each gate. Triggers when asked to "run pre-PR checks", "check if this is ready to merge", "validate before opening a PR", or "run the full check". Does NOT trigger implicitly. |
Run the full pre-PR checklist for WealthWise. Report pass/fail for each gate.
--all is specified)npm run format:check
If it fails, run npm run format to fix, then re-check.
npm run lint
Runs tsc --noEmit across all three packages via Turbo. All must pass.
npm run test
All 330 tests must pass (138 API + 41 web + 151 shared-types).
npm run build
Production build must compile without errors. Validates Next.js output and API TypeScript.
npm audit --audit-level=high
High or critical vulnerabilities block the PR. Low/moderate are informational.
git status && git diff --stat HEAD
git branch --show-current
Verify:
.env filesmain or mastersk-, ghp_, mongodb+srv://, Bearer )Present results as a table:
| Gate | Status | Notes |
|---|---|---|
| Format | ✓/✗ | |
| Type check | ✓/✗ | |
| Tests | ✓/✗ | X/330 passed |
| Build | ✓/✗ | |
| Audit | ✓/✗ | |
| Branch | ✓/✗ | Branch: <name> |
If all gates pass: "Ready to open PR." If any gate fails: list exactly what must be fixed before the PR can be opened.