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
JetBrainsCLAUDE.md

mcp-steroid / website

JetBrains/mcp-steroid/website/CLAUDE.md

This directory contains the Hugo source for the MCP Steroid website at https://mcp-steroid.jonnyzzz.com Scope note: the public website targets end users — install instructions, demo videos, the strategy page. Agent-facing design tenets live in docs/PHILOSOPHY.md (canonical, mirrored at runtime as mcp-steroid://skill/design-philosophy); contributor guidance for the plugin / prompts / tests lives in the per-folder CLAUDE.md and AGENTS.md files. Site copy and agent docs evolve on different cadences and to different audiences; don't conflate them. The website is built from this…

823mo agoReviewMountCreate a free account to mount
JetBrainsCLAUDE.md

mcp-steroid / website-gen

JetBrains/mcp-steroid/website-gen/CLAUDE.md

Guidance for the :website-gen module. Instructions here override the root guide for this folder. Read the root CLAUDE.md too (project-wide rules). :website-gen is build-tooling, not plugin runtime — no IntelliJ dependencies. One job: - Website artifacts (WebsiteArtifacts.kt, task generateWebsite) — resolves the published GitHub release and writes version.json + updatePlugins.xml (the IntelliJ custom-plugin-repository XML) into website/build/generated-static, and copies EULA + LICENSE there too. The task knows all paths (VERSION + release notes from the project layout); CI/Makefile invoke it with…

823mo agoReviewMountCreate a free account to mount
NVIDIACLAUDE.md

kumo-engine / kumo-ui-catalog

NVIDIA/kumo-engine/packages/kumo-ui-catalog/CLAUDE.md

@kumo-ai/kumo-ui-catalog — Kumo's shared component library and design system. Built on Radix UI + Tailwind CSS + CVA. Consumed in-tree by the Kumo UI. All UI primitives follow this pattern:

7838d agoReviewMountCreate a free account to mount
GoogleCLAUDE.md

moodle-on-gcp

google/moodle-on-gcp/CLAUDE.md

See AGENTS.md and .jules/sentinel.md for full repository architecture, mandatory review guardrails, and verification steps. See AGENTS.md for OpenWiki agent instructions.

745d agoReviewMountCreate a free account to mount
MistralCLAUDE.md

platform-docs-public

mistralai/platform-docs-public/CLAUDE.md

Mistral AI's platform documentation site, built with Next.js 15 (App Router), MDX, Tailwind CSS v4, and TypeScript. Uses pnpm as package manager. Prebuild scripts (run automatically by pnpm build): - pnpm cookbook:build — Compiles cookbook data from notebooks - pnpm rawmdx:export — Exports raw MDX content - pnpm copy-openapi — Copies OpenAPI specs - pnpm search:build — Builds the search index - pnpm copy-assets-file — Copies static assets The sidebar is filesystem-driven — src/lib/content/index.ts (getSidebar) recursively scans the (docs) directory…

746mo agoReviewMountCreate a free account to mount
ElasticCLAUDE.md

elastic-docs-skills

elastic/elastic-docs-skills/CLAUDE.md

A catalog of Claude Code skills for Elastic documentation workflows. Skills are installed into ~/.claude/skills/ via install.sh and used as slash commands or auto-triggered behaviors in Claude Code. Every skills/**/SKILL.md must have YAML frontmatter: Agentic workflows use .md files compiled to .lock.yml via gh aw compile. The lock files are auto-generated — never edit them directly. The .gitattributes file marks them as linguist-generated=true merge=ours. Use /create-skill within this repo, or see CONTRIBUTING.md for manual instructions. The Elastic documentation site exposes…

725mo agoReviewMountCreate a free account to mount
PydanticCLAUDE.md

ai-chat-ui

pydantic/ai-chat-ui/CLAUDE.md

A React-based chat interface for Pydantic AI that uses Vercel AI SDK and Elements. The project consists of a frontend (Vite + React + TypeScript) and a Python backend (FastAPI + Pydantic AI). Note: Stop any logfire platform instances to avoid port 8000 conflicts. Set E2E_VIDEO=1 to record screen videos with slowMo. Set E2E_TEST_DIR=<path> to override which directory Playwright walks (defaults to tests/e2e; pnpm test:e2e narrows it to tests/e2e/deterministic). The offline suite ignores E2E_TEST_DIR — it runs off its own…

713mo agoReviewMountCreate a free account to mount
PydanticCLAUDE.md

ai-chat-ui / tests

pydantic/ai-chat-ui/tests/CLAUDE.md

All deterministic tests drive the real FastAPI server at tests/server/server.py, which uses pydantic-ai's FunctionModel to return predictable streams. The models mapping is the authoritative fixture registry. A spec picks an entry via sendMessage(page, '<name>', '<message>'). When you need new behavior, add a FunctionModel to the server's models dict and select it from the spec. Do not introduce page.route mocks — they duplicated the SSE wire format and drifted on the SDK v5→v6 bump, which is why we switched.

713mo agoReviewMountCreate a free account to mount
BlockCLAUDE.md

agent-task-queue / claude-code

block/agent-task-queue/examples/claude-code/CLAUDE.md

