# Major Version Mode

> Contexto para trabajar en la próxima versión mayor del AI SDK. Úsalo solo si el usuario lo invoca explícitamente, por ejemplo con '/major-version-mode'; no se activa de forma autónoma.

Fuente: https://skillsagentes.com/skills/vercel/ai/major-version-mode
Markdown: https://skillsagentes.com/skills/vercel/ai/major-version-mode.md

Repositorio: https://github.com/vercel/ai
Autor: vercel
Licencia: NOASSERTION
Actualizado: hace 4 meses
Coste de contexto: 46 tok instalada, 802 tok al activarse, 802 tok con todos los archivos del bundle
Bundle: 1 archivo, 3 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add vercel/ai --skill major-version-mode --agent claude-code
# Cursor
npx -y skills add vercel/ai --skill major-version-mode --agent cursor
# Codex
npx -y skills add vercel/ai --skill major-version-mode --agent codex
# Gemini CLI
npx -y skills add vercel/ai --skill major-version-mode --agent gemini
# Windsurf
npx -y skills add vercel/ai --skill major-version-mode --agent windsurf
# Cline
npx -y skills add vercel/ai --skill major-version-mode --agent cline
```

## Qué hace

- Aplica pautas para trabajar en la próxima versión mayor del AI SDK, aceptando breaking changes
- Indica cuándo dar alias deprecados vs. hacer un cambio limpio en exports renombrados
- Define reglas para modificar tipos de mensajes y el spec de `@ai-sdk/provider`
- Exige actualizar la documentación en `content/docs/` y la guía de migración vigente tras los cambios

## Cuándo usarla

- El usuario invoca explícitamente el modo, por ejemplo con '/major-version-mode'

## Cuándo no

- No debe activarse de forma autónoma según el contenido de la tarea

## Qué la activa

- "/major-version-mode"
- "Activa major-version-mode para este cambio de la próxima versión mayor del AI SDK"

## Antes de instalar

- Solo debe usarse cuando el usuario lo invoca explícitamente para trabajar en la próxima versión mayor del AI SDK.

## Archivos

- SKILL.md — 3 KB

## SKILL.md

Reproducido tal cual desde vercel/ai bajo NOASSERTION. Esta sección es el documento original y está en inglés.

## Context

This task is part of the next AI SDK major release. Breaking changes are acceptable.

## Breaking Change Guidelines

While breaking changes are acceptable, it is still encouraged to minimize unnecessary disruption for 3P consumers of the AI SDK. Providing deprecated aliases and automated migration logic can help ease the transition.

### Renamed/changed exports

If renaming or modifying an exported function or type, provide a deprecated alias as a package-level export where feasible:

```typescript
/** @deprecated Use `newFunctionName` instead. */
export { newFunctionName as oldFunctionName } from './new-module';
```

Only do this if it doesn't introduce meaningful technical debt. If it does, skip the alias — but **check with the user first** before making a clean break.

### Modified message types (e.g. in `@ai-sdk/provider-utils`)

If modifying model message shapes (e.g. content part types in `packages/provider-utils/src/types/content-part.ts`):

1. **Deprecate in `@ai-sdk/provider-utils`** rather than removing immediately, if feasible. Mark deprecated types/members with a `@deprecated` JSDoc comment and a `TODO` note to remove in the following major version.
2. **Keep deprecated equivalents in `packages/ai/src/prompt/content-part.ts`** — this file is the consumer-facing layer and should retain the old shapes in the Zod schemas so existing consumer code continues to compile with a deprecation warning. Include a similar note about deprecation and removal in the following major version.
3. If clean deprecation isn't feasible without meaningful technical debt, a hard removal may be preferred — but **check with the user first**.

### Provider spec changes (`@ai-sdk/provider`)

The `provider` package defines the spec that provider implementers code against. It should generally not be modified outside of major versions, so keeping the spec clean and consistent is critical.

Breaking changes _without_ maintaining temporary backward compatibility measures are more acceptable here than elsewhere, because the audience is smaller — far fewer developers implement their own providers than build features on top of the AI SDK.

Rules:

- **Only modify the latest spec version.** Older versioned spec interfaces must remain completely untouched.
- Deprecated aliases are not required — a clean break is preferred to preserve spec clarity.
- The current spec version is **not** the same as the current AI SDK major version number. If it's unclear which spec version to operate on, **ask the user before proceeding**.

## Documentation

After implementing changes, update relevant documentation in `content/docs/`.

If the change requires consumers to update their code or migrate stored data, add a section to the latest migration guide:

- Find the migration guide with the highest version number in `content/docs/08-migration-guides/`
- Add a concise section explaining what changed and how to migrate

## Dónde encaja

- Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código.
- Creador: [vercel](https://skillsagentes.com/creators/vercel.md) — 84 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Skills relacionadas

- [Add Harness Package](https://skillsagentes.com/skills/vercel/ai/add-harness-package.md): Guía para añadir nuevos paquetes harness de AI SDK. Úsala al crear un paquete @ai-sdk/harness-<name> que adapte un runtime de coding-agent a HarnessV1.
- [Add Provider Package](https://skillsagentes.com/skills/vercel/ai/add-provider-package.md): Guía para añadir paquetes de proveedores de IA de primera parte al AI SDK. Úsala al crear un paquete de proveedor bajo packages/ para integrar un servicio de IA externo.
- [Develop Ai Functions Example](https://skillsagentes.com/skills/vercel/ai/develop-ai-functions-example.md): Desarrolla ejemplos para las funciones del AI SDK; úsalo al crear, ejecutar o modificar ejemplos bajo examples/ai-functions/src para validar soporte de providers o demostrar features.
- [Capture Api Response Test Fixture](https://skillsagentes.com/skills/vercel/ai/capture-api-response-test-fixture.md): Captura fixtures de test con las respuestas reales de las APIs de los proveedores.
- [Island Rescue](https://skillsagentes.com/skills/vercel/ai/island-rescue.md): Cómo ser rescatado de una isla solitaria.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)