CLAUDE.md examples from real projects

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

Best matchesWorked for most · soon

alirezarezvaniCLAUDE.md

claude-skills / engineering-team

alirezarezvani/claude-skills/engineering-team/CLAUDE.md

architect** — Azure infrastructure design, ARM/Bicep templates, landing zones - **gcp-cloud-architect** — GCP infrastructure design, Terraform modules, cloud-native patterns - **security-pen-testing** — Penetration testing methodology, vulnerability assessment, exploit analysis - **snowflake

25k5mo agoDiscuss

antonbabenkoCLAUDE.md

terraform-skill

antonbabenko/terraform-skill/CLAUDE.md

generated from `SKILL.md`, so the skill content is shared, not forked. ## Repository Structure ``` terraform-skill/ ├── skills/ │ └── terraform-skill/ # Skill autodiscovered by Claude Code plugin system │ ├── SKILL.md # Core skill file

2.3k4mo agoDiscuss

patrickchughCLAUDE.md

terravision

patrickchugh/terravision/docs/CLAUDE.md

this repository. ## Project Overview TerraVision is an AI-powered CLI tool that converts Terraform code into professional cloud architecture diagrams. It runs 100% client-side, securely parses Terraform plans

1.6k8d agoReads credentialsDiscuss

daymadeCLAUDE.md

claude-code-skills

daymade/claude-code-skills/CLAUDE.md

# CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code

1.4k7mo agoPipes a download into a shellDiscuss

MicrosoftCLAUDE.md

AIOpsLab

microsoft/AIOpsLab/CLAUDE.md

Edit config.yml: set k8s_host to localhost or kind ``` #### Option 2: Azure VMs with Terraform + Ansible See section: [Azure Deployment with Terraform + Ansible](#azure-deployment-with-terraform--ansible) ### Cluster Management

9847mo agoReads credentialsDiscuss

Pantheon-SecurityCLAUDE.md

medusa

Pantheon-Security/medusa/CLAUDE.md

poisoning, agent security - Traditional vulnerabilities (SQL injection, XSS, secrets) - Configuration files (YAML, JSON, Terraform, Docker) **Optional**: External linters (bandit, eslint, etc.) are auto-detected if installed. ## Security Scanning ### Scan Reports

97410mo agoDiscuss

zeenie-aiCLAUDE.md

OpenCompany

zeenie-ai/OpenCompany/CLAUDE.md

# OpenCompany - Claude Documentation ## Project Overview This is a React Flow-based workflow automation platform

96522d agoReads credentialsDiscuss

agentic-communityCLAUDE.md

mcp-gateway-registry

agentic-community/mcp-gateway-registry/CLAUDE.md

specific ARNs; cross-account AssumeRole behind an explicit-list default-empty (fail closed); keep Terraform+CDK in parity. - **Internal tokens:** short TTL isn't enough — add `jti` + single

94413d agoReads credentialsDiscuss

fabio-rovaiCLAUDE.md

open-ontologies

fabio-rovai/open-ontologies/CLAUDE.md

path as `onto_load` | ## Ontology Lifecycle When evolving an ontology in production, follow this Terraform-style cycle. Claude decides which steps to include based on the change. ### Plan 1. Call

5426d agoDiscuss

madarcoCLAUDE.md

agentbox

madarco/agentbox/CLAUDE.md

caller. - [`docs/host-tools.md`](./docs/host-tools.md) — the box→host CLI proxy: how any host CLI (`gh`, `terraform`, `aws`, `ntn`, `linear`) reaches a box through one generic shim, the request-vs-grant trust split

4974mo agoReads credentialsDiscuss

GRCEngClubCLAUDE.md

claude-grc-engineering

GRCEngClub/claude-grc-engineering/CLAUDE.md

capabilities. ### Code Generation **Command**: `/grc-engineer:generate-implementation [output-dir]` Generates complete implementation packages including: - **Terraform modules**: Production-ready IaC with best practices - **Python scripts**: Evidence collection, compliance testing, automation - **Monitoring

3916mo agoDiscuss

nwiizoCLAUDE.md

tfmcp

nwiizo/tfmcp/CLAUDE.md

CLAUDE.md tfmcp is a Rust-based MCP server for Terraform operations using the RMCP SDK. ## Quick Reference ```bash # Quality checks (run before commits) cargo fmt --all && RUSTFLAGS="-Dwarnings" cargo clippy

