agentleFS

CLAUDE.md examples from real projects

How real projects brief Claude Code: the commands, conventions and warnings they put in CLAUDE.md.

Worked for most · soon
Microsoft AzureCLAUDE.md

LogicAppsUX / Standalone

Azure/LogicAppsUX/apps/Standalone/CLAUDE.md

Development environment for the Logic Apps Designer. This Vite-powered React application provides a local development and testing environment for all designer libraries. This app hosts E2E tests: E2E tests are located in /e2e/ at the repo root. Consumes all major libraries: - @microsoft/logic-apps-designer - @microsoft/logic-apps-designer-v2 - @microsoft/designer-ui - @microsoft/logic-apps-shared - @microsoft/logic-apps-data-mapper - @microsoft/logic-apps-data-mapper-v2 - @microsoft/logic-apps-chatbot Read apps/Standalone/src/graphify-out/GRAPH_REPORT.md for structural context (god nodes, communities, surprising connections).

1145mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

LogicAppsUX / vs-code-designer

Azure/LogicAppsUX/apps/vs-code-designer/CLAUDE.md

The VS Code extension host for Azure Logic Apps. This is the main extension that gets published to the VS Code marketplace. Extension ↔ Webview messaging: The extension is packaged with dependencies: 1. Build: pnpm run build:extension 2. Copy files: Runs extension-copy-svgs.js 3. Install deps: cd dist && npm install 4. Package: vsce package Run Phase 4.2 only (requires workspaces from a prior Phase 4.1 run): Key files: designerActions.test.ts, run-e2e.ts, SKILL.md (detailed learning document)

1145mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

LogicAppsUX / vs-code-react

Azure/LogicAppsUX/apps/vs-code-react/CLAUDE.md

React applications that run inside VS Code webview panels. These provide the UI for the Logic Apps Designer extension. Each webview has its own entry: - src/app/designer/app.tsx - Designer entry - src/app/dataMapper/app.tsx - Data mapper entry - src/app/overview/app.tsx - Overview entry Uses @microsoft/vscode-extension-logic-apps for messaging: Built files go to apps/vs-code-designer/dist/vs-code-react/: - index.html - Webview HTML entry - assets/ - JS/CSS bundles All major designer libraries: - @microsoft/logic-apps-designer - @microsoft/logic-apps-designer-v2 - @microsoft/designer-ui - @microsoft/logic-apps-data-mapper - @microsoft/logic-apps-data-mapper-v2 - @microsoft/vscode-extension-logic-apps Read apps/vs-code-react/src/graphify-out/GRAPH_REPORT.md for…

1145mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

LogicAppsUX

Azure/LogicAppsUX/CLAUDE.md

These rules apply to every task — including ones that look trivial. Skipping them because a task "looks like a one-liner" is a known failure mode. Azure Logic Apps UX is a monorepo containing the UI components for Azure Logic Apps visual workflow designer. It powers the designer experience across Azure Portal, VS Code extension, Power Automate, and standalone environments. Key knowledge files for E2E tests: - apps/vs-code-designer/src/test/ui/SKILL.md — Complete learning document (700+ lines) - apps/vs-code-designer/src/test/ui/designerHelpers.ts — Shared designer test…

1145mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

LogicAppsUX / a2a-core

Azure/LogicAppsUX/libs/a2a-core/CLAUDE.md

React SDK for building chat interfaces that connect to AI agents using the A2A (Agent-to-Agent) protocol. Package: @microsoft/logic-apps-chat Uses Zustand for chat state: IndexedDB storage via idb: - Message history - Session state - Offline support Uses Zod for runtime validation: Minimal external dependencies: - @fluentui/react-components - UI framework - eventemitter3 - Events - idb - IndexedDB - immer - Immutability - marked - Markdown - prismjs - Highlighting - zod - Validation - zustand - State Read libs/a2a-core/src/graphify-out/GRAPH_REPORT.md for…

1145mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

LogicAppsUX / chatbot

Azure/LogicAppsUX/libs/chatbot/CLAUDE.md

AI-powered chatbot integration for the Logic Apps Designer. Provides conversational assistance for workflow creation and troubleshooting. Package: @microsoft/logic-apps-chatbot Used within the designer's side panel: The chatbot connects to backend AI services: - Request/response formatting - Streaming response handling - Context management Uses Fluent UI for consistent appearance: - Chat bubble styling - Code syntax highlighting - Loading indicators - Theme-aware colors Read libs/chatbot/src/graphify-out/GRAPH_REPORT.md for structural context (god nodes, communities, surprising connections).

