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
MicrosoftAGENTS.md

windows-drivers-rs

microsoft/windows-drivers-rs/AGENTS.md

Rust crates for developing Windows Drivers (WDM, KMDF, UMDF). The workspace only includes the library crates under crates/; examples and tests are excluded from the root workspace because each requires a different WDK configuration (only one WDK config per Cargo build graph is supported). Crate layering (bottom → top): Key design patterns: Requires an eWDK developer prompt and LLVM 17 on PATH for bindgen. cargo-expand v1.0.85 is required for macrotest/trybuild-based tests. Switching between stable/nightly toolchains requires deleting cached test artifacts…

Steady7 mentions in 2 weeks

No other project uses it yet

1.9k7mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode-mssql

microsoft/vscode-mssql/AGENTS.md

- Use DEVELOPMENT.md for setup, build, test, localization, and debugging workflows. - Treat package scripts, workspace configuration, and test configuration as the source of truth when documentation disagrees. - Before…

1.9k41d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

msphpsql

microsoft/msphpsql/AGENTS.md

This document provides guidance for AI coding agents working with the msphpsql GitHub repository — the open-source home of the sqlsrv and **pdo_sqlsrv** PHP extensions for Microsoft SQL Server. The drivers ship as two separate PHP extensions that share a common C++ core layer:

1.9k8mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

BotFramework-WebChat

microsoft/BotFramework-WebChat/AGENTS.md

No summary in the file. Open it to read it.

1.8k30d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

BotFramework-WebChat / api

microsoft/BotFramework-WebChat/packages/api/AGENTS.md

No summary in the file. Open it to read it.

1.8k30d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

BotFramework-WebChat / base

microsoft/BotFramework-WebChat/packages/base/AGENTS.md

No summary in the file. Open it to read it.

1.8k30d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rnx-kit

microsoft/rnx-kit/AGENTS.md

