Python AI Coding Rules

# Global development guidelines for the LangChain monorepo

This document provides context to understand the LangChain Python project and assist with development.

## Project architecture and context

### Monorepo structure

This is a Python monorepo with multiple independently versioned packages th...

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Browser-Use is an async python >= 3.11 library that implements AI browser driver abilities using LLMs + CDP (Chrome DevTools Protocol). The core architecture enables AI agents to auto...

# FastAPI — CLAUDE.md

## Project Overview

FastAPI is a modern, fast (high-performance) web framework for building APIs with Python based on standard Python type hints.

## Development

```bash
# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run with coverage
pytest --cov=...

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

Antigravity Kit is an AI-powered design intelligence toolkit providing searchable databases of UI styles, color palettes, font pairings, chart types, and UX guide...

# CLAUDE.md - PyTorch Image Models (timm)

## Build/Test Commands
- Install: `python -m pip install -e .`
- Run tests: `pytest tests/`
- Run specific test: `pytest tests/test_models.py::test_specific_function -v`
- Run tests in parallel: `pytest -n 4 tests/`
- Filter tests: `pytest -k "substring-to-...

# Project: claude-agents

Claude Code plugin marketplace — 72 focused plugins, 112 agents, 146 skills, 79 tools.

## Repository Structure

```
claude-agents/
├── .claude-plugin/marketplace.json   # Registry of all plugins
├── plugins/                          # All 72 plugins
│   ├── <plugin-name>/
...

# Financial Services Plugins

Cowork plugins and Claude Managed Agent templates for financial services. Each named agent ships two ways from one source.

## Repository Structure

```
├── plugins/
│   ├── agent-plugins/               #   named agents — one self-contained plugin each
│   │   └── <slug...

# CLAUDE.md

This file provides guidance to Claude Code when working with this repository.

## Project Overview

Node.js CLI tool for managing Claude Code components (agents, commands, MCPs, hooks, settings) with a static website for browsing and installing components. The project includes Vercel AP...

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Development Commands

**Essential Commands (use these exact commands):**
- `uv run poe format` - Format code (BLACK + RUFF) - ONLY allowed formatting command
- `uv run poe type-che...

# CLAUDE.md — caveman

## README is a product artifact

README = product front door. Non-technical people read it to decide if caveman worth install. Treat like UI copy.

**Rules for any README change:**

- Readable by non-AI-agent users. If you write "SessionStart hook injects system context," invi...

# CLAUDE.md / AGENTS.md

This file provides guidance when working with code in this repository.

## Project Overview

NeMo Speech — toolkit for training/deploying speech models (ASR, TTS, Speech LLM). Active collections: `asr`, `tts`, `audio`, `speechlm2`, `common`. No Megatron / Megatron Core / Tra...

# Claude Quickstarts Development Guide

## Legal

- When changes are made to files that have a copyright notice add them to that subdirectory's CHANGELOG.md file.

## Computer-Use Demo

### Setup & Development

- **Setup environment**: `./setup.sh`
- **Build Docker**: `docker build . -t computer-use...

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/session-start.sh"
          }
        ]
      }
    ]
  }
}
...

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

