AGENTS.md@modules/agents/skills/vercel-react-best-practicesB

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

AGENTS.md@modules/agents/skills/vercel-react-best-practices from bdsqqq/dots is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add bdsqqq/dots/modules/agents/skills/vercel-react-best-practices/AGENTS.md@git:20261014.b8be6bf

Pins git:20261014.b8be6bf in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 13 of 14 checks passed
Kind
AGENTS.md file
Repository
bdsqqq/dots
Path
modules/agents/skills/vercel-react-best-practices/AGENTS.md
Versions recorded
1
Latest version
git:20261014.b8be6bf, committed Oct 14, 2026
Size
108,279 bytes
Repository stars
64
License
none declared

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# React Best Practices

**Version 1.0.0**  
Vercel Engineering  
January 2026

> **Note:**  
> This document is mainly for agents and LLMs to follow when maintaining,  
> generating, or refactoring React and Next.js codebases. Humans  
> may also find it useful, but guidance here is optimized for automation  
> and consistency by AI-assisted workflows.

---

## Abstract

Comprehensive performance optimization guide for React and Next.js applications, designed for AI agents and LLMs. Contains 40+ rules across 8 categories, prioritized by impact from critical (eliminating waterfalls, reducing bundle size) to incremental (advanced patterns). Each rule includes detailed explanations, real-world examples comparing incorrect vs. correct implementations, and specific impact metrics to guide automated refactoring and code generation.

---

## Table of Contents

1. [Eliminating Waterfalls](#1-eliminating-waterfalls) — **CRITICAL**
   - 1.1 [Check Cheap Conditions Before Async Flags](#11-check-cheap-conditions-before-async-flags)
   - 1.2 [Defer Await Until Needed](#12-defer-await-until-needed)
   - 1.3 [Dependency-Based Parallelization](#13-dependency-based-parallelization)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bdsqqq/dots/modules/agents/skills/vercel-react-best-practices/AGENTS.md@sha256:1fe182a457585dc5

The line at the top of this page pins the label git:20261014.b8be6bf, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_flnocez7jta2ryjr.svg)](https://markdownregistry.com/a/art_flnocez7jta2ryjr)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 14, 2026.

versioncommittedcommitsizeaudit
git:20261014.b8be6bf latest2026-10-14 b8be6bf 108,279 BB view

Audit of the latest version

B  13 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No script tag (matched: <script)
  • pass: Size between 200 bytes and 200 KB (108279 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address

Starting a new one? Use a template for AGENTS.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

bdsqqq/dots · 64 stars · license none declared · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_flnocez7jta2ryjr
GET https://markdownregistry.com/api/v1/resolve?ref=bdsqqq/dots/modules/agents/skills/vercel-react-best-practices/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/1fe182a457585dc5d1f532beef4c956f2d071d452a1fa243602297c97b7eb7e4

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from bdsqqq/dots

AGENTS.md AGENTS.md file
bdsqqq/dots · AGENTS.md
git:20261014.bcbd33e · audit A · 64 stars
AGENTS.md@modules/agents AGENTS.md file
bdsqqq/dots · modules/agents/AGENTS.md
git:20261015.fb1c355 · audit A · 64 stars
academish-voice SKILL.md skill
bdsqqq/dots · modules/agents/skills/academish-voice/SKILL.md · (no description)
git:20261015.080d818 · audit F · 64 stars
building-review-playgrounds SKILL.md skill
bdsqqq/dots · modules/agents/skills/building-review-playgrounds/SKILL.md · Exposes hard-to-reach UI states through issue-scoped production-component fixtures. Use when existing routes or stories…
git:20260918.4719974 · audit A · 64 stars
buying-stuff SKILL.md skill
bdsqqq/dots · modules/agents/skills/buying-stuff/SKILL.md · helps choose what to buy and where to buy it, based on the user's priorities, budget, and location. use for shopping…
git:20260923.ccef523 · audit A · 64 stars
company-money SKILL.md skill
bdsqqq/dots · modules/agents/skills/company-money/SKILL.md · Ingests bounded Wise Gmail notifications and Nubank statements into the private local company ledger, then produces…
git:20260903.a4912b8 · audit A · 64 stars
composing-data-driven-ui SKILL.md skill
bdsqqq/dots · modules/agents/skills/composing-data-driven-ui/SKILL.md · Makes data-backed UI work outside its original page. Use when callers need to supply data or fetch by ID, or reuse a…
git:20260919.3a1ac1f · audit A · 64 stars
data-visualization SKILL.md skill
bdsqqq/dots · modules/agents/skills/data-visualization/SKILL.md · Use when creating, reviewing, or styling charts, graphs, dashboards, sparklines, or any data visualization.
git:20260918.7a11459 · audit A · 64 stars
designing-agent-skills SKILL.md skill
bdsqqq/dots · modules/agents/skills/designing-agent-skills/SKILL.md · Create, revise, or evaluate reusable agent skills: triggers, procedures, references, and behavioral cases. Use when…
git:20260929.dbd7dd9 · audit A · 64 stars
designing-progressive-apis SKILL.md skill
bdsqqq/dots · modules/agents/skills/designing-progressive-apis/SKILL.md · Designs type-safe APIs with useful defaults and room for caller control. Use for overloads, render slots, compound…
git:20260919.3a1ac1f · audit A · 64 stars
desloping-code-changes SKILL.md skill
bdsqqq/dots · modules/agents/skills/desloping-code-changes/SKILL.md · Tests whether code-change complexity is justified by behavior and local contracts. Use for a focused craft review of…
git:20260918.4719974 · audit A · 64 stars
dig SKILL.md skill
bdsqqq/dots · modules/agents/skills/dig/SKILL.md · Investigate uncertain incidents, root causes, or architecture questions requiring multi-step tracing across evidence…
git:20260929.dbd7dd9 · audit A · 64 stars

Every file in bdsqqq/dots

Browse by kind, by grade B, or by owner.