docs: add upgrade section to installation and expand AI agents guide#95861
Merged
Conversation
Add an Upgrade section to the installation page: the next upgrade command, why frequent updates matter (security patches, bug fixes, optimizations, new features), and that upgrading also updates the docs bundled in the next package, with a prompt for agents to catch up after an upgrade. Expand the AI agents guide beyond bundled docs: runtime visibility (browser logs forwarded to the terminal, structured error copy, the MCP server for querying dev-server state) and skills for multi-step workflows. Cover the 16.2 case where docs are bundled but AGENTS.md is not auto-generated, and cross-link the upgrading page.
Contributor
Stats skippedCommit: 22863fe |
Contributor
Tests PassedCommit: 22863fe |
Contributor
There was a problem hiding this comment.
Pull request overview
Adds new documentation content to encourage keeping Next.js up to date and to expand guidance for AI-agent workflows by emphasizing bundled docs plus runtime/debugging visibility.
Changes:
- Added an “Upgrade your Next.js app” section to Installation, documenting
next upgradeand how upgrades also refresh the bundled docs. - Expanded the AI agents guide with cross-links to upgrading/CLI docs plus new sections on runtime visibility (terminal-forwarded browser logs, MCP) and multi-step workflow “skills”.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| docs/01-app/02-guides/ai-agents.mdx | Adds links plus new sections describing runtime visibility and skills for agent workflows. |
| docs/01-app/01-getting-started/01-installation.mdx | Adds a new “Upgrade your Next.js app” section with next upgrade examples and links to upgrading/agents docs. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Reference the current logging.browserToTerminal config instead of the deprecated browserDebugInfoInTerminal, and use the shorter 'npx skills add vercel/next.js --skill <name>' form to match the other guides.
aurorascharff
marked this pull request as draft
July 16, 2026 19:43
aurorascharff
marked this pull request as ready for review
July 16, 2026 21:05
3 tasks
icyJoseph
reviewed
Jul 21, 2026
icyJoseph
reviewed
Jul 21, 2026
icyJoseph
approved these changes
Jul 21, 2026
![vercel[bot]](https://avatars.github.com/in/8329?s=60&v=4){kind=small}
aurorascharff
enabled auto-merge (squash)
July 21, 2026 11:31
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
DOC-6499, two changes:
Installation: new "Upgrade your Next.js app" section. The
next upgradecommand, why frequent updates matter (security patches, fixes, optimizations, new features), and that upgrading also updates the docs bundled in thenextpackage, with a prompt for agents to catch up after an upgrade. Links the Upgrading page for version guides.AI agents guide expanded. Beyond bundled docs: runtime visibility (browser logs forwarded to the terminal, structured error copy, the MCP server for querying dev-server state) and skills for multi-step workflows. Covers the 16.2 case where docs are bundled but
AGENTS.mdis not auto-generated, and cross-links Upgrading.Claims verified against source (
next-upgrade.ts,agentRules,browserDebugInfoInTerminal,--no-agents-md). Docs-only.