**Skill Seekers** converts documentation from 17 source types into production-ready formats for 24+ AI platforms (LLM platforms, RAG frameworks, vector databases,...

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

# Instructor Development Guide

## Commands
- Install deps: `uv pip install -e ".[dev,anthropic]"` or `poetry install --with dev,anthropic`
- Run tests: `uv run pytest tests/ -n auto`...

# OpenAI Agents SDK — CLAUDE.md

## Core Concepts

- **Agent**: An LLM configured with instructions, tools, and handoffs.
- **Tool**: Python function the agent can call. Decorated with `@function_tool`.
- **Handoff**: Transfer control to another specialized agent.
- **Runner**: Executes the agent lo...

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Purpose

This is a **comprehensive skills library** for Claude AI and Claude Code - reusable, production-ready skill packages that bundle domain expertise, best practices, ...

# Workflow

```bash
# Lint and style
# Check for issues and fix automatically
python -m ruff check src/ tests/ --fix
python -m ruff format src/ tests/

# Typecheck (only done for src/)
python -m mypy src/

# Run all tests
python -m pytest tests/

# Run specific test file
python -m pytest tests/test_...

# OpenLLMetry Repository Guide

## Repository Structure
This repository contains multiple PyPI-publishable packages organized and orchestrated using Nx workspace management.

### Nx Workspace Commands
```bash
# Run tests across all packages
nx run-many -t test

# Run linting across all packages
nx r...

# Guardrails — contributor guidance for Claude

## Dependency strategy (IMPORTANT — always follow)

This repo separates **compatibility** (what users are allowed to install) from
**security** (what we actually ship and test against). The two live in different
files and must be managed differently:

...

# Anthropic Python SDK — CLAUDE.md

## Overview

The official Python library for the Anthropic API. Supports Claude claude-opus-4-5, Claude claude-opus-4-5, and all Claude models.

## Installation

```bash
pip install anthropic
```

## Basic Usage

```python
import anthropic

client = anthropic.Anth...

# awesome-ChatGPT-repositories — Claude Code Guide

This repository is a curated list of 2500+ open-source GitHub repositories related to ChatGPT and LLMs. It includes a searchable skill for Claude Code.

## Repository structure

```
awesome-ChatGPT-repositories.json   ← main data (all 2500+ repos, ...

# CLAUDE.md - Developer Guide

This file provides guidance to Claude Code and developers working with this repository.

## Project Overview

iOS Simulator Skill is a production-ready Agent Skill providing 21 scripts for iOS app building, testing, and automation. It wraps Apple's `xcrun simctl` and F...

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

This is **awesome-claude-md** - a curated collection of high-quality `CLAUDE.md` files from public GitHub repositories. The goal is to showcase best practices for...

# Markdown to EPUB Skill - Development Guide

## Project Overview

A Claude agent skill that converts markdown documents into professional EPUB3 ebook files. This is a custom skill implementation demonstrating how to build Claude Code skills with file generation capabilities.

## Quick Start

### Se...

# Skills — Workflow Guide

This directory contains life sciences **skills** in two flavors: **code-centric** (pipeline/toolkit/database) and **prose-centric** (guide).
Claude Code uses this guide to author new entries when given a topic.

## Directory Layout

```
├── CLAUDE.md              ← you are...

# Claude AI Assistant Guidelines for Percolate Development

## Test Organization

Set envs to whatever .e.g if you add an env script like below run tests in that env with poetry
```
source set_res_env.sh && poetry run python -m pytest
```

### Test Directory Structure

All Python tests for the Perco...

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Commands

```bash
uv sync                                          # Install/update dependencies
uv run pytest                                    # Run all tests
uv run pytest test...

# DataFlow Pipeline - CLAUDE.md

## Tech Stack
- Python 3.12 with FastAPI and Celery
- PostgreSQL for data warehousing, Redis as message broker
- Analytics: Polars (prefer over Pandas for performance) and DuckDB
- Package manager: uv (prefer over Poetry for speed)

## Commands
- Install deps: uv syn...

# Data Analyst Subagent

You are a data analysis expert specializing in extracting insights from structured and unstructured data using Python, SQL, and modern analytics tools.

## Core Skills
- Pandas/Polars for data manipulation and transformation
- SQL for database queries (PostgreSQL, BigQuery, ...

# Django Project

> Claude Code configuration for Django projects with HTMX and modern Python tooling.

## Quick Facts

- **Stack**: Django, PostgreSQL, HTMX
- **Package Manager**: uv
- **Test Command**: `uv run pytest`
- **Lint Command**: `uv run ruff check .`
- **Format Command**: `uv run ruff for...