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

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

7524mo agoReviewMountCreate a free account to mount
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…

7524mo agoReviewMountCreate a free account to mount
MicrosoftReads credentialsAGENTS.md

teams-sdk / cli

microsoft/teams-sdk/packages/cli/AGENTS.md

Do not commit or push unless explicitly asked. Use picocolors for terminal styling. Use Intl.DateTimeFormat via formatDate() from src/utils/date.ts. Use logger from src/utils/logger.ts for all output. Never use console.log/console.error directly (except inside logger.ts and json-output.ts). For error conditions, throw CliError from src/utils/errors.ts: Wrap command .action() handlers with wrapAction() — it catches CliError and unknown errors, routes to JSON or human output, and handles ExitPromptError gracefully. In interactive menus (not wrapped by wrapAction), catch errors inline with logger.error(). HTTP/API helper modules…

73516d agoReviewMountCreate a free account to mount
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…

72927d agoReviewMountCreate a free account to mount
MicrosoftReads credentialsAGENTS.md

copilot-camp / RepairServiceAgent

microsoft/copilot-camp/src/extend-m365-copilot/path-e-lab01-declarative-copilot/RepairServiceAgent/AGENTS.md

Expert guidance for building declarative agents with TypeSpec for Microsoft 365 Copilot using Microsoft 365 Agents Toolkit

6774mo agoReviewMountCreate a free account to mount
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:

6593mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rayfin / typedoc

microsoft/rayfin/common/config/typedoc/AGENTS.md

typedoc.lint.json is the validation-only TypeDoc config consumed by rush lint / rush lint:check. It runs TypeDoc with emit: "none" to surface broken {@link} references, undocumented public symbols, and other TSDoc issues without producing any output. The actual TypeDoc binary is installed via the rush-prettier autoinstaller (common/autoinstallers/rush-prettier/package.json); there is no dependency on the docgen package. Add the package directory to the entryPoints array in typedoc.lint.json. The list is explicit (not globbed) because TypeDoc 0.28's packages strategy does not support ! negation,…

64637d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rayfin / site

microsoft/rayfin/docs/site/AGENTS.md

Scope: Docusaurus site under docs/site for Contributors. Use the Rush docs subspace. - Install deps: rush update --subspace docs - Dev server: cd docs/site && rushx start - Build: cd docs/site && rushx build or rush build --to docs-site - Serve static: cd docs/site && rushx serve (pass additional Docusaurus flags after --) - Lint markdown: rush docs:lint - Always run rushx commands from docs/site. - If a command fails, capture the full terminal output and confirm pwd before trying…

64637d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rayfin / react-best-practices

microsoft/rayfin/.github/skills/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…

64637d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rayfin / docgen

microsoft/rayfin/packages/docgen/AGENTS.md

Scope: TypeDoc configuration and generation for SDK API reference docs. Generates markdown into packages/docgen/dist/ts-sdk which the Docusaurus site at docs/site mirrors into its own staging directory at config-load time. - Config: packages/docgen/typedoc.json - Landing page: packages/docgen/README.md (TypeDoc readme option) - SDK inputs: each entryPoints directory under packages/typescript-sdk/ with entryPointStrategy: "packages". The current set covers lib, core, client, auth, data, auth-provider-fabric, functions, connectors, and connector-fabric-semanticmodel. connector-kusto and storage are excluded because they are marked stability: "experimental" in the docs catalog, and…

64637d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rayfin / guide

microsoft/rayfin/packages/guide/AGENTS.md

@microsoft/rayfin-guide ships Builder guide markdown for version-locked docs lookup. Agents access this package through @microsoft/rayfin-docs, rayfin docs, and the Rayfin MCP server. Run rush docs:lint from the repo root after editing markdown.

64637d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rayfin / host-docs

microsoft/rayfin/packages/host-docs/AGENTS.md

@microsoft/rayfin-host-docs ships host reference markdown for version-locked docs lookup. Agents access this package through @microsoft/rayfin-docs, rayfin docs subcommands with --module host (for example, rayfin docs search <query> --module host), and the Rayfin MCP server when it is started with host docs enabled. Run rush docs:lint from the repo root after editing markdown.

64637d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rayfin / tools

microsoft/rayfin/packages/tools/AGENTS.md

