ossrules.md

prisma-8

Use when working in a project that depends on @prisma/orm-postgres, @prisma/orm-sqlite, or @prisma/orm-mongo (Prisma 8, formerly Prisma Next): editing contract.prisma or a contract.ts builder, running `prisma contract emit`, planning or applying migrations, editing migration.ts, writing db.orm / db.sql / db.query queries, wiring db.ts or middleware, integrating a build tool, using the Supabase extension or RLS, or reading a dotted error code such as MIGRATION.HASH_MISMATCH. Use when the user asks "what is Prisma 8", "where do I start", or compares it to another ORM. Use when the user asks to upgrade or bump Prisma 8 in an app or an extension package. Use when you see @internal/* or @prisma/orm-* imports, prisma.config.ts with definePrismaConfig, or contract.json / contract.d.ts. Do not use for Prisma ORM 7 or earlier (schema.prisma + @prisma/client).

Install
npx skills add 'https://github.com/prisma/orm/tree/main/skills/prisma-8'
Download bundle ↓
main · fac8604 ↗Scanned 2026-09-17

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

upgrading/app/upgrades/8.0.0-rc.7-to-8.0.0-rc.8/instructions.md

upgrading/app/upgrades/8.0.0-rc.7-to-8.0.0-rc.8/instructions.mdBrowse 76 files
View on GitHub
532 tokens

1,821 bytes
Token encoding: o200k_base
Snapshot fac8604

← Back to SKILL.md

from: "8.0.0-rc.7" to: "8.0.0-rc.8" changes:

  • id: engine-pin-moves-to-0-3-0 summary: | The toolchain now peers @prisma/cli-engine@0.3.0 (up from 0.2.3). Projects assembled by the unified prisma CLI resolve the engine automatically. A project that pins @prisma/cli-engine itself must move the pin to 0.3.0. The engine now declares @prisma/management-api-sdk as a peer dependency (^1.55.0) instead of a regular dependency; the prisma CLI shell supplies it at runtime, so only a project that runs the engine outside the CLI shell needs to install the SDK itself. detection: glob: "**/package.json" contains: - '"@prisma/cli-engine": "0.2.3"'
  • id: contract-artifacts-restamp summary: | The emitted contract.json / contract.d.ts embed the toolchain version, which moves to 8.0.0-rc.8. Run contract emit once after upgrading so the emitted artifacts match the installed toolchain. detection: glob: "**/contract.json" contains: - '"version": "8.0.0-rc.7"'

8.0.0-rc.7 → 8.0.0-rc.8 — User upgrade instructions

engine-pin-moves-to-0-3-0

For every package.json matched by detection, change the @prisma/cli-engine version from 0.2.3 to 0.3.0 and reinstall. If the project runs the engine outside the unified prisma CLI shell (rare), also install @prisma/management-api-sdk at a version satisfying ^1.55.0 — the engine now declares it as a peer dependency and no longer bundles it.

contract-artifacts-restamp

For every contract.json matched by detection, run the project's emit command (prisma contract emit, or the project's contract:emit script) once after upgrading. The only expected diff is the embedded version moving to 8.0.0-rc.8.

← All Prisma ORM skillsProject instructions →