پارادایس کداستودیوی نرم‌افزار
بازگشت به مقالات
آپدیت تکنولوژیبه‌روزرسانی ۱۵ دقیقه مطالعه

نکست‌جی‌اس ۱۶.۳: ناوبری آنی، AGENTS.md و ابزارهای ایجنت

نسخه پایدار Next.js 16.3 با Instant Navigations، مصرف حافظه کمتر در dev، داکیومنت نسخه‌بندی‌شده برای ایجنت‌ها و Skills مثل next-dev-loop منتشر شد. راهنمای عملی برای تیم‌هایی که همین الان مهاجرت می‌کنند.

Next.js 16.3Instant NavigationsAGENTS.mdTurbopackCache Componentsایجنت هوش مصنوعی

علی مرتضوی

بنیان‌گذار پارادایس کد

چرا ۱۶.۳ برای تیم‌های پروداکشن مهم است

Next.js 16.3 در ۳ اوت ۲۰۲۶ به‌صورت پایدار منتشر شد و بزرگ‌ترین به‌روزرسانی از زمان ۱۶.۰ محسوب می‌شود. تمرکز این نسخه دو محور دارد: حس ناوبری شبیه SPA بدون قربانی‌کردن مدل سرورمحور، و هم‌راستا کردن ابزارهای توسعه با ایجنت‌های کدنویسی مثل Cursor، Claude Code و Codex.

برای استودیوهایی مثل Paradise Code که روزانه روی App Router کار می‌کنند، ارزش واقعی در صفر بودن تغییر کد برای بسیاری از بهبودهاست: مصرف حافظه کمتر در `next dev`، بیلد سریع‌تر با کش دیسک Turbopack، و رندر سمت سرور سریع‌تر با استریم‌های بومی Node.js. Instant Navigations و ویژگی‌های ایجنت اختیاری‌اند و می‌توانید مرحله‌به‌مرحله فعالشان کنید.

Instant Navigations: Stream، Cache یا Block

Instant Navigations مجموعه‌ای opt-in است که ناوبری را مثل اپلیکیشن‌های کلاینت‌محور فوری می‌کند، بدون اینکه مزایای مدل سرورمحور Next.js از بین برود. ایده اصلی این است که هر دسترسی دادهٔ بدون کش در مسیر ناوبری یک انتخاب محصولی است: Stream پشت `<Suspense>`، Cache با `'use cache'`، یا Block با `export const instant = false`.

Instant Insights در حالت توسعه، ناوبری‌های کند را به‌عنوان خطا نشان می‌دهد و برای هر Insight سه اصلاح برچسب‌دار پیشنهاد می‌کند. دکمه Copy prompt یک پرامپت آماده برای ایجنت می‌سازد که الگوی رسمی را از صفحات `/docs/messages` می‌خواند و با Skill مربوطه در مرورگر تأیید می‌کند.

ابزار Navigation Inspector پوستهٔ لودینگ هر ناوبری را بصری می‌کند و helper تست Playwright با `instant()` جلوی رگرسیون را می‌گیرد. رفتارهای پشت Instant Navigations قرار است در نسخه major بعدی پیش‌فرض شوند؛ پس هرچه زودتر با Cache Components و این مدل ذهنی آشنا شوید، مهاجرت آینده کم‌هزینه‌تر خواهد بود.

Partial Prefetching و ISR بهتر

Partial Prefetching کنترل دقیق‌تری روی اینکه هر لینک چقدر محتوا پیش‌واکشی کند می‌دهد. به‌جای پیش‌واکشی کامل هر صفحه، می‌توانید پوستهٔ مشترک لودینگ را بین مسیرها reuse کنید و payloadهای کوچک را با prefetch inlining در یک درخواست باندل کنید. نتیجه: درخواست‌های prefetch کمتر و ناوبری سریع‌تر روی شبکه‌های واقعی.

ISR هم برای URLهایی که در بیلد prerender نشده‌اند بهبود یافته: اولین بازدیدکننده می‌تواند بلافاصله یک loading shell ببیند به‌جای اینکه منتظر رندر کامل بماند. این برای کاتالوگ‌های بزرگ، صفحات چندزبانه و مسیرهای دینامیک پرترافیک تفاوت محسوسی در Core Web Vitals ایجاد می‌کند.

Turbopack: حافظه کمتر و بیلد سریع‌تر

طبق اعلام رسمی، Turbopack در `next dev` تا ۹۰٪ حافظه کمتری مصرف می‌کند. دو قابلیت حالا به‌صورت پیش‌فرض فعال‌اند: disk caching برای dev (از ۱۶.۱) و memory eviction. برای تیم‌هایی که چند تب و session طولانی دارند، این یعنی لپ‌تاپ‌های ۱۶ گیگابایتی دیگر زیر فشار `next dev` نمی‌میرند.