Code under packages/tools/** is ESM. Use .js in all relative import specifiers. @microsoft/rayfin-tools-common (packages/tools/common/) is a private package for code shared across CLI, MCP, and VS Code extension. It must stay universal (no Node.js or DOM-specific APIs). See packages/tools/common/AGENTS.md. @microsoft/rayfin-docs (packages/tools/docs-lib/) owns DocsService, installed package discovery, docs search, symbol lookup, and catalog-backed package recommendations. See packages/tools/docs-lib/AGENTS.md before editing it. @microsoft/rayfin-mcp (packages/tools/mcp/) exposes the docs service to agents through list_docs, search_docs, get_doc, and discover_packages. See packages/tools/mcp/AGENTS.md before editing it. Docs lookup…

64637d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rayfin / cli

microsoft/rayfin/packages/tools/cli/AGENTS.md

Agent instructions for working in packages/tools/cli/ (@microsoft/rayfin-cli). See packages/tools/AGENTS.md for tools-wide conventions (ESM imports, .js specifiers, shared @microsoft/rayfin-tools-common). Any task that touches the Rayfin CLI — packages/tools/cli/, the rayfin command, or a new/changed command, subcommand, flag, output, error message, exit code, progress indicator, or interactive behavior — REQUIRES loading .github/skills/rayfin-cli-ux/SKILL.md BEFORE planning, drafting an OpenSpec proposal/spec/design/tasks, implementing, or reviewing the change. This is not optional and applies even when the user asks for "a quick fix." Skipping the skill is…

64637d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rayfin / agent-files

microsoft/rayfin/packages/tools/cli/assets/agent-files/AGENTS.md

This project ships Rayfin agent context. Load .agents/skills/rayfin/SKILL.md and the rayfin MCP server in .mcp.json before writing Rayfin code. Rayfin docs are version-locked to the packages installed in this project. Prefer the MCP tools search_docs, get_doc, list_docs, and discover_packages for examples, API details, and troubleshooting. If MCP is unavailable, run rayfin docs ... from the project root so the CLI reads this project's node_modules. If rayfin is not on PATH, use npx -y @microsoft/rayfin-cli docs ... from the project root.

64637d agoReviewMountCreate a free account to mount
MicrosoftReads credentialsAGENTS.md

rayfin / common

microsoft/rayfin/packages/tools/common/AGENTS.md

Private, shared utility package for Rayfin tools (CLI, MCP, VS Code extension). Not published. rayfin-cli — shared with CLI and MCP. This package's public, universal surface (the src/index.ts barrel and the _internal/adapters, _internal/checks, _internal/config, _internal/telemetry, _internal/utils/retry, _internal/workflows subpath barrels) must run in both Node.js and browser/WebWorker environments (VS Code desktop + web extension). The package also ships a small set of Node-only sub-modules (_internal/env-config/bootstrap, parts of _internal/templates) for consumers (CLI, create-rayfin, VS Code extension host) that need filesystem, child-process, or…

64637d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rayfin / docs-lib

microsoft/rayfin/packages/tools/docs-lib/AGENTS.md

@microsoft/rayfin-docs is the shared docs engine for rayfin docs and @microsoft/rayfin-mcp. It discovers package-owned docs through each installed package's rayfinDocs package.json field and loads markdown from that package's assets/docs directory by default. Run focused docs-lib tests with rushx test -- src/__tests__/discovery.test.ts src/__tests__/docs.test.ts from packages/tools/docs-lib. For cross-package changes, also run the relevant CLI or MCP tests from their package directories.

64637d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rayfin / mcp

microsoft/rayfin/packages/tools/mcp/AGENTS.md

@microsoft/rayfin-mcp is the agent-facing MCP server for Rayfin docs. It should expose docs from the user's installed Rayfin packages, not from a copied docs corpus inside the MCP package. Run MCP tests with rushx test from packages/tools/mcp. When docs service contracts change, also run focused @microsoft/rayfin-docs tests.

64637d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rayfin / vscode

microsoft/rayfin/packages/tools/vscode/AGENTS.md

VS Code extension for Project Rayfin development, built inside the Rush monorepo. This project is in the vscode Rush subspace. React webviews communicate with the extension host via tRPC over postMessage. See these skills for details: To add a new webview: define a router, create a controller extending WebviewController, register in appRouter and WebviewRegistry, create a React component. The react-best-practices and react-clean-architecture skills both apply to webview code. Where they conflict, this project follows these decisions: - Barrel files (index.ts):…

64637d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

rayfin / typescript-sdk

microsoft/rayfin/packages/typescript-sdk/AGENTS.md

This directory contains the TypeScript/Node.js SDK packages (@microsoft/rayfin-*) published for Builders. - Install dependencies: Run rush update --subspace default from the repo root to install or refresh SDK dependencies. - Dependency management: Use rush add -p <package> or rush remove -p <package> for changes. Do not use npm, pnpm, or yarn directly inside the monorepo. - Build: Use rush build --to <project> to build specific SDK packages, or rushx build from a package directory. - Test: Use rush test --to…

64637d 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.