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

SwiftStreamingMarkdown

microsoft/SwiftStreamingMarkdown/AGENTS.md

Trust these instructions first. Only search the repository if information here is incomplete or wrong. SwiftStreamingMarkdown is a Swift Package that renders Markdown in SwiftUI. It is consumed by Apple-platform apps that need to display Markdown content, either bespoke or incrementally produced by an LLM or other streaming source. The package is iOS-first, distributed via Swift Package Manager only, and ships with a sample app under Examples/. Key technologies: The major components of this library are parsing and rendering. They…

3616mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

slow-cheetah

microsoft/slow-cheetah/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…

3534mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

ApplicationInsights-Java

microsoft/ApplicationInsights-Java/AGENTS.md

Read CONTRIBUTING.md and copilot-instructions.md first. It is the source of truth for repository layout, build and test commands, style expectations, and scope.

3285mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode-azurefunctions

microsoft/vscode-azurefunctions/AGENTS.md

TypeScript VS Code extension creates, configures, debugs, deploys, manages local and Azure Function Apps. Use this map to find narrowest owner before editing; matching .github/instructions/*.instructions.md files hold deeper subsystem rules. Trace behavior end-to-end before editing: package.json contribution or API call -> registration -> command/wizard -> shared service/tree model -> refresh/output -> tests. Interactive Azure authentication follows this chain: Functions -> Azure Resources extension -> @microsoft/vscode-azext-azureauth -> vscode.authentication -> built-in Microsoft Authentication provider.

32110d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

model-mondays

microsoft/model-mondays/AGENTS.md

This repository publishes Model Mondays livestream episodes and Foundry Friday on-demand AMAs about AI models, Microsoft Foundry, and agent development. Checked-in JSON and published Markdown must agree. docs/assets/ is the canonical public asset tree. Foundry Fridays is an on-demand initiative, not a season-driven weekly series. AMA numbers are global, unique, and sequential. An AMA may optionally link to a related episode, but no relationship is required. Season 4 is titled Model Spotlights for Agent Builders. For a new episode: For…

30644d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

Build-CLI

microsoft/Build-CLI/AGENTS.md

This repo packages the Microsoft Events assistant plugin and the @microsoft/events-cli CLI. The plugin helps agents use live Microsoft Build and Ignite session catalogs; the CLI fetches, caches, normalizes, and searches those catalogs. The repo publishes plugin metadata for GitHub Copilot and Claude Code. Keep shared product identity fields aligned across the manifests when changing the plugin name, description, version, author, repository, keywords, license, skills path, or MCP wiring. Shared assets used by the plugin ecosystems: - skills\microsoft-events\SKILL.md — the…

29316d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

profile-explorer

microsoft/profile-explorer/AGENTS.md

NEVER commit or git add without explicit user permission. When asked for a commit message, provide the message text only - do not execute git commit or git add. IMPORTANT: Always use Release configuration (-c Release). The user runs Release builds, not Debug. If running, ask the user to close it before building. The Core project build is much faster (~2-3s) and doesn't require ProfileExplorer to be closed. The app version lives in 3 files that must stay in lockstep…

2895mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

SqlScriptDOM

microsoft/SqlScriptDOM/AGENTS.md

This repository keeps its canonical Copilot instruction files in the .github folder and its reusable agent skills in .agents/skills. Before starting work, read .github/copilot-instructions.md for repository-wide guidance. Then use the relevant topic-specific instruction files in .github/instructions/: - adding_new_parser.guidelines.instructions.md - bug_fixing.guidelines.instructions.md - database_option.guidelines.instructions.md - debugging_workflow.guidelines.instructions.md - function.guidelines.instructions.md - grammar_validation.guidelines.instructions.md - grammar.guidelines.instructions.md - new_data_types.guidelines.instructions.md - new_index_types.guidelines.instructions.md - parser.guidelines.instructions.md - testing.guidelines.instructions.md When a reusable skill applies, load it from .agents/skills/: - add-feature/SKILL.md - verify-and-test-tsql-syntax/SKILL.md Version note: - Treat TSql180 as the current vNext/latest…

2847mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

finnts

microsoft/finnts/AGENTS.md

Make changes that are testable, documented, backward-compatible where practical, and R CMD check-clean. If a required check cannot run, state why and name the command that remains to be run.

28342d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

clarity-agent

microsoft/clarity-agent/AGENTS.md

processes/ contains markdown files that act as the control flow — an LLM reads and executes them. src/clarity_agent/ contains Python infrastructure those processes call. clarity.py is the entry point. processes/clarity-agent.md is "main". It checks whether .clarity-protocol/ exists, runs packet_status.py to assess state, and routes to the correct process guide. After any process completes, control returns here. src/clarity_agent/protocol/packet_status.py is the build system / flow controller. It maintains a SHA-256 dependency graph among protocol documents (stored in config.json) and detects when a…

2792mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

clarity-agent / music_library

microsoft/clarity-agent/examples/music_library/AGENTS.md

This file integrates the Clarity Protocol into your AI-assisted development workflow. The Clarity Protocol helps you build systems that actually work by maintaining shared understanding of what you're building, why, and what could go wrong. When building software with AI assistance, three things commonly go wrong: The Clarity Protocol solves this by creating a .clarity-protocol/ directory alongside your code that captures: Think of it as the "missing manual" for your code—the stuff you can't figure out just by reading the…

2792mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

powerplatform-vscode

microsoft/powerplatform-vscode/Agents.md

This is the Power Platform VS Code extension that provides tooling for creating, building, and deploying Power Platform solutions, packages, and portals. It integrates the Power Platform CLI (pac) directly into VS Code. - src/client/extension.ts: Main extension entry point - package.json: Extension manifest with commands and contributions - src/client/lib/PacActivityBarUI.ts: Activity bar panels and UI registration - src/client/PortalWebView.ts: Power Pages portal webview management - src/client/pac/PacWrapper.ts: Wrapper for Power Platform CLI commands - src/client/power-pages/actions-hub/ActionsHubTreeDataProvider.ts: Power Pages Actions Hub tree data provider -

27941d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

powerplatform-vscode / web

microsoft/powerplatform-vscode/src/web/Agents.md

This document provides setup, architecture, coding, and testing instructions for the web extension located in src/web. It is designed to help both humans and AI agents contribute effectively. The web extension extends Visual Studio Code for Power Platform scenarios. All source code for the web extension is located in the src/web directory. To build the web extension, run: This will compile the extension and output the necessary files.

27941d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

mggraph-intune-samples

microsoft/mggraph-intune-samples/AGENTS.md

Guidance for AI coding agents and human contributors working in this repository. mggraph-intune-samples is a collection of sample PowerShell scripts that show how to use the Microsoft Graph PowerShell SDK to manage Microsoft Intune (device configuration, compliance, app protection, enrollment, managed devices, reporting, and more). It is a non-production, learning/reference repository: the scripts are meant to be read, adapted, and run by IT pros against their own tenants. It produces no build artifact and is not a dependency of other…

2785mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

skala

microsoft/skala/AGENTS.md

Follow these conventions to produce consistent, high-quality contributions. Skala is a neural network-based exchange-correlation (XC) functional for density functional theory (DFT). The codebase includes: - Formatter/linter: Ruff (ruff format, ruff check --fix --select I). - Type checking: Pyrefly in strict mode. Ignore missing type information only for explicitly named untyped dependencies in pyrefly.toml; do not use global missing-import suppression. - Line length: 100 characters (Black-compatible). - Imports sorted via Ruff's isort rules. - Generated build, coverage, and documentation output is…

27424d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

GitHub-Copilot-for-Azure / telemetry-reporter

microsoft/GitHub-Copilot-for-Azure/telemetry-reporter/AGENTS.md

This directory contains a standalone .NET 10 implementation of the Azure MCP server plugin-telemetry command. Read README.md for user-facing build, packaging, and usage documentation. This file defines how coding agents…

2644d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

GitHub-Copilot-for-Azure / tests

microsoft/GitHub-Copilot-for-Azure/tests/AGENTS.md

For AI Agents: This document provides patterns and conventions for creating and maintaining tests for azure-skills plugin. When asked to "scaffold tests" for a skill, follow the instructions below. When…

2644d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

azure-tools-for-java

microsoft/azure-tools-for-java/AGENTS.md

Azure Toolkits for Java — IDE plugins for IntelliJ IDEA and Eclipse that help Java developers create, develop, configure, test, and deploy applications to Azure. The primary focus of active…

2638mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

MSBuildLocator

microsoft/MSBuildLocator/AGENTS.md

This library exists to locate an MSBuild install (Visual Studio or .NET SDK) and register an assembly-resolution handler so the host app loads MSBuild's assemblies from that install. This is…

2633mo 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.