This file provides guidance to agents when working with code in this repository. rnx-kit is a monorepo of React Native tooling created by Microsoft. It provides battle-tested tools for dependency management, Metro bundling enhancements, TypeScript integration, and cross-platform development (iOS, Android, macOS, Windows). - packages/ - Stable, published packages (e.g., @rnx-kit/cli, @rnx-kit/align-deps, @rnx-kit/metro-*) - incubator/ - Experimental packages (marked with "experimental": true in package.json) - scripts/ - Internal build tooling (rnx-kit-scripts CLI) - docsite/ - Documentation website (separate Yarn workspace…

1.7k2d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

hve-core / references

microsoft/hve-core/.github/skills/hve-core/vally-tests/references/agents.md

Nine conformance checks the vally-tests skill emits for .agent.md artifacts (including consolidated subagent structural template), with contract citations, stimulus shapes, and Vally grader recommendations

1.6k6d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

OpenAPI.NET

microsoft/OpenAPI.NET/agents.md

No summary in the file. Open it to read it.

1.6k9mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

playwright-java

microsoft/playwright-java/AGENTS.md

The Java client is a port of the JavaScript client in ~/code/playwright/packages/playwright-core/src/client/. When implementing or changing a method, read the corresponding JS file first and mirror its logic. Paths such as ~/code/playwright in this file assume that you check the repos out in ~/code. Use the gh cli to interact with GitHub. The tests are in playwright/src/test/java/com/microsoft/playwright/. A test is a @PlaywrightTest method that takes the fixtures it needs as parameters, resolved by type: Page page, BrowserContext context, Browser browser,…

1.6k26d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

playwright-java / test

microsoft/playwright-java/playwright/src/test/AGENTS.md

These rules say how to write playwright/src/test/java/com/microsoft/playwright/tests/{page,library} from tests/page and tests/library in microsoft/playwright (the checkout in ../playwright; the commit the port is based on is in upstream_base.txt, together with the commands that list the upstream changes still to port). Use them for every new or changed upstream test. The port is line by line, with zero deviations. A reviewer reads the .spec.ts file and the .java file side by side. Each upstream statement maps to one Java statement, or to…

Steady10 mentions in 2 weeks

No other project uses it yet

1.6k26d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

waza

microsoft/waza/AGENTS.md

This repository contains waza, a CLI tool for evaluating Agent Skills. Go is the only implementation, and it lives in the repository root. (An early Python implementation was removed in February 2026.) When making changes, follow these guidelines to maintain consistency and quality. See Meet the Squad for current owners, the pinned Squad tooling, and upgrade/verification procedures. .squad/team.md and .squad/routing.md define the active team; .squad/governance.md defines bounded collaboration and independent review. Persisted GPT-first role assignments live in .squad/config.json, with code-review…

1.5k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native

microsoft/fluentui-react-native/AGENTS.md

Guidance for coding agents working in the FluentUI React Native monorepo, which implements Microsoft's Fluent Design System for iOS, Android, macOS, Windows, and Win32. This file is always loaded. It holds repository safeguards and routes each task to the workflow and references it needs; load only what the task requires. - AGENTS.md files hold safeguards and local invariants. Copilot CLI loads applicable files from the repository, working directory, ancestors, and directories in the path of files being worked on. Read…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / storybook

microsoft/fluentui-react-native/apps/storybook/AGENTS.md

These instructions apply to the apps/storybook consumer. Shared CLI, app configuration, driver, and runtime behavior belongs to package-owned guidance: - Read agent-map.yaml for stable paths, declared scripts, and runtime discovery commands. Keep it compact; the runtime story catalog is authoritative. Give a generated source a nested path and policy: generated-…: check-agent-instructions validates other sources against Git, so ignored local build output cannot satisfy it. - desktop.config.mts owns app name, package discovery, platform story exclusions, and native command exceptions. Do not…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / components

microsoft/fluentui-react-native/packages/agentic/components/AGENTS.md

This is the instruction root for @fluentui-react-native/components and every descendant. The package owns the agentic Fluent higher-order components, the public unstyled primitives, their React Native contracts, and the contract tooling. Read the user guide, then select the narrowest topic in the reference index: Implementation and planning use the agentic-component-authoring skill, contracts use the agentic-component-contract-authoring skill, cross-component extraction uses the agentic-component-optimization skill, and reviews use the review-component skill. Focus work starts with the repository's common focus reference (focus.common), then focus.windows-win32 or…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / design

microsoft/fluentui-react-native/packages/agentic/design/AGENTS.md

This is the instruction root for @fluentui-react-native/design and every descendant. The package owns Fluent UI React Native's theming contract: theme sources and providers, ready-made Fluent and Flex themes, structured appearance, Flex and legacy tokens, the token mappings, themed style factories, the runtime color library, and test-only design fixtures. Read the user guide, then select the narrowest topic in the reference index: Component authors applying tokens and styles also follow their component workflow; for agentic components that is the repository reference…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / desktop-driver

microsoft/fluentui-react-native/packages/agentic/desktop-driver/AGENTS.md

This is the instruction root for this package and every descendant. Read README.md and select the closest topic in the reference index. Native changes also require the matching provider README and native protocol. Inspect source and tests before editing. - Do not import Storybook, React, or React Native into this package. - Keep protocol, client, authoring, runner, artifacts, and fake-host code platform-neutral. Operating-system behavior belongs behind DesktopHost. - Keep the W3C server client-neutral. WebdriverIO belongs in /wdio, composed agent/CLI operations,…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / desktop-driver-mcp

microsoft/fluentui-react-native/packages/agentic/desktop-driver-mcp/AGENTS.md

This package is the Model Context Protocol adapter for the Desktop Driver agent operations. It is the instruction root for this package and every descendant. Read the README, then the narrowest entry in the reference index. The operations themselves, their schemas, and their failure reasons belong to @fluentui-react-native/desktop-driver (its agent operations reference); this package only maps them onto MCP. - Stay a thin client. Every tool calls the service's operation routes through the typed client; never add a second execution…

1.4k5mo 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.