agentleFS
Sign inSign up

AGENTS.md examples from real projects

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

Most stars first · from page 13Worked for most · soon
MicrosoftAGENTS.md

power-platform-skills / code-apps

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

This file provides guidance to AI Agents when working with the power-apps plugin. 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: Power Apps code apps run in a sandbox — direct HTTP calls (fetch, axios, Graph API, etc.) do…

93844d agoDiscuss
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 npx power-apps add-data-source workflow. The Expo template snapshot…

93844d agoDiscuss
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, deployed via PAC CLI. Orchestrates specialist agents (planner, optional entity builder, parallel page builders). - /app-builder — build and edit a whole…

93844d agoDiscuss
MicrosoftAGENTS.md

power-platform-skills / power-apps-mobile-extension

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

This directory is the complete, self-contained power-apps-mobile-extension plugin. In the public microsoft/power-platform-skills repository, copy it to plugins/power-apps-mobile-extension/. The plugin builds third-party Power Apps Mobile controls into native-only .ppmplugin bundles and generates the companion dispatcher PCF. It must use only files in the control's working tree and publicly available tools and package registries. - shared/shared-instructions.md owns cross-skill behavior, constants, safety rules, and status semantics. - shared/prereq-check.md owns prerequisite versions, per-skill checks, and auto-fix policy. - shared/ppmplugin-format.md owns the bundle schema, runtime…

93844d agoDiscuss
MicrosoftAGENTS.md

power-platform-skills / power-automate

microsoft/power-platform-skills/plugins/power-automate/AGENTS.md

Guidance for AI agents (Copilot CLI, Claude Code, Cursor) operating inside this plugin. The authoritative reference is this plugin's CLAUDE.md and the references/ docs; this file is the plugin-local routing rule. *If flowagent- MCP tools are present in your tool surface, USE THEM* for any flow/env/connection/run operation — list/get/create/update/edit/*copy/ publish/run flows, environments, connections, connectors, run history + run management (cancel*, *cancel_all*, *resubmit*, *diagnose**, loop repetitions), dynamic resolvers, templates, and getexpressionhelp. The MCP server (.mcp.json → flowagent) is the supported integration…

93844d agoDiscuss
MicrosoftAGENTS.md

vs-streamjsonrpc

microsoft/vs-streamjsonrpc/AGENTS.md

* Review the CONTRIBUTING.md file for instructions to build and test the software. * Run the .github/Prime-ForCopilot.ps1 script (once) before running any dotnet or msbuild commands. If you see any…

9383mo agoDiscuss
MicrosoftAGENTS.md

SymCrypt

microsoft/SymCrypt/AGENTS.md

SymCrypt is Microsoft's core cryptographic function library, used across Windows and other Microsoft products. It is a FIPS 140-validated, security-critical C library with hand-written assembly for performance-critical paths. The Microsoft-internal repository is hosted in Azure DevOps. The public GitHub repository is updated periodically, but may not contain the latest code. For Microsoft internal development, you should always use the Azure DevOps repository. If you have access to Deep Wiki via MCP or web search, you can use it to ask…

8905mo agoDiscuss
MicrosoftAGENTS.md

typeagent-py

microsoft/typeagent-py/AGENTS.md

DO NOT BE OBSEQUIOUS **NEVER use TESTMODELNAME or "test" embedding model outside of test files** Never run git commands that make any changes. (git status and git diff are fine) Exceptions: git push, git worktree, git branch (for tracking setup), as instructed below. Exceptions: git push, git worktree, git branch (for tracking setup), as instructed below. NEVER COMMIT CODE. Do not run git commit or any other git commands that make changes to the repository. Exception: Worktrees/Branches below. git add…

88412mo agoDiscuss
MicrosoftAGENTS.md

AL / al-issue-triager

microsoft/AL/.github/agents/al-issue-triager/AGENTS.md

Investigate one public microsoft/AL issue and return exactly one standardized triage comment for the workflow to validate and post. Triage only: never change repository files, create a branch or pull request, post directly to GitHub, close or transfer the issue, assign it, or apply/remove labels. In particular, never apply accepted; a human owns acceptance and the separate internal follow-up process. A report that is independently not reproduced on the latest prerelease product path may instead be scoped as likely fixed;…

88142d agoDiscuss
MicrosoftAGENTS.md

lage

microsoft/lage/AGENTS.md

Lage ("make" in Norwegian) is a task runner for JavaScript/TypeScript monorepos. It pipelines npm scripts across packages so that, for example, test can start as soon as its own package's build finishes rather than waiting for all builds. This is a Yarn Berry (v4) workspace monorepo with ~28 packages under packages/. These commands work from the repo root. Before finalizing changes, run yarn ci from the root for complete build/test/lint verification. These commands can be used to verify changes to…

8172mo agoDiscuss
MicrosoftAGENTS.md

beachball

microsoft/beachball/AGENTS.md

Trust these instructions. Only search the codebase if information here is incomplete or found to be in error (notify the user if an error is found). Following these steps will minimize failed commands and CI rejections. Beachball is a CLI tool for automating semantic version bumping, changelog generation, and npm publishing in monorepos and single-package repos. This repo is a Yarn 4 monorepo of ~2,000 files. The main deliverable is the beachball npm package. Always run yarn --immutable first if…