For expensive build commands, ALWAYS use the run_task MCP tool instead of Bash. **Commands that MUST use run_task:** - gradle, bazel, make, cmake, mvn, cargo build, go build - docker build, docker-compose, kubectl, helm - npm/yarn/pnpm build, pytest, jest, mocha Usage: - command: The full shell command - working_directory: Absolute path to project root - env_vars: Optional like "KEY=value,KEY2=value2" NEVER run these via Bash. Always use run_task MCP tool.

6810mo agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

teams.py

microsoft/teams.py/CLAUDE.md

Microsoft Teams Python SDK — a UV workspace with multiple packages providing APIs, common utilities, and integrations for Microsoft Teams. Imports - ALL imports MUST be at the top of the file — no imports inside functions, classes, or conditional blocks - Avoid TYPE_CHECKING blocks unless absolutely necessary (genuine circular imports that can't be restructured) - Avoid dynamic/deferred imports unless absolutely necessary - Relative imports within the same package, absolute for external packages Models - Pydantic with ConfigDict(alias_generator=to_camel) — snake_case…

6817d agoReviewMountCreate a free account to mount
JetBrainsCLAUDE.md

intellij-streamdeck-plugin / streamdeck-plugin

JetBrains/intellij-streamdeck-plugin/streamdeck-plugin/CLAUDE.md

This is a dual-plugin system enabling Elgato Stream Deck hardware to control JetBrains IDEs: The Stream Deck plugin communicates with the IDE plugin via HTTP (http://{host}:{port}/api/action/{actionId}), passing an Authorization header (password) and optional ?name= query param for run configurations. Live development: refreshPlugin.sh auto-packages and deploys to the Stream Deck app. Debug URL: http://localhost:23654/ The Stream Deck plugin tries ports 63342–63352 sequentially when no custom port is configured, then falls back to the explicit remote port (21420).

677mo agoReviewMountCreate a free account to mount
NVIDIACLAUDE.md

physicsnemo-curator

NVIDIA/physicsnemo-curator/CLAUDE.md

Rust-based ETL toolkit for deep learning data curation with Python APIs. The Rust extension is exposed as physicsnemo_curator._lib and imported in __init__.py. Type stubs live at src/physicsnemo_curator/_lib.pyi. Defined in pyproject.toml under [dependency-groups]: Optional extras in [project.optional-dependencies]: Install with: uv sync --group dev or uv sync --group docs

676mo agoReviewMountCreate a free account to mount
VercelCLAUDE.md

npm.bet

vercel-labs/npm.bet/.claude/CLAUDE.md

This project uses Ultracite, a zero-config Biome preset that enforces strict code quality standards through automated formatting and linting. Biome (the underlying engine) provides extremely fast Rust-based linting and formatting.…

6612mo agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

dynwinrt

microsoft/dynwinrt/CLAUDE.md

dynwinrt is a Rust-based runtime library that enables dynamic invocation of Windows Runtime (WinRT) APIs. Unlike static projections (PyWinRT, C++/WinRT), this library uses runtime metadata (.winmd files) and FFI (libffi) to call arbitrary WinRT methods without native code generation. It provides JavaScript (napi-rs) and Python (PyO3) bindings, plus a code generation tool (dynwinrt-codegen) that produces typed wrappers from .winmd files. Classic COM and flat Win32 have separate JavaScript/TypeScript projections and runtime subpaths. Flat Win32 DLL exports use an independent native…

6417d agoReviewMountCreate a free account to mount
MetaCLAUDE.md

prompt-siren

facebookresearch/prompt-siren/CLAUDE.md

This is a workbench designed for security research to test attacks against large language models and prompt injection defenses. The project uses pydantic-ai as its core AI framework and supports multiple environments for testing. It features a Hydra-based configuration system for flexible experiment orchestration with parameter sweeps and overrides. Note: Integration tests require Docker to be running. CI/CD pipelines skip integration tests by default for speed. Note: Dataset and attack can be specified either via command-line overrides (+dataset=..., +attack=...) or…

629mo agoReviewMountCreate a free account to mount
LangChainCLAUDE.md

claude-code-evals

langchain-ai/claude-code-evals/CLAUDE.md

If you are coding with LangGraph, follow these principles and patterns. If any LangGraph files exist: Follow the existing structure exactly. Do not create new agent.py files. Only create agent.py…

6114mo agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

Agent365-devTools

microsoft/Agent365-devTools/CLAUDE.md

Microsoft Agent 365 DevTools CLI (a365) - A .NET CLI tool built on .NET 8.0 with support for running on .NET 8.0 or higher (e.g., .NET 9, 10). Used for deploying and managing Microsoft Agent 365 applications on Azure. Supports .NET, Node.js, and Python applications with auto-detection. Test Framework: xUnit with FluentAssertions and NSubstitute Test Location: src/Tests/Microsoft.Agents.A365.DevTools.Cli.Tests/ Parallel Test Execution: Tests modifying environment variables or shared resources must disable parallelization:

615mo agoReviewMountCreate a free account to mount
JetBrainsCLAUDE.md

kotlin-compiler-devkit

JetBrains/kotlin-compiler-devkit/CLAUDE.md

CRITICAL: @AGENTS.md guidelines MUST be followed at all times. Local Preferences: @./.claude/local.md

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