How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.
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.
MicrosoftAGENTS.mdmicrosoft/rayfin/packages/typescript-sdk/auth/AGENTS.md
Authentication SDK for Rayfin applications. See README.md for API concepts and usage examples. Run these from packages/typescript-sdk/auth/: From repository root: Depends on @microsoft/rayfin-lib for HTTP client and error handling.
MicrosoftAGENTS.mdmicrosoft/rayfin/packages/typescript-sdk/core/AGENTS.md
This package contains TypeScript decorators that store runtime metadata for data model definition. The Rayfin CLI reads this metadata to generate DAB-compliant configuration. Run these from packages/typescript-sdk/core/: Runtime Metadata: Decorators store metadata at runtime using Symbol.metadata. src/index.ts re-exports ./schema.js by an explicit named list rather than with export *. That is deliberate: the storage folder symbols (RayfinStorageFolder, isRayfinStorageFolder, getStorageFolderMetadata, tryGetStorageFolderMetadata, StorageFolderClass, StorageFolderMetadata) must stay off the stable surface while the storage service is not enabled in Fabric. They remain exported…
MicrosoftAGENTS.mdmicrosoft/rayfin/packages/typescript-sdk/data/AGENTS.md
Run these from packages/typescript-sdk/data/.
MicrosoftAGENTS.mdmicrosoft/rayfin/packages/typescript-sdk/storage/AGENTS.md
This package provides the standalone storage SDK for blob operations (upload, download, list, delete) with typed folder access. Run these from packages/typescript-sdk/storage/:
MicrosoftReads credentialsAGENTS.mdmicrosoft/rayfin/packages/udf/udf-worker-extension/AGENTS.md
TypeScript worker extension for Microsoft Fabric User Data Functions (UDFs). It provides the udf.func() authoring surface, RayfinContext, the AudienceType connection model, and the AST-based typegen that emits types.ts. See README.md for the package overview and license. This is a standalone npm package (not a Rush project). Run from packages/udf/udf-worker-extension/: npm test does not type-check. The shared base config sets isolatedModules: true, so ts-jest transpiles without diagnostics — a test file containing const x: number = 'nope' still passes. tsconfig.json also…
MicrosoftAGENTS.mdmicrosoft/rayfin/samples/data-app/AGENTS.md
You will help the user build out this React-based web app that visualizes data from Power BI semantic models. The app fetches live data via DAX queries, renders charts and grids using Vega-Lite and a built-in DataGrid component, and supports light/dark theming. Your job is to discover the user's data, write correct DAX queries, build React components that fetch and display that data, and validate the result in the browser. Break tasks into independent pieces and delegate them to sub-agents…
MicrosoftReads credentialsAGENTS.mdmicrosoft/rayfin/samples/getting-started-auth/AGENTS.md
This project ships agent context: skills under .agents/skills/ and MCP servers in .mcp.json. Load them before writing code. React + TypeScript (Vite) todo app backed by Project Rayfin with Radix-based UI components styled with Tailwind CSS. Demonstrates todo management with Fabric Entra authentication enabled by default. Auth is fully integrated: local dev uses a mock email/password flow, production uses Fabric Entra SSO. This project uses Radix-based UI components styled with Tailwind CSS v4. Key config/files:
MicrosoftReads credentialsAGENTS.mdmicrosoft/rayfin/samples/notes-app/AGENTS.md
Scope: Builders and agents working on the notes-app. This file provides implementation context, commands, and workflows for AI assistants. Provision or reuse the Fabric backend and start local development: Source of truth: rayfin/.env (RAYFIN_PUBLIC_* prefix). rayfin dev generates .env.local before starting the frontend. Vite frontend variables (in .env.local): Config files: ServiceContainer provides Rayfin-backed services: Key services: Custom hooks wrap services for React components: Decorators (@microsoft/rayfin-core): Client (@microsoft/rayfin-client): Data API (@microsoft/rayfin-data): Do not edit these paths; treat them as build or…
MicrosoftReads credentialsAGENTS.mdmicrosoft/rayfin/samples/todo-app/AGENTS.md
Scope: Contributors and agents working on samples/todo-app inside the Rush monorepo. Link README.md for Contributor-facing setup; this file focuses on implementation, commands, and workflows. Install and build from repository root: Rayfin CLI workflows (run from samples/todo-app/): Run the sample from samples/todo-app/ (preferred via rushx): dev:mock, dev:rayfin, and toggle-mode call scripts/toggle-service-mode.js, which edits .env.local to pin VITE_SERVICE_MODE. Treat .env.local as developer state and never commit it. Testing, lint, and build (from samples/todo-app/): Source of truth: rayfin/.env (RAYFIN_PUBLIC_* prefix). rayfin dev generates…
MicrosoftAGENTS.mdmicrosoft/rayfin/samples/universal-app/template/AGENTS.md
Build the requested React and Vite Fabric App from the small authenticated workspace. Turn on only the capabilities the app needs, preserve the protected default and dynamic authentication flow, and validate the result users will actually run. Read the capability-router before writing application code. It owns source selection and the capability decision. Capabilities compose. Apply every selected pack with a separate command, serially, because pack operations mutate workspace manifests and root orchestration. The scaffolder accepts one pack per invocation; do…
MicrosoftReads credentialsAGENTS.mdmicrosoft/rayfin/samples/welcome-app-react-auth/AGENTS.md
This project ships agent context: skills under .agents/skills/ and MCP servers in .mcp.json. Load them before writing code. React + TypeScript (Vite) app backed by Project Rayfin with 45+ Radix-based UI components styled with Tailwind CSS. Demonstrates authentication, data persistence, and user-owned timestamp tracking. This project uses Radix-based UI components styled with Tailwind CSS v4. For shadcn-related tasks (generating UI code/components, finding examples, registry items), prefer the shadcn MCP tools: Key config/files:
MicrosoftReads credentialsAGENTS.mdmicrosoft/rayfin/samples/welcome-app-react-no-auth/AGENTS.md
This project ships agent context: skills under .agents/skills/ and MCP servers in .mcp.json. Load them before writing code. This is an introductory React sample demonstrating basic Rayfin data operations without authentication or storage. It serves as a minimal starting point for understanding Rayfin's data layer with React. This sample uses React with Vite. The main application logic lives in src/App.tsx with React hooks for state management. Key components: React hooks used: Features demonstrated: Decorators (@microsoft/rayfin-core): Schema (rayfin/data/schema.ts): Client (@microsoft/rayfin-client): Data…
MicrosoftReads credentialsAGENTS.mdmicrosoft/rayfin/samples/welcome-app-typescript/AGENTS.md
This project ships agent context: skills under .agents/skills/ and MCP servers in .mcp.json. Load them before writing code. This is an introductory TypeScript sample demonstrating basic Rayfin data operations without authentication or storage. It serves as a minimal starting point for understanding Rayfin's data layer. This sample uses vanilla TypeScript with Vite (no React or other framework). All UI and data-fetching logic lives in a single file: src/main.ts. Key components: Features demonstrated: Decorators (@microsoft/rayfin-core): Schema (rayfin/data/schema.ts): Client (@microsoft/rayfin-client): Data API…
MicrosoftDeletes or force-pushesAGENTS.mdmicrosoft/finops-toolkit/AGENTS.md
The FinOps Toolkit is an open-source collection of tools for adopting and implementing FinOps capabilities in the Microsoft Cloud. It contains templates, PowerShell modules, workbooks, optimization engines, and supporting documentation organized in a modular architecture. The FinOps hubs solution is actively migrating to a namespace-based modular structure: Templates use a multi-target build system that generates: Key patterns:
MicrosoftAGENTS.mdmicrosoft/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…
MicrosoftAGENTS.mdmicrosoft/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…
MicrosoftAGENTS.mdmicrosoft/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:
MicrosoftAGENTS.mdmicrosoft/DebugMCP/AGENTS.md
DebugMCP is a VS Code extension that embeds an MCP (Model Context Protocol) server, enabling AI coding agents to control VS Code's debugger via DAP (Debug Adapter Protocol). AI agents can start/stop debugging, step through code, set breakpoints, inspect variables, and evaluate expressions. IMPORTANT: Keep docs/*.md files up to date when modifying components. These docs should remain high-level: - Purpose and motivation - Responsibility scope - Key concepts and patterns - Pointers to relevant code sections Do NOT duplicate detailed…
MicrosoftReads credentialsAGENTS.mdmicrosoft/Generative-AI-for-beginners-java/AGENTS.md
This is an educational repository for learning Generative AI development with Java. It provides a comprehensive hands-on course covering Large Language Models (LLMs), prompt engineering, embeddings, RAG (Retrieval-Augmented Generation), and the Model Context Protocol (MCP). Key Technologies: - Java 21 - Spring Boot 3.5.x - Spring AI 1.1.x - Maven - LangChain4j - Azure AI Foundry, Azure OpenAI, and OpenAI SDKs Architecture: - Multiple standalone Spring Boot applications organized by chapters - Sample projects demonstrating different AI patterns - GitHub…
MicrosoftReads credentialsAGENTS.mdmicrosoft/Generative-AI-for-beginners-java/translations/ar/AGENTS.md
هذا مستودع تعليمي لتعلم تطوير الذكاء الاصطناعي التوليدي باستخدام جافا. يوفر دورة شاملة عملية تغطي نماذج اللغة الكبيرة (LLMs)، هندسة التوجيه، التضمينات، RAG (التوليد المعزز بالإسترجاع)، وبروتوكول سياق النموذج (MCP). التقنيات الأساسية: - جافا 21 - Spring Boot 3.5.x - Spring AI 1.1.x - مافن - LangChain4j - Azure AI Foundry، Azure OpenAI، ومكتبات OpenAI SDK الهيكلية: - تطبيقات Spring Boot مستقلة متعددة منظمة حسب الفصول - مشاريع عينة توضح أنماطًا مختلفة للذكاء الاصطناعي - جاهز لـ GitHub Codespaces مع…
An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.
At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.
Setup and test commands, code style, and the rules a new contributor would need to know.
Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.