8154mo agoDiscuss
MicrosoftAGENTS.md

dotnet-framework-docker

microsoft/dotnet-framework-docker/AGENTS.md

This repository contains the official Docker images for .NET Framework, published to Microsoft Container Registry (mcr.microsoft.com). Images build on each other: runtime → aspnet → wcf, with sdk building on runtime. Each variant supports multiple .NET Framework versions (4.8, 4.8.1) across Windows Server Core versions (ltsc2016, ltsc2019, ltsc2022, ltsc2025). To modify Dockerfiles or READMEs, edit the templates and regenerate: Templates use Cottle syntax with variables from manifest.versions.json: Tests are categorized by image type: runtime, sdk, aspnet, wcf, pre-build. Tests validate…

7618mo agoDiscuss
MicrosoftAGENTS.md

TypeAgent / typeagent-core

microsoft/TypeAgent/ts/packages/typeagent-core/AGENTS.md

For AI agents and developers working in this package. @typeagent/core is the VS Code-free engine library behind TypeAgent Studio: sandbox lifecycle, corpus federation, the structured event stream, feedback, health rules, the collision scanner, the replay engine, and the onboarding bridge. The runtime/ module wires these primitives into the context-agnostic Studio runtime (createStudioRuntimeCore → StudioRuntime) via a host-supplied StudioRuntimeContext. Where the runtime instance lives: the runtime runs once per workspace, in a standalone Studio service — a host-agnostic library (this runtime/…

7433mo agoDiscuss
MicrosoftAGENTS.md

TypeAgent / typeagent-studio

microsoft/TypeAgent/ts/packages/typeagent-studio/AGENTS.md

For AI agents and developers working in this package. typeagent-studio is the bespoke VS Code extension surface of TypeAgent Studio: tree views (Sandboxes, Corpora, Event Log, Collisions), a health status bar, commands, and webviews (Impact Report). It is a thin client of the standalone, per-workspace Studio service — the rich VS Code view over a runtime it does not own. (The studio agent is also a thin client of that same service, for the chat/MCP surface.) This package renders and…

7433mo agoDiscuss
MicrosoftAGENTS.md

MIDI

microsoft/MIDI/AGENTS.md

Windows MIDI Services. See README.md for what the project is, and CONTRIBUTING.md for contribution process. You may be given access to non-public source or documents to investigate a problem. Treat them as input to your decisions only. Nothing from them may appear in this repository, or in issues, pull requests or commit messages — not file or symbol names, not internal interfaces or keys, and not the mechanism behind a behavior. Describing externally observable behavior is fine; explaining how it…

6849d agoDiscuss
MicrosoftAGENTS.md

microsoft-ui-reactor

microsoft/microsoft-ui-reactor/AGENTS.md

Reactor is a declarative, component-based C# framework for building WinUI 3 desktop apps. It renders real WinUI controls via a virtual element tree and reconciler — similar to React's programming model but targeting native Windows UI. Every suite runs on Microsoft.Testing.Platform (MTP): global.json pins test.runner, xunit.v3 v4 is MTP-only, and the MSTest projects opt in with EnableMSTestRunner. Practical consequences: the project is still passed positionally (dotnet test tests/Reactor.Tests), but prefer --filter-class / --filter-method / --filter-not-class / --filter-trait on the xUnit…

65437d agoDiscuss
MicrosoftAGENTS.md

winget-create

microsoft/winget-create/AGENTS.md

Follow .github/copilot-instructions.md for repository-specific development guidance. Before filing a GitHub issue in this repository: Before opening a pull request:

65251d agoDiscuss
MicrosoftAGENTS.md

ApplicationInsights-dotnet

microsoft/ApplicationInsights-dotnet/AGENTS.md

This is the .NET SDK for Azure Monitor / Application Insights, built on OpenTelemetry. It provides the Microsoft.ApplicationInsights family of NuGet packages for instrumenting .NET applications with distributed tracing, metrics, and logging. Platform-specific filters: Everything.Windows.slnf, Everything.Linux.slnf. Key conventions: - Central package management via Directory.Packages.props - Public API tracking in .publicApi/ (update PublicAPI.Unshipped.txt when adding public APIs) - Strong-name signing required The skills/applicationinsights-setup/ folder contains a portable skill that helps developers set up, migrate, or enhance Application Insights 3.x SDK in…

6146mo agoDiscuss
MicrosoftAGENTS.md

CopilotAdventures

microsoft/CopilotAdventures/AGENTS.md

CopilotAdventures is an educational repository featuring fantasy-themed coding challenges designed to teach GitHub Copilot's different interaction modes. The repository is organized as follows:

58014mo agoDiscuss
MicrosoftAGENTS.md

semantic-link-labs

microsoft/semantic-link-labs/AGENTS.md

This guide provides comprehensive instructions for AI agents working on the Semantic Link Labs (sempy_labs) codebase — an open-source Python library that extends the capabilities of Semantic Link for Microsoft Fabric notebooks. Semantic Link Labs is a community-driven extension library designed for use in Microsoft Fabric notebooks. It provides additional functionalities to work with: Semantic Link Labs depends on the semantic-link-sempy package as specified in pyproject.toml: The library uses the public APIs from sempy.fabric for: - FabricRestClient — HTTP client…

5778mo agoDiscuss
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.