CLAUDE.md Deep Dive

CLAUDE.md reads top-to-bottom with decreasing priority. Put your most critical "never do X / always do Y" rules at the top.

Think about what's unique or homegrown in your project that AI hasn't seen in training data — custom DSLs, company-specific patterns, archaic conventions. When Claude makes a mistake because of these, fix it manually and add a rule to prevent it from happening again.

Never manually edit CLAUDE.md — ask Claude to update it for you so rules stay consistent and well-formatted.

When you spot a pattern Claude keeps getting wrong, just tell it: "Update the CLAUDE.md so we never do that again." Claude will maintain the file structure and add the rule in the right place.

Add keywords in CLAUDE.md that trigger specific behaviors — like "build the app" triggering Xcode MCP commands.

Define build commands, validation flows, and other workflows as named triggers in your CLAUDE.md. When you say the keyword phrase, Claude knows exactly which tools and commands to invoke.

Share your CLAUDE.md with your team by committing it — but keep it high-quality and remove personal file paths.

This is "compound engineering" — making the AI experience better for your whole team. Remove personal paths and generic rules. Keep the bar high because this file loads into everyone's context. Evaluate over weeks using "vibes" and team feedback.

Use claude --dangerously-skip-permissions to skip all approval prompts — but ONLY in disposable environments.

This is "YOLO mode." Claude won't ask for permission for any actions. Only use this in environments you can throw away. The author has bricked Linux machines by being too aggressive with this. Pair with /permissions to allowlist specific dangerous actions.

When using dangerously-skip, use /permissions to still block truly destructive commands like rm -rf.

Even in YOLO mode, you can maintain guardrails for the most destructive operations. Use /permissions to configure what should still require approval — especially deletion mutations and OS-level changes.