agentleFS

AGENTS.md examples from real projects

How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.

Worked for most · soon
thongdn-itAGENTS.md

react-agent-skills / feature-arch

thongdn-it/react-agent-skills/skills/feature-arch/AGENTS.md

Version 0.1.0 Community January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive architecture guide for organizing React applications by features, enabling scalable development with independent teams. Contains 42 rules across 8 categories, prioritized by impact from critical (directory structure and import rules) to incremental (naming conventions). Each rule includes detailed explanations,…

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / msw

thongdn-it/react-agent-skills/skills/msw/AGENTS.md

Version 1.0.0 mswjs January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive API mocking guide for MSW v2 applications, designed for AI agents and LLMs. Contains 45+ rules across 8 categories, prioritized by impact from critical (setup, handler architecture) to incremental (debugging). Each rule includes detailed explanations, real-world examples comparing incorrect…

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / nextjs

thongdn-it/react-agent-skills/skills/nextjs/AGENTS.md

Version 0.1.0 Next.js Community January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive performance optimization guide for Next.js 16 App Router applications, designed for AI agents and LLMs. Contains 40+ rules across 8 categories, prioritized by impact from critical (build optimization, caching strategy) to incremental (client components). Each rule includes detailed…

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / nuqs

thongdn-it/react-agent-skills/skills/nuqs/AGENTS.md

Version 0.1.0 Community January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive best practices guide for nuqs (type-safe URL query state management) in Next.js applications, designed for AI agents and LLMs. Contains 42 rules across 8 categories, prioritized by impact from critical (parser configuration, adapter setup) to incremental (advanced patterns). Each…

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / playwright

thongdn-it/react-agent-skills/skills/playwright/AGENTS.md

Version 0.1.0 Community January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive testing best practices guide for Playwright with Next.js applications, designed for AI agents and LLMs. Contains 43 rules across 8 categories, prioritized by impact from critical (test architecture, stable selectors) to incremental (debugging, CI integration). Each rule includes detailed…

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / react-hook-form

thongdn-it/react-agent-skills/skills/react-hook-form/AGENTS.md

Version 0.1.0 Community January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive performance optimization guide for React Hook Form applications, designed for AI agents and LLMs. Contains 41 rules across 8 categories, prioritized by impact from critical (form configuration, field subscriptions) to incremental (advanced patterns). Each rule includes detailed explanations, real-world…

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / shadcn

thongdn-it/react-agent-skills/skills/shadcn/AGENTS.md

Version 0.1.0 shadcn/ui Community January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive best practices guide for shadcn/ui applications, designed for AI agents and LLMs. Contains 42 rules across 8 categories, prioritized by impact from critical (component architecture, accessibility preservation) to incremental (state management). Each rule includes detailed explanations, real-world examples…

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / tailwind

thongdn-it/react-agent-skills/skills/tailwind/AGENTS.md

Version 0.1.0 Tailwind Labs January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive performance optimization and best practices guide for Tailwind CSS v4, designed for AI agents and LLMs. Contains 42 rules across 8 categories, prioritized by impact from critical (build configuration, CSS generation) to incremental (animation patterns). Each rule includes…

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / tanstack-query

thongdn-it/react-agent-skills/skills/tanstack-query/AGENTS.md

Version 1.0.0 community January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive performance optimization guide for TanStack Query v5 applications, designed for AI agents and LLMs. Contains 40+ rules across 8 categories, prioritized by impact from critical (query key structure, caching configuration) to incremental (render optimization). Each rule includes detailed explanations,…

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / tdd

thongdn-it/react-agent-skills/skills/tdd/AGENTS.md

Version 0.1.0 Community January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive guide to Test-Driven Development practices, designed for AI agents and LLMs. Contains 42 rules across 8 categories, prioritized by impact from critical (red-green-refactor cycle, test design principles) to strategic (test pyramid, coverage targets). Each rule includes detailed explanations, real-world…

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / ui-design

thongdn-it/react-agent-skills/skills/ui-design/AGENTS.md

Version 0.1.0 UI/UX Best Practices January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive UI/UX and frontend design best practices guide, designed for AI agents and LLMs. Contains 42 rules across 8 categories, prioritized by impact from critical (accessibility compliance, Core Web Vitals) to incremental (animation performance). Each rule includes detailed…

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / vercel-composition-patterns

thongdn-it/react-agent-skills/skills/vercel-composition-patterns/AGENTS.md

Version 1.0.0 Engineering January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring React codebases using composition. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Composition patterns for building flexible, maintainable React components. Avoid boolean prop proliferation by using compound components, lifting state, and composing internals. These patterns make codebases easier for both humans and AI agents to work with as they…

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / vercel-react-best-practices

thongdn-it/react-agent-skills/skills/vercel-react-best-practices/AGENTS.md

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. 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…

Surging+2 new adopters in 4 weeks

51 projects use a version of this

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / vitest

thongdn-it/react-agent-skills/skills/vitest/AGENTS.md

Version 1.0.0 community January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive testing best practices guide for Vitest, designed for AI agents and LLMs. Contains 44 rules across 8 categories, prioritized by impact from critical (async patterns, test isolation) to incremental (test organization). Each rule includes detailed explanations, real-world examples comparing…

59mo agoReviewMountCreate a free account to mount
thongdn-itAGENTS.md

react-agent-skills / zod

thongdn-it/react-agent-skills/skills/zod/AGENTS.md

Version 1.0.0 community January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring codebases. Humans may also find it useful, but guidance here is optimized for automation and consistency by AI-assisted workflows. Comprehensive schema validation guide for Zod in TypeScript applications, designed for AI agents and LLMs. Contains 43 rules across 8 categories, prioritized by impact from critical (schema definition, parsing) to incremental (performance, bundle optimization). Each rule includes detailed explanations, real-world…

59mo agoReviewMountCreate a free account to mount
CLAUDE.md vs AGENTS.md

About AGENTS.md

What is AGENTS.md?

An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.

Where does it go?

At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.

What should it contain?

Setup and test commands, code style, and the rules a new contributor would need to know.

Does Claude Code read it?

Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.