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

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

fluentui-react-native / desktop-test

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

This package owns neutral app/suite configuration, desktop lifecycle, and aggregate reporting. Read the user guide, then select the narrowest topic in the reference index. For configuration work, begin with configuration; for reports and run status, use reporting, including the shared CLI reporter modes and bounded structured output contract. - Keep the harness application-neutral: no Storybook, React, or React Native dependencies. Storybook is introduced only by the optional integration. - Preserve exact application identity and ownership semantics. Reject unknown config fields…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / native-core

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

This is the instruction root for @fluentui-react-native/native-core and every descendant. The package owns modern native-backed components and modules, the legacy Callout and FocusZone wrappers, and their macOS and Windows native implementations. Read the user guide, then select the narrowest topic in the reference index: Native changes use the implement-native-component skill. Apple changes follow the repository's Apple and Office rules (R-APPLE-001 through R-APPLE-007, in native.apple-office); Windows Fabric views follow native.windows-fabric. - Follow R-APPLE-001 through R-APPLE-007 for shared services and renderer adapters.…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / storybook-desktop

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

This package owns the Storybook integration CLI and runtime orchestration. Read the package README, then select the closest topic in the reference index. Use references/contributing.md for source ownership and validation. - Keep app-specific identity, story discovery, and platform exclusions in the consumer app configuration. - Keep Storybook-specific behavior here; general target configuration and aggregate lifecycle reporting belong to @fluentui-react-native/desktop-test. - Only accept statically extractable story/test plans; invalid or dynamic plans fail generation. - Preserve authenticated runtime readiness, correlated request/run IDs,…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / storybook-desktop-runtime

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

This package owns the on-device Storybook runtime, bridge, Metro integration, theme host, and chrome. Read the README and the narrowest section in the reference index. The runtime contract covers the authenticated bridge, Metro, theme, and platform chrome. - Keep this package as the on-device runtime. CLI orchestration and aggregate test reporting belong to the integration and harness packages. - Preserve the authenticated nonce, correlated request/run IDs, readiness, error signaling, and native story-root verification. - Keep one Flex ThemedRoot around app…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / foundation-compose

microsoft/fluentui-react-native/packages/deprecated/foundation-compose/AGENTS.md

These instructions apply to packages/deprecated/foundation-compose, which implements the repository's legacy v0 compose framework. The consumer recipe, recognition guide, and review checklist for v0 components live in the shared v0 reference; read it before changing this package or any v0 component. v0 is maintenance-only (R-V0-001). - compose combines foundation-composable, themed settings, foundation-settings, and foundation-tokens. Changes to settings override or merge semantics, or to token processing, also require those packages' tests. - The package publicly exports compose, initializeStyling, and the compose option,…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / framework-base

microsoft/fluentui-react-native/packages/framework-base/AGENTS.md

This is the instruction root for @fluentui-react-native/framework-base and every descendant. The package owns the shared component patterns, custom JSX runtime, slot types, interaction and focus-target hooks, universal accessibility helpers, and the merge and memoization utilities used by v1 and agentic components. Read the user guide, then select the narrowest topic in the reference index: Focus-target and interaction abstractions also follow the repository's common focus authoring reference (focus.common) and its platform breakouts. - Use directComponent only for hook-free prop and render…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fluentui-react-native / framework

microsoft/fluentui-react-native/packages/framework/framework/AGENTS.md

These instructions apply to packages/framework/framework, which implements the repository's v1 compose and compressible framework. The consumer recipe, recognition guide, and review checklist for v1 components live in the shared v1 reference; read it before changing this package or any v1 component. v1 is maintenance-only (R-V1-001). - compose injects the Fluent Theme integration into composeFactory from @fluentui-react-native/composition. Keep theme-agnostic factory work in that lower-level package. - Styling and slots come from use-styling, use-tokens, and use-slots. Changes to factory, slot, token, or…

1.4k5mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

fhir-server

microsoft/fhir-server/AGENTS.md

Universal agent instructions for all AI tools working in this repository. This is the Microsoft FHIR Server — an open-source, standards-compliant implementation of HL7 FHIR (Fast Healthcare Interoperability Resources) built on .NET and Azure. It supports both Azure Cosmos DB and SQL Server as storage backends, and exposes a RESTful API conforming to FHIR R4/R5/STU3.

1.4k6d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

winappCli

microsoft/winappCli/AGENTS.md

This file provides focused, actionable information to help an AI coding agent be immediately productive in this repo. This covers PRs, issues, review comments, chat replies, commit messages, and docs. Don't assume the reader knows this change, this code, or this conversation. - Lead with what the user sees, then why. Say the cause after the effect. - Show, don't describe. Add one concrete example for each claim that isn't obvious: a command and its output, a file tree, or…

Steady10 mentions in 2 weeks

No other project uses it yet

1.4k55d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

skills-for-fabric

microsoft/skills-for-fabric/AGENTS.md

