AGENTS.md@skills/react-best-practicesB

AGENTS.md@skills/react-best-practices from zebbern/claude-code-guide is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add zebbern/claude-code-guide/skills/react-best-practices/AGENTS.md@git:20260531.164971d

Pins git:20260531.164971d in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 13 of 14 checks passed
Kind
AGENTS.md file
Repository
zebbern/claude-code-guide
Path
skills/react-best-practices/AGENTS.md
Versions recorded
1
Latest version
git:20260531.164971d, committed May 31, 2026
Size
81,336 bytes
Repository stars
4,696
License
MIT

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 [Defer Await Until Needed](#11-defer-await-until-needed)
   - 1.2 [Dependency-Based Parallelization](#12-dependency-based-parallelization)
   - 1.3 [Prevent Waterfall Chains in API Routes](#13-prevent-waterfall-chains-in-api-routes)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add zebbern/claude-code-guide/skills/react-best-practices/AGENTS.md@sha256:d7edbe7ed3b9389f

The line at the top of this page pins the label git:20260531.164971d, 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_bkxxrb4k4xajbub4.svg)](https://markdownregistry.com/a/art_bkxxrb4k4xajbub4)

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

Versions

The registry has recorded 1 version of this file, committed on May 31, 2026.

versioncommittedcommitsizeaudit
git:20260531.164971d latest2026-05-31 164971d 81,336 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 (81336 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

zebbern/claude-code-guide · 4,696 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bkxxrb4k4xajbub4
GET https://markdownregistry.com/api/v1/resolve?ref=zebbern/claude-code-guide/skills/react-best-practices/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/d7edbe7ed3b9389ffc725fbca9b3d695d11ee131cd9329a11b072a741fc256d1

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 zebbern/claude-code-guide

academic-paper-reviewer SKILL.md skill
zebbern/claude-code-guide · skills/academic-paper-reviewer/SKILL.md · Simulates academic peer review, evaluating papers across Originality, Methodology, Results, and Writing to provide…
git:20260531.164971d · audit A · 4,696 stars
active-directory-attacks SKILL.md skill
zebbern/claude-code-guide · skills/active-directory-attacks/SKILL.md · This skill should be used when the user asks to "attack Active Directory", "exploit AD", "Kerberoasting", "DCSync"…
v1.1 · audit A · 4,696 stars
api-fuzzing-bug-bounty SKILL.md skill
zebbern/claude-code-guide · skills/api-fuzzing-bug-bounty/SKILL.md · This skill should be used when the user asks to "test API security", "fuzz APIs", "find IDOR vulnerabilities", "test…
v1.1 · audit C · 4,696 stars
api-shape-explorer SKILL.md skill
zebbern/claude-code-guide · skills/api-shape-explorer/SKILL.md · Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to…
git:20260531.164971d · audit A · 4,696 stars
audit-flow SKILL.md skill
zebbern/claude-code-guide · skills/audit-flow/SKILL.md · Interactive system flow tracing across CODE, API, AUTH, DATA, NETWORK layers with SQLite persistence and Mermaid…
v1.0.0 · audit A · 4,696 stars
authentication-patterns SKILL.md skill
zebbern/claude-code-guide · skills/authentication-patterns/SKILL.md · Authentication patterns: session vs JWT vs OAuth comparison, provider selection (NextAuth, Clerk, Supabase Auth)…
git:20260531.164971d · audit A · 4,696 stars
aws-penetration-testing SKILL.md skill
zebbern/claude-code-guide · skills/aws-penetration-testing/SKILL.md · This skill should be used when the user asks to "pentest AWS", "test AWS security", "enumerate IAM", "exploit cloud…
v1.1 · audit B · 4,696 stars
broken-authentication SKILL.md skill
zebbern/claude-code-guide · skills/broken-authentication/SKILL.md · This skill should be used when the user asks to "test for broken authentication vulnerabilities", "assess session…
v1.1 · audit A · 4,696 stars
burp-suite-testing SKILL.md skill
zebbern/claude-code-guide · skills/burp-suite-testing/SKILL.md · This skill should be used when the user asks to "intercept HTTP traffic", "modify web requests", "use Burp Suite for…
v1.1 · audit B · 4,696 stars
caching SKILL.md skill
zebbern/claude-code-guide · skills/caching/SKILL.md · Caching strategies — invalidation, TTL guidelines, cache keys, cache layers, and when not to cache. Use when…
git:20260531.164971d · audit A · 4,696 stars
chart-image SKILL.md skill
zebbern/claude-code-guide · skills/chart-image/SKILL.md · Generate publication-quality PNG chart images from data, supporting line, bar, area, candlestick, pie, and heatmap…
v2.5.1 · audit A · 4,696 stars
cloud-penetration-testing SKILL.md skill
zebbern/claude-code-guide · skills/cloud-penetration-testing/SKILL.md · This skill should be used when the user asks to "perform cloud penetration testing", "assess Azure or AWS or GCP…
v1.1 · audit C · 4,696 stars

Every file in zebbern/claude-code-guide

Other files named AGENTS.md@skills/react-best-practices

AGENTS.md@skills/react-best-practices AGENTS.md file
vercel-labs/agent-skills · skills/react-best-practices/AGENTS.md
git:20260414.dc8367e · audit B · 33,295 stars
AGENTS.md@skills/react-best-practices AGENTS.md file
julianromli/ai-skills · skills/react-best-practices/AGENTS.md
git:20260505.3e57ae0 · audit B · 214 stars

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