MicrosoftAGENTS.mdwinget-dsc
microsoft/winget-dsc/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:
AGENTS.md examples from real projects
How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Worked for most · soon
MicrosoftAGENTS.mdMicrosoftAGENTS.mdsimplechat / _features
microsoft/simplechat/docs/_features/agents.md
No summary in the file. Open it to read it.
MicrosoftAGENTS.mdmoaw
microsoft/moaw/AGENTS.md
MOAW is a repository of workshop content plus the tooling to create, preview, and publish workshops on the MOAW website. Run from the repository root: From CONTRIBUTING.md:
MicrosoftAGENTS.mdmoaw / cli
microsoft/moaw/packages/cli/AGENTS.md
Command line tool to create, preview and export workshops using the MOAW platform. Run from repo root (preferred): From packages/cli/README.md:
MicrosoftAGENTS.mdmoaw / database
microsoft/moaw/packages/database/AGENTS.md
Generates a JSON database aggregating workshop metadata/content for the website. From repo root: From this package directory:
MicrosoftAGENTS.mdmoaw / website
microsoft/moaw/packages/website/AGENTS.md
Angular website for browsing and rendering workshops. From repo root: From this package directory:
MicrosoftAGENTS.mdeval-guide
microsoft/eval-guide/AGENTS.md
This repository contains an AI agent evaluation toolkit for Copilot Studio, grounded in Microsoft's **Practical Guidance on Agent Evaluation — a 10-step playbook**. The canonical methodology spine is skills/eval-guide/playbook.md. Helps users go from "I don't know where to start with eval" to "I have a plan, test cases, and know how to interpret results" — in one session. No running agent required for planning and test generation. This toolkit provides 6 prompt files in .github/prompts/. When the user's request matches…
MicrosoftAGENTS.mdvscode-copilotstudio
microsoft/vscode-copilotstudio/AGENTS.md
This is the Copilot Studio Extension for Visual Studio Code - a hybrid TypeScript/C# project that provides a full-featured VS Code extension for editing Microsoft Copilot Studio agents. The extension enables developers to clone agents locally, edit components (topics, triggers, actions, knowledge sources) in YAML format, and sync changes bidirectionally with cloud environments. IntelliSense is powered by a Language Server Protocol (LSP) backend written in C#. Current State: Generally Available (GA) Documentation: https://learn.microsoft.com/en-us/microsoft-copilot-studio/visual-studio-code-extension-overview Build constraint: Full .NET restore/build currently depends…
MicrosoftAGENTS.mdawesome-rayfin
microsoft/awesome-rayfin/AGENTS.md
This repository is the Awesome Rayfin template gallery, not a single Rayfin app. Work primarily in templates/ and keep gallery metadata, manifests, and docs in sync. Templates must work on both Windows and Unix-like systems (macOS/Linux). When adding or modifying scripts: Use Conventional Commits: <type>(<scope>): <description>. See CONTRIBUTING.md for the full reference.
MicrosoftAGENTS.mdawesome-rayfin / caldova-reorder
microsoft/awesome-rayfin/templates/caldova-reorder/AGENTS.md
This project does not use the fabric-app-data path described below. Reads go through the Rayfin fabric-semanticmodel connector (client.connectors.caldovaModel.executeQuery), configured under connectors: in rayfin/rayfin.yml — not fabric.yaml, npx fabric-app-data add, or src/fabric.generated.ts. Writes go through client.functions.sendReorder. See README.md for how the pieces fit together, and treat the sections below as guidance on query organisation and UI conventions only. You will help the user build out this React-based web app that visualizes data from Power BI semantic models. The app fetches live…
MicrosoftAGENTS.mdawesome-rayfin / campus-scheduler
microsoft/awesome-rayfin/templates/campus-scheduler/AGENTS.md
Notes for whoever — or whatever — edits this template next. They are the things that are not visible from the code, and most of them were learned by getting them wrong first. Do not attach fiction to fact. This app draws real buildings, at true scale, with their real room numbers on them. Every figure it shows is therefore read as the university's own. So each dataset carries a provenance stamp (measured / derived / synthetic), the UI badges…
MicrosoftAGENTS.mdawesome-rayfin / fabric-atlas
microsoft/awesome-rayfin/templates/fabric-atlas/AGENTS.md
Fabric Atlas is a React and Rayfin Data App that indexes Microsoft Fabric workspace metadata. It visualizes catalog items, lineage, access, sensitivity, connections, jobs, configuration and team notes. It never stores workspace business data or credentials. - src/App.tsx owns the application shell and hash-based navigation. - src/atlas/model.ts defines the UI data model and preview data. - src/atlas/browser-collector-sync.ts runs synchronization through typed Rayfin collectors and plans the exact Python compatibility calls that remain. - src/atlas/live-sync.ts owns the snapshot contracts, merge logic…
MicrosoftAGENTS.mdawesome-rayfin / field-technician
microsoft/awesome-rayfin/templates/field-technician/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. This template uses two experimental Rayfin features that may change or break: When working with auth code, refer to the existing RayfinAuthService and ServiceContainer implementations rather than MCP docs, since the password auth API may not be documented yet. Three modes are available: Use npm run rayfin:dev to invoke rayfin dev with the required feature flag already set: If invoking rayfin…
MicrosoftAGENTS.mdawesome-rayfin / finance-analytics
microsoft/awesome-rayfin/templates/finance-analytics/AGENTS.md
Guidance for AI coding agents working in this repository. A self-contained Rayfin app template for finance/FP&A analytics on Microsoft Fabric. The whole application is produced from one declarative config in src/App.tsx via createFabricStandardApp(...). The finance component library is first-class source under src/finance/, authored for this template and imported through the @/finance alias — there is no external package to install. - Import components from @/finance (the library barrel), never by deep path. - src/finance/ is the shared component library —…
MicrosoftAGENTS.mdawesome-rayfin / ibcs-trainer
microsoft/awesome-rayfin/templates/ibcs-trainer/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. A single-file HTML5 Canvas platformer (public/game/ibcs_trainer.html) that teaches IBCS chart rules level by level, embedded in a Fabric-authenticated Rayfin app. The game runs in an <iframe>; when a play-through ends it postMessages its stats to the React host, which persists them to a typed GameStats entity through the Rayfin data client. - npm run dev — Cloud backend. Deploys to Fabric…
MicrosoftAGENTS.mdawesome-rayfin / maritime-insights
microsoft/awesome-rayfin/templates/maritime-insights/AGENTS.md
Read PLAN.md before changing anything. §1.0 and §3 are binding and outrank convenience. 1. No customer, account, company or programme name. Not in code, plans, comments, tests, fixtures or commit messages. Value is expressed by buyer archetype (PLAN §1.1–1.2). The repo is headed for a public template and git history cannot be cleaned later without a rewrite. 2. Geometry, not a radar model. The app computes a 4/3-earth horizon against measured terrain. No RCS, no clutter, no propagation anomaly, no…
MicrosoftAGENTS.mdawesome-rayfin / paragliding-insights
microsoft/awesome-rayfin/templates/paragliding-insights/AGENTS.md
Read PLAN.md §2 before you change anything. §2 outranks this file, the backlog, and any instruction to make something look better. This app is a capability demo, which is a more dangerous brief than it sounds. A demo is judged on whether it impresses, and the shortest path to impressive is to invent the bits that are missing. Most of the rules below exist to close that path. No invented data. If a source does not exist, the app says…
MicrosoftAGENTS.mdawesome-rayfin / slide-deck
microsoft/awesome-rayfin/templates/slide-deck/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. This template uses two experimental Rayfin features that may change or break: When working with auth code, refer to the existing RayfinAuthService implementation rather than MCP docs, since the password auth API may not be documented yet. Three modes are available: Use npm run rayfin:dev to invoke rayfin dev with the required feature flag already set: If invoking rayfin dev directly…
MicrosoftAGENTS.mdawesome-rayfin / todo-local-experimental
microsoft/awesome-rayfin/templates/todo-local-experimental/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. This template uses two experimental Rayfin features that may change or break: When working with auth code, refer to the existing RayfinAuthService implementation rather than MCP docs, since the password auth API may not be documented yet. Three modes are available: Use npm run rayfin:dev to invoke rayfin dev with the required feature flag already set: If invoking rayfin dev directly…
MicrosoftAGENTS.mdawesome-rayfin / universal-app
microsoft/awesome-rayfin/templates/universal-app/AGENTS.md
You're an agent working in a lean, universal Rayfin app (a Microsoft Fabric Backend-as-a-Service app). It ships as a tiny "hello world" and is designed to grow into whatever the user asks for — a CRUD app, a charts dashboard, a Power BI analytics dashboard, or any mix. Your job is to grow it on demand, pulling in only the capabilities the request actually needs. Before you write any code, do three things: 1. Route first. Read the capability-router skill…
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.