Updates: These instructions do not run a session-start update check. Refresh them through your host's plugin or marketplace update flow, or run git pull if you use a manual clone. You are an AI assistant specialized in Microsoft Fabric development. All Fabric operations require Azure AD authentication. For development: Local Codex needs its own MCP configuration to reuse Azure CLI sign-in. See mcp-setup/README.md; reading these instructions alone does not register MCPs.

1.4k4d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

roosterjs

microsoft/roosterjs/AGENTS.md

RoosterJS is a framework-independent JavaScript rich-text editor built by Microsoft. It renders inside a single HTML <div> element. All editing operations are handled through a middle-layer data structure called the…

1.3k5mo agoReviewMountCreate a free account to mount
MicrosoftReads credentialsAGENTS.md

generative-ai-with-javascript

microsoft/generative-ai-with-javascript/AGENTS.md

This repository is a comprehensive learning course called "Generative AI for Beginners with JavaScript". It teaches developers how to integrate Generative AI into JavaScript applications through a time-traveling narrative where learners interact with historical figures. Key Technologies: - JavaScript/Node.js (ES Modules) - TypeScript (for some lessons) - OpenAI SDK - Model Context Protocol (MCP) - Express.js (for web applications) - Microsoft Foundry or another OpenAI-compatible model provider Architecture: - Multi-package learning repository (not a monorepo, but lesson-based structure) - Each…

1.3k41d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

power-platform-skills

microsoft/power-platform-skills/AGENTS.md

A plugin marketplace for Power Platform development by Microsoft. The Open Plugins marketplace manifest (marketplace.json) references individual plugins in plugins/. Each plugin has its own AGENTS.md with plugin-specific guidance. Everything here — code, docs, commit messages, PR descriptions, and branch names — is world-readable. Write for a reader outside Microsoft who cannot see any internal system. Do not commit: - Internal hosts, repos or paths — *.ghe.com links, internal repo names, or a path into an internal repo's doc tree.…

1.2k3d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

power-platform-skills / canvas-apps

microsoft/power-platform-skills/plugins/canvas-apps/AGENTS.md

This file provides guidance to AI Agents when working with the canvas-apps plugin. A plugin for authoring Power Apps Canvas Apps. The Canvas Authoring MCP server (CanvasAuthoringMcpServer) exposes tools that agents use to generate, validate, and compile Canvas App YAML files (.pa.yaml) in conjunction with a running coauthoring studio session. The Power Apps Studio browser tab must remain open for the duration of the session — closing it ends the coauthoring session, which breaks compile_canvas and sync_canvas operations. Skills orchestrate…

Steady41 mentions in 2 weeks

No other project uses it yet

1.2k3d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

power-platform-skills / code-apps

microsoft/power-platform-skills/plugins/code-apps/AGENTS.md

This file provides guidance to AI agents that work on the code-apps-preview plugin in plugins/code-apps. A plugin for building and deploying Power Apps code apps using React + Vite + TypeScript, connected to Power Platform via connectors (Dataverse, SharePoint, Teams, Azure DevOps, OneDrive, Excel, Office 365, and more). Apps are deployed via the Power Apps NPX CLI (pa app push). Test this plugin locally:

1.2k3d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

power-platform-skills / mobile-apps

microsoft/power-platform-skills/plugins/mobile-apps/AGENTS.md

This file provides guidance to AI Agents when working with the mobile-app plugin. Status: v0 — 24 skills + 5 agents authored. The latest Expo standalone template snapshot is bundled under template/. Read README.md for the command list. A plugin for building and deploying Power Apps code apps that run as native mobile + web apps using Expo + React Native + TypeScript. Connects to Power Platform via connectors using the standard pa app add data-source workflow. The Expo template…

Steady41 mentions in 2 weeks

No other project uses it yet

1.2k3d agoReviewMountCreate a free account to mount
MicrosoftReads credentialsAGENTS.md

power-platform-skills / template

microsoft/power-platform-skills/plugins/mobile-apps/template/AGENTS.md

This is a Power Apps app built with Expo, React Native, and TypeScript. Keep customer feature code in app/ and app-owned src/ files. Read CUSTOMIZATION.md before changing root configuration. Microsoft packages are consumed dependencies, not part of this app's source. Check the skills advertised by the current agent host. Do not search private plugin caches, assume a plugin is installed, or invent skill invocations. Use a matching available skill and its workflow rather than duplicating it here. Users do not…

Steady41 mentions in 2 weeks

No other project uses it yet

1.2k3d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

power-platform-skills / model-apps

microsoft/power-platform-skills/plugins/model-apps/AGENTS.md

This file provides guidance to AI Agents when working with the model-apps plugin. A plugin for building Power Apps for model-driven apps. Two authoring skills do the work (plus /report-issue and /telemetry — four user-invocable skills in total): - /genpage — build and deploy standalone generative pages (genux): React 17 + TypeScript + Fluent UI V9 single-file components, written to the environment through the bundled SDK. Orchestrates specialist agents (planner, optional entity builder, parallel page builders). - /app-builder — build…

1.2k3d 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.