What is a CLAUDE.md file?

CLAUDE.md is the standing instructions file read by Anthropic's Claude Code CLI tool. It tells Claude Code how to compile, test, format, and check code in your repository.

How is CLAUDE.md different from AGENTS.md?

AGENTS.md is a tool-agnostic open convention for coding agents. CLAUDE.md is specific to Claude Code. To avoid duplication, the best practice is to make CLAUDE.md import AGENTS.md.

How does Moxie Docs help with CLAUDE.md?

Drafting a static file is the first step. When you connect GitHub, Moxie Docs analyzes your repo and continuously monitors for drift, opening reviewable PRs to keep CLAUDE.md and AGENTS.md current as code changes.

FREE TOOL

CLAUDE.md Generator

Structured Claude Code guidelines. Live preview. Clean Markdown export. Shareable links.

Draft the instructions file Claude Code parses to boot up codebase memory. Commits to your repo root.

Read the CLAUDE.md Guide

Project nameSummary for ClaudeOne or two sentences: what the repo is and how Claude Code should approach changes.Build commandsOne command per line - exported as a runnable code block.Test commandsOne command per line - what Claude runs to verify changes.Code styleOne rule per line - each becomes a bullet.ConventionsOne rule per line - where things live and patterns Claude should not guess.Repository layoutOne entry per line as “path - what it is”.PR & commit guidelinesOne rule per line - checks to run, title format, review expectations.Security notesOne rule per line - secrets handling and operations needing human review.

Live preview

CLAUDE.md guidelines for Acme Payments API

@AGENTS.md

Claude Specific Guidelines#

TypeScript monorepo for billing, subscriptions, and Stripe webhooks. Prefer small, reviewable PRs with tests for payment and auth paths.

Build commands#

Shell

npm install
npm run build

Test commands#

Shell

npm run test
npm run lint

Code style#

Use TypeScript strict mode.
Prefer explicit return types on exported functions.
Keep modules focused - one domain per folder under src/lib/.

Conventions#

Stripe webhook handlers live in src/lib/billing/.
Never log secrets or full card numbers.
All billing mutations go through subscription-items.ts helpers.

Repository layout#

apps/web - Next.js dashboard and API routes
packages/shared - shared types
supabase/migrations - database schema

PR & commit guidelines#

Run the full test suite before opening a PR.
Keep PRs to one logical change; billing and auth changes need a test.
Title format: [area] Short imperative summary.

Security notes#

Do not commit .env files.
Webhook routes must verify Stripe signatures before dispatching events.

CLAUDE.md goes stale - Moxie keeps your instructions evergreen Export free above · connect a repo when you want Moxie to keep it accurate

Read the CLAUDE.md guide See how Moxie keeps docs current

Claude Code optimized

Structured formatting for build, test, and lint commands that Claude Code executes natively during sessions.

Live preview

View the rendered CLAUDE.md Markdown file in real-time as you customize conventions.

Portable states

Encodes editor data directly in the URL query string. Share a link to collaborate on rules with team members.

100% Client-Side

Data stays in your browser. Generates CLAUDE.md locally without uploading codebase data.

Writing CLAUDE.md Instructions

Import AGENTS.md

Add `@AGENTS.md` at the top of the file so Claude Code imports your tool-agnostic rules, keeping instructions DRY.

Claude Code CLI Commands

List exact compilation and lint patterns. Claude Code executes these directly in the shell to verify edits.

Standing Style Rules

Tell Claude how to structure files and code semantics (e.g. strict type imports, functional components).

Verification Scripts

Specify tests and coverage expectations Claude Code must run before requesting a human review.

Built for the AI-agent era

CLAUDE.md goes stale - Moxie keeps your instructions evergreen

Draft and export your CLAUDE.md here. Read the definitive CLAUDE.md guide, then connect GitHub when you want Moxie to automatically detect drift and propose updates via PR.

Read the CLAUDE.md guide See how Moxie keeps docs current

Export free above · connect a repo when you want Moxie to keep it accurate