1145mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

LogicAppsUX / data-mapper

Azure/LogicAppsUX/libs/data-mapper/CLAUDE.md

Legacy data transformation tool. Visual editor for creating data mappings between source and target schemas. Package: @microsoft/logic-apps-data-mapper Legacy - Superseded by data-mapper-v2. Maintained for backward compatibility but new features should be added to v2. Access via Standalone app at /datamapper route. When possible, prefer data-mapper-v2: - Better performance - Modern architecture - Uses @xyflow/react v12 Read libs/data-mapper/src/graphify-out/GRAPH_REPORT.md for structural context (god nodes, communities, surprising connections).

1145mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

LogicAppsUX / data-mapper-v2

Azure/LogicAppsUX/libs/data-mapper-v2/CLAUDE.md

Current-generation visual data transformation tool. Create mappings between source and target schemas with a modern drag-and-drop interface. Package: @microsoft/logic-apps-data-mapper-v2 Uses Fluent UI v9 makeStyles - Good reference for makeStyles patterns: Access via Standalone app at /datamapper-v2 route: Read libs/data-mapper-v2/src/graphify-out/GRAPH_REPORT.md for structural context (god nodes, communities, surprising connections).

1145mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

LogicAppsUX / designer

Azure/LogicAppsUX/libs/designer/CLAUDE.md

The main workflow designer component library. This is the core package that powers the visual Logic Apps editing experience. Package: @microsoft/logic-apps-designer Two parser implementations: - BJSWorkflowParser - Standard (Azure Functions-hosted) - ConsumptionParser - Consumption tier Parsers handle: - Deserializing workflow JSON to Redux state - Serializing Redux state back to JSON - Handling nested operations (scopes, loops) The designer accepts services via DesignerProvider: - connectionService - Manage connections - operationManifestService - Operation metadata - searchService - Operation search - oAuthService…

1145mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

LogicAppsUX / designer-ui

Azure/LogicAppsUX/libs/designer-ui/CLAUDE.md