37125d agoDiscuss

avivlCLAUDE.md

claude-007-agents

avivl/claude-007-agents/CLAUDE.md

financial-modeling-agent` - **Infrastructure**: `@devops-troubleshooter`, `@cloud-architect`, `@database-admin`, `@incident-responder`, `@network-engineer`, `@terraform-specialist` - **AI/ML**: `@prompt-engineer`, `@error-detective`, `@machine-learning-engineer`, `@computer-vision-specialist`, `@nlp-llm-integration

26613mo agoDiscuss

Google CloudCLAUDE.md

race-condition

GoogleCloudPlatform/race-condition/CLAUDE.md

codebase` -- architecture and design decisions, with reading paths organized by intent - `deploying` -- GCP deployment, Terraform, deployment troubleshooting - `contributing` -- pre-commit hooks, tests, PR preparation Load the relevant one before answering

2325mo agoReads credentialsDiscuss

ferdinandobonsCLAUDE.md

AWSBedrockAgentCoreSkill

ferdinandobons/AWSBedrockAgentCoreSkill/CLAUDE.md

docs.aws.amazon.com`, `strandsagents.com`, official AWS GitHub orgs (`aws`/`awslabs`/`aws-samples`/`aws-ia`), the official Terraform registry (`hashicorp/aws`, `hashicorp/awscc`), and `boto3`/`pypi`/`npm`. The two non-AWS sources (the A2A protocol

2094mo agoDiscuss

ahmedasmarCLAUDE.md

devops-claude-skills

ahmedasmar/devops-claude-skills/CLAUDE.md

Structure ``` devops-claude-skills/ ├── .claude-plugin/ │ └── marketplace.json # Marketplace registry (lists all available skills) ├── iac-terraform/ # Skill: Terraform & Terragrunt │ ├── .claude-plugin/ │ │ └── plugin.json # Skill metadata │ └── skills/ │ ├── SKILL.md # Main skill content (loaded when

19811mo agoReads credentialsDiscuss

jenticCLAUDE.md

jentic-one

jentic/jentic-one/CLAUDE.md

observability/# Standalone LGTM chart (Grafana/Loki/Tempo/Prom + OTel collector) │ └── values/ # Per-mode + per-overlay value files └── terraform/ # Terraform modules and environment compositions ``` ## Frontend (`ui/`) The single-page app lives

1833mo agoDiscuss

ppgrangerCLAUDE.md

token-saver

ppgranger/token-saver/CLAUDE.md

works - A PreToolUse hook intercepts Bash commands matching known patterns (git, docker, npm, terraform, kubectl, etc.) - The command output is piped through specialized compression processors - Compressed output is returned

1534mo agoDiscuss

CranotCLAUDE.md

agi-in-md

Cranot/agi-in-md/CLAUDE.md

caches.** A conversation that navigates to L13 becomes a compressed cognitive trajectory that instantly terraforms new context windows. prism.py is an engine for generating trajectory caches. 28. **Persona × Context Density

1487mo agoDiscuss

TikiTribeCLAUDE.md

claude-secure-coding-rules

TikiTribe/claude-secure-coding-rules/CLAUDE.md

context, schema, provenance) │ │ │ ├── iac/ # Infrastructure as Code rules │ │ ├── _core/iac-security.md # Core IaC security principles │ │ ├── terraform/CLAUDE.md # Terraform (state, modules, providers) │ │ └── pulumi/CLAUDE.md # Pulumi (secrets, CrossGuard, ESC) │ │ │ └── cicd/ # CI/CD security rules │ ├── _core/cicd-security.md # Core CI/CD

14010mo agoDiscuss

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.