همان FileSystem Cache حالا روی `next build` هم پیش‌فرض است و در پروژه‌های واقعی Vercel تا ۵.۵ برابر بیلد تکراری سریع‌تر گزارش شده. اگر CI شما هر بار از صفر بیلد می‌گیرد، فعال بودن این کش روی runnerهای پایدار بیشترین بازده را می‌دهد. `import.meta.glob` بومی Turbopack هم برای خواندن دسته‌ای فایل‌ها در Server Components مفید است.

AGENTS.md و داکیومنت نسخه‌بندی‌شده

از ۱۶.۲ داکیومنت Next.js داخل پکیج `next` باندل می‌شود. در ۱۶.۳، وقتی `next dev` ایجنت کدنویسی را در محیط تشخیص دهد، بلوک مدیریت‌شده‌ای داخل `AGENTS.md` (و در صورت نیاز `CLAUDE.md`) می‌نویسد یا به‌روز می‌کند که ایجنت را به `node_modules/next/dist/docs/` هدایت کند. این کار ایجنت را از اتکا به داده‌های آموزشی قدیمی جدا می‌کند.

محتوای خارج از مارکرهای `BEGIN/END:nextjs-agent-rules` حفظ می‌شود. برای opt-out از `agentRules: false` در `next.config.ts` استفاده کنید. پروژه‌های ۱۶.۱ یا قدیمی‌تر هنوز به codemod `agents-md` نیاز دارند. Skills قدیمی دانش‌محور بازنشسته شده‌اند؛ به‌جایشان Skills گردش‌کار رسمی آمده‌اند.

Skills رسمی: next-dev-loop و بهینه‌سازی Cache

Skill `next-dev-loop` حلقهٔ کامل ویرایش → کامپایل → ریلود → بازرسی را به ایجنت می‌دهد: از `/_next/mcp` برای لاگ سرور و مسائل کامپایل، و از `agent-browser` (نسخه ۰.۲۷+) برای DOM، کنسول، شبکه و introspection درخت React. این جایگزین عملی «حدس زدن از روی اسکرین‌شات» است.

دو Skill دیگر برای Cache Components طراحی شده‌اند: `next-cache-components-adoption` برای مهاجرت تدریجی یا یکجا، و `next-cache-components-optimizer` که با تست `instant()` مسیر را سبز می‌کند. نسخه پایدار ۱۶.۳ همچنین `next-partial-prefetching-adoption` را اضافه کرده تا Partial Prefetching را در اپ فعال و یکدست کند.

چک‌لیست مهاجرت برای تیم‌ها

اول `next@latest` را نصب کنید و بدون فعال‌کردن Instant Navigations، فقط از بهبودهای پیش‌فرض بهره ببرید. سپس TypeScript 7 را برای type-check سریع‌تر در `next build` در نظر بگیرید. AGENTS.md را commit کنید تا درخت گیت تمیز بماند و ایجنت‌های تیم همگی به همان داکیومنت نسخه اشاره کنند.

برای مسیرهای حساس UX، Cache Components را مسیر به مسیر روشن کنید، Instant Insights را جدی بگیرید، و با Playwright helper رگرسیون ناوبری را قفل کنید. React Compiler مبتنی بر Rust هنوز experimental است؛ آن را روی مسیرهای کم‌ریسک آزمایش کنید، نه روی کل پروداکشن در روز اول. MCP سرور کوچک‌تر شده و ابزارهای `get_compilation_issues` و `compile_route` جایگزین بیلد کامل برای بازخورد سریع ایجنت شده‌اند.

سؤالات متداول

آیا Instant Navigations به‌صورت پیش‌فرض روشن است؟

خیر. در ۱۶.۳ این مجموعه opt-in است و رفتارهایش قرار است در major بعدی پیش‌فرض شوند. می‌توانید ابتدا فقط از بهبودهای پیش‌فرض حافظه و بیلد استفاده کنید.

اگر AGENTS.md را از diff حذف کنیم چه می‌شود؟

با اجرای دوباره `next dev` در محیطی که ایجنت تشخیص داده شود، بلوک مدیریت‌شده دوباره نوشته می‌شود. بهترین کار commit کردن همان بلوک است.

Skills قدیمی next-skills هنوز لازم‌اند؟

Skills دانش‌محور قدیمی بازنشسته شده‌اند چون داکیومنت باندل‌شده جایگزینشان شده. Skills گردش‌کار مثل next-dev-loop همچنان ارزشمندند.

دانش و مقالات

نیاز به اجرای همین مفاهیم در محصولتان دارید؟

پارادایس کد از مشاوره تا پیاده‌سازی کامل کنار شماست.

درخواست همکاری