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/extension/upgrades/8.0.0-rc.10-to-8.0.0-rc.11/instructions.md

upgrading/extension/upgrades/8.0.0-rc.10-to-8.0.0-rc.11/instructions.mdBrowse 76 files
View on GitHub
489 tokens

1,669 bytes
Token encoding: o200k_base
Snapshot fac8604

← Back to SKILL.md

from: "8.0.0-rc.10" to: "8.0.0-rc.11" changes:

  • id: engine-pin-moves-to-0-4-0 summary: | The toolchain now requires @prisma/cli-engine@0.4.0 (up from 0.3.0). An extension that pins @prisma/cli-engine in its own manifests must move the pin to 0.4.0. The new engine adds a --format markdown output format to every command and widens its Format type to "human" | "json" | "markdown"; nothing else in its public API changed. detection: glob: "**/package.json" contains: - '"@prisma/cli-engine": "0.3.0"'
  • id: contract-space-restamp summary: | The emitted contract.json / contract.d.ts embed the toolchain version, which moves to 8.0.0-rc.11. Rebuild the extension's contract space (the package's build:contract-space script) once after upgrading so the emitted artifacts match the installed toolchain. detection: glob: "**/contract.json" contains: - '"version": "8.0.0-rc.10"'

8.0.0-rc.10 → 8.0.0-rc.11 — Extension author upgrade instructions

engine-pin-moves-to-0-4-0

For every package.json matched by detection, change the @prisma/cli-engine version from 0.3.0 to 0.4.0 and reinstall. Code that names the engine's Format type must accept the new "markdown" member; an exhaustive switch over the format now needs a markdown branch. Nothing else changes.

contract-space-restamp

For every contract.json matched by detection, run the extension package's build:contract-space script (or its emit command) once after upgrading. The only expected diff is the embedded version moving to 8.0.0-rc.11.

← All Prisma ORM skillsProject instructions →