Initial commit: YouTube Studio Flow (backend, frontend, infrastructure, docs)

documentation/YouTube Studio Flow/05 - Development/06 - Verifying Changes.md

@@ -0,0 +1,82 @@
+# Verifying Changes
+
+Commands to check your work after making changes. Run these before considering a task done.
+
+---
+
+## Backend
+
+Run from the `backend/` directory.
+
+### Type check + compile
+
+```bash
+npm run build
+```
+
+`nest build` compiles all TypeScript and surfaces type errors. This is the primary way to verify backend changes are type-correct. Fix all errors before finishing.
+
+### Lint
+
+```bash
+npm run lint
+```
+
+Runs ESLint with auto-fix on `src/**/*.ts`. Run after making changes to catch style violations. If auto-fix changes files, review the diff.
+
+### Tests
+
+```bash
+npm run test
+```
+
+Runs the Jest test suite. Run when modifying shared services, the render engine, or any logic that has existing tests.
+
+---
+
+## Frontend
+
+Run from the `frontend/` directory.
+
+### Type check + build
+
+```bash
+npm run build
+```
+
+`next build` compiles TypeScript and runs the full Next.js production build. It catches type errors, missing imports, and invalid JSX. The most thorough check available for the frontend.
+
+### Lint
+
+```bash
+npm run lint
+```
+
+Runs `next lint` (ESLint). Run after making changes to catch import order violations, unused variables, and React-specific issues.
+
+---
+
+## After schema changes
+
+After any modification to `backend/prisma/schema.prisma`:
+
+```bash
+# Stop the backend and worker first, then:
+npx prisma generate          # regenerate the Prisma client
+npx prisma migrate deploy    # apply pending migrations
+# Restart both backend processes
+```
+
+If you used `migrate dev` locally to create a migration file, commit the generated file in `backend/prisma/migrations/`.
+
+---
+
+## Checklist
+
+| Change type | Commands to run |
+|---|---|
+| Backend logic change | `npm run build` → `npm run lint` |
+| Render engine / shared service | `npm run build` → `npm run test` |
+| Prisma schema change | `npx prisma generate` → `npx prisma migrate deploy` → `npm run build` |
+| Frontend component change | `npm run build` → `npm run lint` |
+| Both frontend and backend | Run both sets above |