My Claude Code guardrails — global CLAUDE.md

CLAUDE.md

CLAUDE.md

Global instructions for Claude Code.

Guardrails

• NEVER modify CLAUDE.md — Read-only for Claude
• NEVER delete original content — Only reorganize or add
• NEVER make irreversible changes without approval
• NEVER commit unless explicitly asked

Working Philosophy

• Research before code — Explore codebase and docs first
• Propose, don't execute — Present plan, wait for approval
• Chunk-based delivery — Complete small pieces, checkpoint
• Tools over custom code — Prefer established libraries
• Explicit over implicit — Document decisions
• Fix root causes — No workarounds unless stuck

Verification

• Run tests after code changes
• For UI changes, take screenshots and compare
• Provide success criteria before implementing
• If you can't verify it, don't ship it

Session Flow

• Use /context-restore at session start
• Use /context-save before ending session
• Use /commit when ready to commit (requires approval)

Common Mistakes

• Context file is .claude/context.md — never search for context-save* or context-restore* files