Shared stateless UI components library. Contains reusable React components used across the designer, data mapper, and other packages. Package: @microsoft/designer-ui Uses Lexical for rich text editing: - @lexical/react integration - Custom plugins for expression insertion - HTML import/export Expression editor uses Monaco: - Custom language support for Logic Apps expressions - Syntax highlighting - Autocomplete for tokens - Validation Tests focus on: - Component rendering - User interactions - Accessibility - Edge cases Read libs/designer-ui/src/graphify-out/GRAPH_REPORT.md for structural context (god nodes,…

1145mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

LogicAppsUX / designer-v2

Azure/LogicAppsUX/libs/designer-v2/CLAUDE.md

Next-generation workflow designer with performance improvements and architectural enhancements. Currently in active development alongside the main designer. Package: @microsoft/logic-apps-designer-v2 In Development - Not yet feature-complete. The main designer package remains the production version. Access via Standalone app at /designer-v2 route: When working on v2: 1. Check if feature exists in v1 first 2. Ensure compatibility with existing workflows 3. Test performance improvements 4. Document architectural changes Same as designer v1: - @microsoft/designer-ui - @microsoft/logic-apps-shared - @microsoft/logic-apps-chatbot - @xyflow/react - @reduxjs/toolkit

1145mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

LogicAppsUX / logic-apps-shared

Azure/LogicAppsUX/libs/logic-apps-shared/CLAUDE.md

Foundation library containing shared utilities, service interfaces, and common functionality used across all Logic Apps packages. Package: @microsoft/logic-apps-shared i18n utilities using react-intl: Important type definitions: - Workflow - Workflow definition - Operation - Operation metadata - Connection - Connection configuration - Connector - Connector metadata - Parameter - Operation parameters Test utilities provided in /utils/src/lib/mocks/: - Mock services - Test data factories - Provider wrappers Minimal dependencies (foundation package): - @apidevtools/swagger-parser - API parsing - @xyflow/react - Graph types -…

1145mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

LogicAppsUX / vscode-extension

Azure/LogicAppsUX/libs/vscode-extension/CLAUDE.md

Shared utilities and services for the Logic Apps VS Code extension. Provides common functionality used by both the extension host and webviews. Package: @microsoft/vscode-extension-logic-apps Read libs/vscode-extension/src/graphify-out/GRAPH_REPORT.md for structural context (god nodes, communities, surprising connections).

1145mo agoReviewMountCreate a free account to mount
MicrosoftReads credentialsCLAUDE.md

spec-to-agents

microsoft/spec-to-agents/CLAUDE.md

This is a Python project that uses Microsoft Agent Framework--the new unified orchestration framework that combines the best of: To build a multi-agent event planning workflow. Before responding to ANY user message, you MUST complete this checklist: Responding WITHOUT completing this checklist = automatic failure. If you catch yourself thinking ANY of these thoughts, STOP. You are rationalizing. Check for and use the skill. Why: Skills document proven techniques that save time and prevent mistakes. Not using available skills means…

11412mo agoReviewMountCreate a free account to mount
MicrosoftReads credentialsCLAUDE.md

Agent365-Samples

microsoft/Agent365-Samples/CLAUDE.md

This is the Agent365-Samples repository containing sample agents demonstrating the Microsoft Agent 365 SDK across three languages (C#/.NET, Python, Node.js/TypeScript) and multiple AI orchestrators (OpenAI, Claude, Semantic Kernel, Agent Framework, LangChain, CrewAI, etc.). The Microsoft Agent 365 SDK extends the Microsoft 365 Agents SDK with enterprise-grade capabilities for observability, notifications, MCP tooling, and runtime utilities. Each language directory contains a docs/design.md with language-specific design patterns. Solutions: - dotnet/agent-framework/AgentFrameworkSample.sln - dotnet/semantic-kernel/SemanticKernelSampleAgent.sln Python samples use pyproject.toml for dependency management. Most samples support…

11325d agoReviewMountCreate a free account to mount
Hugging FaceCLAUDE.md

context-course / inference

huggingface/context-course/projects/inference/CLAUDE.md

This is the llama.cpp inference optimization project. Use AGENTS.md as the hard rulebook. Keep this project separate from ../pre-training and ../post-training. The Claude Code-native pieces are: Recommended entrypoint: For a…

1126mo agoReviewMountCreate a free account to mount
Hugging FaceCLAUDE.md

context-course / pre-training

huggingface/context-course/projects/pre-training/CLAUDE.md

OpenCode is the canonical control plane for this repo. The Claude Code implementation is a secondary native integration. It should follow the same local workflow: - no hosted Autolab backend…

1126mo agoReviewMountCreate a free account to mount
ShopifyCLAUDE.md

theme-liquid-docs / claude

Shopify/theme-liquid-docs/ai/claude/CLAUDE.md

🚨 MANDATORY: YOU MUST CALL "learn_shopify_api" ONCE WHEN WORKING WITH LIQUID THEMES. Use the Shopify AI Toolkit for all Shopify API and platform work. If missing, install it in the agent host per that page (or npx skills add Shopify/shopify-ai-toolkit --list for skill-compatible hosts). Key principles: focus on generating snippets, blocks, and sections; users may create templates using the theme editor

1103mo agoReviewMountCreate a free account to mount
BlockCLAUDE.md

builderbot / penpal

block/builderbot/apps/penpal/CLAUDE.md

This repo uses ANCHORS for requirements-driven development. You MUST load the anchors skill (/anchors) before making any code changes. When adding or modifying features, you must update ALL THREE documents before writing code: 1. PRODUCT.md — Add a P-* requirement (user-facing behavior only) 2. ERD.md — Add an E-* requirement with ← backlink to the P-* ID 3. TESTING.md — Add or update the coverage mapping table so every new/changed requirement has a test-layer assignment. Always verify the table reflects…

1088mo agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

thinkingbox

microsoft/thinkingbox/Claude.md

A test case includes: - definition of a task for an agent to complete - test code to verify that the task was completed successfully Test cases are part of a ThinkingBox dataset, they are distinct from unit tests. This section only applies to test cases. You'll see tests like this: There are several parts to this test: Good tests should test meaningful side effects from running the test case. They should allow the model to be flexible in how…

1076mo agoReviewMountCreate a free account to mount
CLAUDE.md vs AGENTS.md

About CLAUDE.md

What is CLAUDE.md?

A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.

Where does it go?

At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.

What should it contain?

Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.

CLAUDE.md or AGENTS.md?

Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.