# Plan Your Prisma MongoDB Upgrade

Prisma ORM v7 does not support MongoDB, so standard upgrade advice fails. This skill evaluates Prisma Next and provides a staged migration path.

## Install

```bash
npx skillstore add prisma/prisma-mongodb-upgrade
```

## Metadata

- Status: approved
- Slug: prisma-prisma-mongodb-upgrade
- Version: 0.1.0
- Author version: 0.1.0
- Skillstore revision: r2
- Version status: valid
- Tree hash: c1ae18d2472846de414e0108c8bcd251100f09ba36bd671b8ebc284f5595ec52
- Author: prisma
- GitHub username: prisma
- License: MIT
- Repository: https://github.com/prisma/skills/tree/1a9f427e9fe2137298abbcc1a6f372db92e8c40d/prisma-mongodb-upgrade
- Ref: ebdfe608f5de2b66ff37ab4af12af8ac4f5e8006
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: env\_access, external\_commands, network
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/prisma-prisma-mongodb-upgrade
- Manifest: https://skillstore.pages.dev/api/skills/prisma-prisma-mongodb-upgrade/manifest

## Capabilities

- Explains why Prisma ORM v7 is unavailable for MongoDB projects.
- Evaluates whether a project should adopt Prisma Next or remain on Prisma ORM v6.
- Maps v6 schemas, client calls, raw queries, and transactions to Prisma Next concepts.
- Maps the db push workflow to Prisma Next migration stages.
- Provides staging, index, validator, transaction, cutover, and rollback checks.

## Use Cases

- Choose an upgrade path: Determine whether a MongoDB application should remain on Prisma ORM v6 or evaluate Prisma Next.
- Assess migration readiness: Inventory transactions, raw calls, server requirements, indexes, and schema contracts before committing to migration.
- Plan a controlled cutover: Prepare staging verification, read-only comparison, production cutover, and rollback steps for an existing service.

## Prompt Templates

### Check my upgrade options

```
My project uses Prisma ORM v6 with MongoDB. Explain my supported upgrade options and the main tradeoffs.
```

### Assess project blockers

```
Review this repository for Prisma MongoDB migration blockers. Check transactions, raw queries, MongoDB version assumptions, and package versions.
```

### Create a migration plan

```
Create a staged Prisma Next migration plan for this application. Include schema mapping, API changes, migration verification, and rollback gates.
```

### Audit a production cutover

```
Audit this proposed Prisma Next cutover. Identify data, index, validator, transaction, deployment, and rollback risks with actionable corrections.
```

## Limitations

- Prisma Next is Early Access, so interfaces may differ from this skill's verified source revision.
- The skill provides guidance but does not guarantee application behavior or data compatibility.
- Prisma Next requires MongoDB 8.0 or newer and the supported MongoDB driver.
- Transaction migration currently requires direct MongoDB driver sessions.

## Best Practices

- Verify Prisma Next behavior against the exact installed version before changing the application.
- Run contract, index, validator, and query checks against a staging copy before production.
- Keep Prisma ORM v6 deployable until Prisma Next verification and read-only comparison pass.

## Anti Patterns

- Do not attempt a Prisma ORM v7 upgrade because it has no MongoDB connector.
- Do not change the application to SQL as an implicit solution to the version problem.
- Do not apply push-style production changes without migration history, verification, and rollback planning.

## Security Audit

- Audited at: 2026-07-23T17:48:44.727\+00:00
- Summary: All 24 static findings are false positives caused by documentation links, inline code, and command names in Markdown. No executable scripts, credential access, unsafe network behavior, or prompt injection was found.

## Stats

- Views: 0
- Downloads: 3
- Favorites: 0
- Popularity score: 0