Bean Claude Code Cheat Sheet

Everything you need, searchable and scannable. Updated 2026-02-14.

1

Quick Reference Card

What I Want to DoWhat to TypeNotes
Start my day/morningPulls Todoist + Notion, suggests plan
Capture rambling thoughts/brain-dumpThen paste or dictate
Create a LinkedIn post/linkedinDescribe the topic or story
Check WP site before launch/deploy-checkRun in a WordPress project directory
Check Next.js before deploying/deploy-nextjsRun in a Next.js project directory
Run accessibility audit/a11y-auditThen provide the website URL
End my session/handoffGenerates summary for next session
Commit code changes/commitCreates a git commit with message
Commit + push + open PR/commit-push-prFull git workflow in one command
Plan a complex task/writing-plansBefore touching code on big features
Debug something broken/systematic-debuggingStructured debugging, not guesswork
Review code quality/requesting-code-reviewAfter finishing a feature
Verify before claiming done/verification-before-completionRun this before saying "it's done"
Brainstorm before building/brainstormingExplore requirements first
Search past conversations/search-conversationsFind what you discussed before
Clean up git branches/clean_goneRemoves branches deleted on remote
Look up library docsAsk Claude to use context7"Check the WordPress REST API docs using context7"
Scrape a webpage/firecrawl-cliFirecrawl handles all web operations
Generate an image/generateDescribe what you want
Create interactive playground/playgroundVisual configurator for any concept
Build a polished UI/frontend-designProduction-grade web interfaces
Get automation suggestions/claude-automation-recommenderRecommends skills/agents for your task
Fix VS Code bash path error/fix-vscode-bash-pathAfter VS Code extension updates
Browse the web directly/browsingChrome DevTools Protocol control
2

My Environment

Machine
ComponentDetail
OSWindows 11 Pro (10.0.22621)
IDEVS Code with Claude Code extension (Anthropic.claude-code)
ShellGit Bash (C:\Program Files\Git\bin\bash.exe)
Node.jsv22.18.0, npm 11.6.4
PHP8.2.12 (XAMPP) — upgrade to 8.4+ recommended for WP 6.9
Python3.13 (C:\Python313\python.exe)
FormatterPrettier (JS/TS), Intelephense (PHP)
TerminalPowerShell (default), Git Bash available
SSH Access
AliasWhatHostUserPort
ssh hdHostinger web hosting (WordPress sites)141.136.39.73u94523894065002
ssh vpsHostinger KVM 2 VPS (n8n + OpenClaw Docker)72.62.212.169root22

SSH config: C:\Users\Bean\.ssh\config

Hosting
ServiceWhat It HostsDomain
Hostinger Cloud StartupWordPress sites (dev + client)palestine-lives.org (dev), various client domains
Hostinger KVM 2 VPSn8n (Docker) + OpenClaw (Docker)smallgiantsstudio.cloud, n8n.smallgiantsstudio.cloud
VercelSmall Giants Studio website (Next.js)smallgiantsstudio.co.uk
CloudflareDNS registrar + proxysmallgiantsstudio.co.uk DNS
SupabaseBooking system database (eu-west-2, free tier)Project ref: wimrjgrujprvwbsewqrq
VS Code Claude Code Settings
SettingValue
Permission modebypassPermissions (dangerous mode enabled)
Preferred locationPanel
ModelDefault (Opus 4.6)
Git Bash pathC:\Program Files\Git\bin\bash.exe
Agent teamsEnabled (experimental)
3

My Projects

ProjectStackStatusBrief
HelpingDoctors EHR Pro WordPress Multisite, PHP, ACF Pro, Ultimate Member ~70% Medical records system. HIPAA/GDPR compliant, ~70 DB tables, 27 medical roles, AES-256-GCM encryption, FHIR-compatible
Small Giants Studio Next.js 16, React 19, Tailwind v4, TypeScript LIVE Business website at smallgiantsstudio.co.uk. Deployed on Vercel
SGS WordPress Framework Custom block theme + plugins (PHP, JS, @wordpress/scripts) In dev sgs-theme, sgs-blocks (22+ blocks), sgs-booking, sgs-client-notes. Dev site: palestine-lives.org
Booking System Next.js, Supabase, Drizzle, tRPC Early Standalone booking app with magic link auth
Mosque Timetable Plugin WordPress, ACF, custom post types, shortcodes Done Prayer timetable display plugin
All Purpose Maintenance n8n automation Planned Email intake, Asana, Xero, Tooltime integration
4

My Daily Workflow

Morning Routine
1

Open VS Code terminal

Start Claude Code in whatever project you'll work on first.

2

Type: /morning

Claude pulls your Todoist tasks, checks Notion, and suggests a plan for the day.

3

Pick your first task and go

Start with the easiest quick win to build momentum (ADHD tip: small victories first).

During the Day

Switching Projects

Just tell Claude which project you're working on. It adjusts automatically.

Capturing Ideas

Type /brain-dump and talk or type freely. Claude structures it into actions, ideas, decisions, and worries.

If You're Stuck

Type /systematic-debugging for structured problem-solving. Don't guess — follow the process.

If You're Overthinking

Claude will call you out. It's in the rules. Listen to it.

End of Day
1

Type: /handoff

Claude generates a summary of everything done, what's pending, what's next.

2

Save the summary

Copy to Notion or leave in conversation history. Next session, Claude can pick up where you left off via episodic memory.

Weekly (Thursday/Friday)

Small Giants Studio Focus

Claude will remind you about business development. Review grant applications, client follow-ups, and networking. Check project status in Notion.

5

My Rules

What rules are

Markdown files in ~/.claude/rules/ that Claude loads automatically at the start of every conversation. They act as permanent instructions — you never need to repeat them. Some rules have paths: in their frontmatter, which means they only activate when working on matching file types.

All files  uk-english.md

Enforces British English spelling everywhere: colour, behaviour, analyse, organisation, etc. Includes a full substitution table for common US/UK differences plus medical terms (paediatric, anaesthetic, haematology).

Exceptions: CSS properties, third-party library names, and existing database fields are kept as-is.

All code  code-quality.md

Enforces complete implementations only — no stubs, no TODOs, no "will implement later". Every function must work, every import must point to a real file, every function call must reference a real function.

Also requires: research before implementing, fix all instances of a bug (not just the reported one), and security checks (nonces, sanitisation, prepared statements).

CSS/HTML/PHP/JSX  visual-standards.md

WCAG 2.2 AA accessibility standards:

  • Normal text: 4.5:1 contrast minimum
  • Touch targets: 44x44px minimum
  • Mobile-first responsive (375px → 768px → 1280px)
  • Dark mode support with CSS custom properties
  • Never remove focus outlines without replacing them
  • Reduced motion support
PHP/WordPress  wordpress.md

WordPress coding standards:

  • Yoda conditions: if ( true === $var )
  • Always $wpdb->prepare() for database queries
  • Nonces for all forms, capability checks for actions
  • Sanitise all input, escape all output
  • Proper script/style enqueueing with version numbers
  • Multisite-aware table prefixes
  • block.json, theme.json v3, Interactivity API, REST API patterns, SGS naming conventions

How to add a new rule

Create a .md file in C:\Users\Bean\.claude\rules\. It's picked up automatically. Add paths: frontmatter if you only want it active for certain file types.

6

My Agents

What agents are

Specialised sub-processes Claude can spawn to handle specific tasks. They run independently, have their own tool access, and return results to Claude. Think of them as specialist contractors — Claude is the project manager, agents are the specialists.

There are two kinds: custom agents (ones you created, stored in ~/.claude/agents/) and plugin agents (come bundled with installed plugins, auto-delegated by Claude).

Custom Agents (My Own)

Auto  test-and-explain
ModelSonnet (smart, fast)
Can edit files?No — reads and runs tests only
When it's usedAfter any code change, Claude automatically delegates testing here
What it doesTests code, then explains results in plain English for a non-coder
Dev  wp-developer
ModelSonnet
Can edit files?Yes — full read/write/edit
When it's usedAny WordPress task (plugins, themes, ACF, multisite, REST API, Interactivity API, SGS Framework)
What it doesBuilds production-ready WordPress code following WP coding standards
Dev  n8n-builder
ModelSonnet
Can edit files?Yes
When it's usedBuilding or debugging n8n workflows
What it doesDesigns workflow logic, builds JSON configs, debugs executions
Audit  seo-auditor
ModelHaiku (fast, cheap)
Can edit files?No — report only
When it's usedBefore launching a site, or periodic SEO checks
What it doesAnalyses websites for SEO issues, content optimisation, and technical SEO problems
Security  ehr-security-reviewer
ModelSonnet
Can edit files?No — report only
When it's usedBefore any EHR deployment or after EHR code changes
What it doesHIPAA/GDPR compliance review: access controls, audit logging, encryption, data isolation
Audit  performance-auditor
ModelSonnet
Can edit files?No — report only
When it's usedAfter Next.js deployment or when checking performance
What it doesNext.js performance: Core Web Vitals, Lighthouse, bundle size, image optimisation

Plugin Agents (From Enabled Plugins)

Dev  code-architect — feature-dev

Designs feature architectures by analysing codebase patterns. Read-only — produces blueprints, not code.

Dev  code-explorer — feature-dev

Deep analysis of existing features — traces execution paths, maps architecture layers, documents dependencies. Read-only.

Audit  code-reviewer — feature-dev + superpowers

Reviews code for bugs, logic errors, security vulnerabilities, and adherence to coding standards. Two versions: feature-dev (read-only report) and superpowers (reviews against your plan, has all tools).

Dev  code-simplifier — code-simplifier

Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Can edit files.

Browser  browser-user — superpowers-chrome

Analyses web content using Chrome DevTools Protocol. Read-only — inspects DOM, analyses behaviour, reads cached content.

You don't need to invoke agents manually. Claude picks the right agent based on what you're asking. But if you want to be specific, say: "Use the wp-developer agent to build this plugin."

7

My Commands

What commands are

Custom slash commands stored as .md files in ~/.claude/commands/. When you type /command-name, Claude loads the prompt from that file. They're saved prompts — type the shortcut instead of explaining what you want every time.

CommandWhat It DoesWhen to Use
/morningDaily planning — pulls tasks, suggests priorities, reminds about physioStart of every work session
/brain-dumpStructures rambling thoughts into actions, ideas, decisions, worriesWhen you have ideas or worries to process
/linkedinCreates LinkedIn post in your voice with hook, story, takeaway, CTAWhen you have a story or insight to share
/deploy-check30+ point checklist: security, performance, SEO, accessibility, WP-specificBefore any WordPress site goes live
/deploy-nextjsPre-deployment checklist for Next.js/Vercel: build, lint, meta tags, critical filesBefore deploying to Vercel
/a11y-auditFull WCAG 2.2 AA accessibility audit on every page of a websiteBefore launching or after major UI changes
/handoffSession summary: completed, current state, blockers, next prioritiesEnd of every work session

How to add a new command

Create a .md file in C:\Users\Bean\.claude\commands\. The filename becomes the command name (e.g. review.md = /review).

8

My Skills

What skills are

Skills are like commands but come bundled with plugins. Invoked the same way — type /skill-name — but you don't manage the files yourself. Skills are more powerful than commands because they can include complex multi-step logic, tool orchestration, and specialised prompts.

Key difference: Commands = your own custom prompts. Skills = prompts that come with plugins.

Planning  Development & Planning Skills
SkillPluginWhat It Does
/brainstormingsuperpowersExplores requirements before building anything. Should be used before creative work
/writing-planssuperpowersCreates detailed implementation plans for multi-step tasks
/systematic-debuggingsuperpowersMethodical debugging — structured, not guesswork
/test-driven-developmentsuperpowersWrite tests before implementation code
/feature-devfeature-devGuided feature development with codebase understanding
/subagent-driven-developmentsuperpowersExecute plans using parallel agents
/dispatching-parallel-agentssuperpowersRun 2+ independent tasks in parallel
/executing-planssuperpowersExecute a written plan in a separate session with review checkpoints
Quality  Code Quality Skills
SkillPluginWhat It Does
/requesting-code-reviewsuperpowersGet code reviewed after finishing a feature
/receiving-code-reviewsuperpowersProcess review feedback before implementing suggestions
/verification-before-completionsuperpowersRun verification before claiming work is done
/finishing-a-development-branchsuperpowersGuide completion of dev work — integration options
Git  Git Skills
SkillPluginWhat It Does
/commitcommit-commandsCreate a git commit
/commit-push-prcommit-commandsFull commit + push + PR workflow
/clean_gonecommit-commandsClean up branches deleted on remote
/using-git-worktreessuperpowersCreate isolated git worktrees for feature work
Content  Writing & Content Skills
SkillPluginWhat It Does
/writing-clearly-and-conciselyelements-of-styleApply Strunk's rules to any prose — docs, commits, error messages
/frontend-designfrontend-designCreate distinctive, production-grade web interfaces
/playgroundplaygroundCreate interactive HTML playgrounds — visual configurators
Web  Web & Scraping Skills
SkillPluginWhat It Does
/firecrawl-clifirecrawlUnified web tool: scrape, search, crawl, map, extract. Replaces WebFetch/WebSearch
/browsingsuperpowers-chromeDirect browser control via Chrome DevTools Protocol
Media  Image & Media Skills
SkillPluginWhat It Does
/generatenano-banana-proGenerate images from text descriptions
Memory  Memory & Search Skills
SkillPluginWhat It Does
/search-conversationsepisodic-memorySearch past Claude Code conversations
/remembering-conversationsepisodic-memoryRecall past decisions, solutions, lessons when stuck
WordPress  WordPress Domain Skills

These activate automatically when working on WordPress files. You can also invoke them directly.

SkillWhat It Does
/wordpress-routerClassify a WP repo and route to correct workflow
/wp-block-developmentGutenberg block development (block.json, attributes, render.php)
/wp-block-themesBlock themes (theme.json, templates, patterns, style variations)
/wp-interactivity-apiInteractivity API (data-wp-* directives, store, state, actions)
/wp-performanceWordPress backend performance (profiling, queries, caching)
/wp-plugin-developmentPlugin architecture, hooks, admin UI, security, packaging
/wp-rest-apiREST API endpoints, controllers, schema, authentication
/wp-wpcli-and-opsWP-CLI operations, search-replace, db management, scripting
Design  Design & UI Skills
SkillWhat It Does
/tailwind-design-systemBuild scalable design systems with Tailwind CSS v4
/ui-ux-pro-max50 styles, 21 palettes, 50 font pairings, 20 chart types, 9 stacks
/vercel-react-best-practicesReact/Next.js performance optimisation from Vercel Engineering
Meta  Claude Code Development Skills

For building plugins, skills, agents, and other Claude Code extensions.

SkillPluginWhat It Does
/revise-claude-mdclaude-md-managementUpdate CLAUDE.md with learnings from the session
/claude-md-improverclaude-md-managementAudit and improve CLAUDE.md files
/claude-automation-recommenderclaude-code-setupAnalyse codebase and recommend automations
/working-with-claude-codesuperpowers-devComprehensive Claude Code documentation reference
/developing-claude-code-pluginssuperpowers-devPatterns and workflows for building Claude Code plugins
/using-superpowerssuperpowersHow to find and use superpowers skills
/writing-skillssuperpowersCreate, edit, or verify skills
/fix-vscode-bash-pathbean-tools (local)Fix Git Bash path error after VS Code extension updates
Disabled  Currently Disabled Skills

These skills exist but their parent plugins are disabled. Enable the plugin in settings.json to use them.

SkillsPluginWhy Disabled
Notion skills (create-page, create-task, search, tasks:build, etc. — 10 skills)NotionPlugin disabled
Plugin development skills (create-plugin, agent-development, etc. — 7 skills)plugin-devPlugin disabled
Hugging Face skills (CLI, datasets, training, etc. — 8 skills)huggingface-skillsPlugin disabled
Agent SDK skill (new-sdk-app)agent-sdk-devPlugin disabled
9

My Hooks

What hooks are

Shell commands that Claude fires automatically when certain events happen. Unlike skills (which you invoke manually), hooks run on their own — before or after tool calls, when a conversation stops, or when notifications arrive.

Think of it like this: Rules tell Claude what to think. Skills tell Claude what to do when asked. Hooks tell Claude what to run automatically at specific moments.

Active  Block .env edits
TypePreToolUse
MatcherWrite | Edit
File~/.claude/hooks/block-env.py
Timeout5 seconds
What it doesPrevents Claude from writing or editing any .env file. Exits with code 2 to block the operation. Manage secrets manually outside Claude Code.
Active  Auto-lint JS/TS
TypePostToolUse
MatcherWrite | Edit
File~/.claude/hooks/auto-lint.py
Timeout15 seconds
What it doesRuns npx eslint --fix on .ts, .tsx, .js, .jsx, .mjs files after every Write/Edit. Skips node_modules and .next.
Reference  Hook Types Explained
Hook TypeWhen It FiresExample Use Case
PreToolUseBefore Claude uses a tool (e.g. before editing a file)Block edits to protected files, require confirmation for destructive ops
PostToolUseAfter Claude uses a tool (e.g. after writing a file)Auto-format code after saving, run linting, log changes
StopWhen Claude finishes its responseAuto-run tests after every response, update a log
NotificationWhen Claude sends a notificationRoute notifications to Slack, email, or a dashboard
Ideas  Hooks Worth Adding
HookTypeWhat It Would Do
PHP syntax checkPostToolUse (Write|Edit)Run php -l after every PHP file edit — catches fatal errors instantly
Run tests on stopStopAuto-run test suite after Claude finishes a response

How to add a hook

Edit C:\Users\Bean\.claude\settings.json and modify the hooks key. Or enable the plugin-dev plugin and use the /hook-development skill for guided setup.

10

My Plugins

What plugins are

Bundles of skills, agents, hooks, and MCP servers that extend Claude Code's capabilities. Installed from marketplaces and managed in settings.json. Each plugin can contribute multiple skills and agents.

Enabled  Active Plugins (22 + 1 local)
PluginSourceWhat It Provides
superpowerssuperpowers-marketplace14 skills (brainstorming, debugging, planning, code review, TDD, etc.) + code-reviewer agent
commit-commandsclaude-plugins-official3 skills (commit, commit-push-pr, clean_gone)
episodic-memorysuperpowers-marketplace2 skills (search-conversations, remembering-conversations) + search agent
elements-of-stylesuperpowers-marketplace1 skill (writing-clearly-and-concisely)
superpowers-chromesuperpowers-marketplace1 skill (browsing) + browser-user agent
superpowers-developing-for-claude-codesuperpowers-marketplace2 skills (developing plugins, working with Claude Code)
frontend-designclaude-plugins-official1 skill (frontend-design)
nano-banana-probuildatscale-claude-code1 skill (generate images)
feature-devclaude-plugins-official1 skill (feature-dev) + 3 agents (code-architect, code-explorer, code-reviewer)
code-simplifierclaude-plugins-official1 agent (code-simplifier)
claude-md-managementclaude-plugins-official2 skills (revise-claude-md, claude-md-improver)
claude-code-setupclaude-plugins-official1 skill (claude-automation-recommender)
firecrawlclaude-plugins-officialUnified web tool: scrape, search, crawl, map, extract
playgroundclaude-plugins-official1 skill (interactive HTML playgrounds)
context7claude-plugins-officialMCP server for library documentation lookup
githubclaude-plugins-officialMCP server for GitHub operations (issues, PRs, code search)
playwrightclaude-plugins-officialBrowser automation tools (navigate, click, fill, screenshot)
supabaseclaude-plugins-officialSupabase integration tools
security-guidanceclaude-plugins-officialSecurity best practices guidance
learning-output-styleclaude-plugins-officialOutput style — learning mode with educational insights
php-lspclaude-plugins-officialPHP Language Server Protocol support
typescript-lspclaude-plugins-officialTypeScript Language Server Protocol support
bean-toolslocal1 skill (fix-vscode-bash-path)
Disabled  Disabled Plugins
PluginWhy Disabled
NotionPlugin disabled — Notion MCP still works via Claude Desktop
serenaSemantic code analysis — not currently needed
plugin-devPlugin development tools — enable when building plugins
agent-sdk-devAgent SDK development — enable when building SDK apps
huggingface-skillsML model tools — not currently needed
pyright-lspPython type checking — enable for Python projects
circlebackNot currently needed
linearNot using Linear for project management
double-shot-latteNot currently needed
superpowers (official)Using superpowers-marketplace version instead
explanatory-output-styleReplaced by learning-output-style
gopls, csharp, rust-analyzer, jdtls, clangd, swift, kotlin, lua LSPsLanguage servers for languages you don't use

Managing plugins

Enable/disable: Edit enabledPlugins in C:\Users\Bean\.claude\settings.json — set to true or false.

Performance tip: Each enabled plugin adds to context. Disable plugins you're not using to keep Claude faster.

11

MCP Servers (Data Connections)

What MCP servers are

MCP (Model Context Protocol) servers connect Claude to external services — your Todoist, Notion, GitHub, etc. They run in the background and give Claude tools to interact with those services. You don't invoke them directly; Claude uses them when relevant.

Important: Claude Desktop and Claude Code have SEPARATE MCP servers. They don't share configs. A server running in Claude Desktop is NOT automatically available in Claude Code, and vice versa.

Claude Code MCP Servers

Available when working in Claude Code (VS Code).

Plugin  From Plugins (always available when plugin is enabled)
MCP ServerPluginWhat It Connects ToExample Prompt
Context7context7Library documentation"Get WordPress REST API docs from context7"
GitHubgithubYour GitHub repos"List open PRs on my repo"
PlaywrightplaywrightBrowser automation"Navigate to this URL and take a screenshot"
SupabasesupabaseSupabase databases"Show my Supabase tables"
FirecrawlfirecrawlWeb scraping service"Scrape this URL and summarise"
Episodic Memoryepisodic-memoryPast conversation history"What did I decide about the EHR auth system?"
Global  From Global Config (~/.claude/.mcp.json)
MCP ServerWhat It Connects ToExample Prompt
a11y-accessibilityWCAG 2.2 accessibility audits via axe-core"Test this page for accessibility"
Remote  From claude.ai (synced to Claude Code)
MCP ServerWhat It Connects ToExample Prompt
ICD-10 CodesMedical coding database (2026 code sets)"Look up ICD-10 code for diabetes type 2"
Project  From Project-Level .mcp.json
ProjectServers
booking-systemcontext7 (redundant with plugin), a11y-accessibility (now global)
small-giants-studioa11y (uses a11y-mcp — different package from global a11y-mcp-server)

Claude Desktop MCP Servers

Available in the Claude Desktop app only. Config: C:\Users\Bean\AppData\Roaming\Claude\claude_desktop_config.json

Active  Claude Desktop Servers (14)
MCP ServerWhat It Connects ToStatus
TodoistYour Todoist account — tasks, projects, labelsRunning
Notion APIYour Notion workspace — pages, databases, commentsRunning
MemoryPersistent knowledge graph — store/recall factsRunning
GitHubYour GitHub repos (separate from Claude Code plugin)Running
n8nYour n8n instance at n8n.smallgiantsstudio.cloudRunning
FilesystemLocal files (Desktop, Downloads, .claude, Pictures, Documents, AppData)Running
FetchHTTP requests (Python mcp_server_fetch)Running
Sequential ThinkingStep-by-step reasoning for complex problemsRunning
Chrome DevToolsBrowser control via Chrome DevTools ProtocolRunning
PlaywrightBrowser automation (separate from Claude Code plugin)Running
QuranQuran text lookup (custom local MCP)Running
AladhanPrayer times API (Python aladhan_mcp.server)Running
CloudflareCloudflare account managementRunning
WordPressWordPress site management via claudeus-wp-mcpNot yet configured
DXT  DXT Extensions (managed by Claude Desktop)
ExtensionWhat It Does
Windows-MCPWindows system operations
Vibe ProspectingProspecting tools (Explorium AI)
Context7Library documentation (separate from Claude Code plugin)

Installed but not active: gdrive, gcal, gmail, mcp-registry, Claude in Chrome

12

My Project Memory

What project memory is

Claude Code maintains persistent memory files per project. Each MEMORY.md stores patterns, decisions, and context that persist across conversations. Claude reads these automatically when you work in that project directory.

Memory File Locations
ProjectPath
Global (home dir)~\.claude\projects\C--Users-Bean\memory\MEMORY.md
This project (.claude)~\.claude\projects\c--Users-Bean--claude\memory\MEMORY.md
Booking System~\.claude\projects\c--Users-Bean-Projects-booking-system\memory\MEMORY.md
Indus Foods / SGS Framework~\.claude\projects\c--Users-Bean-Projects-indus-foods\memory\MEMORY.md
Small Giants Studio~\.claude\projects\c--Users-Bean-Projects-small-giants-studio\memory\MEMORY.md
Small Giants WP~\.claude\projects\c--Users-Bean-Projects-small-giants-wp\memory\MEMORY.md
Session Planning Files
FileWhat It Is
~/.claude/NEXT-SESSION-PROMPT.mdMaster prompt template for starting new sessions
~/.claude/FUTURE-SESSION-PROMPTS.md5 ready-to-paste prompts for upcoming tasks
13

Troubleshooting

Claude isn't following my rules

Check ~/.claude/rules/ — files must end in .md. Run /revise-claude-md to audit.

An agent isn't loading

Check ~/.claude/agents/ — file must have valid YAML frontmatter (name, description, tools, model between --- lines).

A command isn't showing up

Check ~/.claude/commands/ — file must be .md. Restart Claude Code if just created.

A skill isn't working

Check the parent plugin is enabled in settings.json under enabledPlugins. Must be true.

I forgot what tools I have

Open this guide, or type "what tools do I have?" and Claude will list them.

MCP server not connecting

Check config file for the right platform (Claude Desktop: claude_desktop_config.json, Claude Code: .mcp.json or plugin).

Plugin not working

Check settings.json enabledPlugins — must be true.

Hook not firing

Check settings.json hooks section. Matcher must match tool name. Check Python is on PATH. Check timeout isn't too short.

.env edit got blocked

That's the block-env.py hook working correctly. Manage secrets manually outside Claude Code.

ESLint auto-fix not running

The auto-lint hook only runs on .ts/.tsx/.js/.jsx/.mjs files. Check project has eslint config.

I need to add a new project

Create a CLAUDE.md file in the project root with project-specific instructions. Claude reads it automatically.

Claude is being too slow

Large plugins/MCPs use context. Disable unused plugins in settings.json. Use Haiku agents for simple tasks.

Claude forgot what we discussed

Use /search-conversations to find past discussions. Or check ~/.claude/projects/*/memory/MEMORY.md.

I want to restart fresh

Start a new conversation. CLAUDE.md and rules persist. Use /handoff first to save progress.

VS Code bash path error after update

Type /fix-vscode-bash-path.

Plugin cache growing large

The ~/.claude/plugins/cache/ directory accumulates temp files. Safe to delete temp_git_* folders.

Notion skills not working

The Notion plugin is currently disabled. Enable it in settings.json or use Notion MCP via Claude Desktop instead.

14

Reference

Concepts Quick Reference

ConceptWhat It IsWhere It LivesHow to Use It
RulePermanent instruction, always active~/.claude/rules/*.mdAutomatic — Claude reads them every conversation
CommandCustom slash command (your own)~/.claude/commands/*.mdType /command-name
SkillSlash command from a pluginInside plugin bundlesType /skill-name
AgentSpecialist sub-process~/.claude/agents/*.md or pluginsClaude delegates automatically, or you say "use the X agent"
HookAuto-firing shell commandsettings.json under hooksFires automatically on matching events
PluginBundle of skills + agents + hooksInstalled via marketplaceEnable/disable in settings.json
MCP ServerConnection to external servicesettings.json, .mcp.json, or pluginClaude uses them when relevant
CLAUDE.mdProject-specific instructionsProject root directoryClaude reads it when you work in that directory
MEMORY.mdPersistent per-project memory~/.claude/projects/*/memory/Claude reads/writes automatically

File Locations Quick Reference

WhatWhere
Global instructionsC:\Users\Bean\.claude\CLAUDE.md
Rules (always active)C:\Users\Bean\.claude\rules\
AgentsC:\Users\Bean\.claude\agents\
CommandsC:\Users\Bean\.claude\commands\
HooksC:\Users\Bean\.claude\hooks\
Claude Code settingsC:\Users\Bean\.claude\settings.json
Claude Code global MCPC:\Users\Bean\.claude\.mcp.json
Installed pluginsC:\Users\Bean\.claude\plugins\installed_plugins.json
Local pluginsC:\Users\Bean\.claude\plugins\local\
Project memoryC:\Users\Bean\.claude\projects\*\memory\MEMORY.md
Session planningC:\Users\Bean\.claude\NEXT-SESSION-PROMPT.md
Future promptsC:\Users\Bean\.claude\FUTURE-SESSION-PROMPTS.md
Claude Desktop configC:\Users\Bean\AppData\Roaming\Claude\claude_desktop_config.json
SSH configC:\Users\Bean\.ssh\config
This guide (markdown)C:\Users\Bean\.claude\MY-SETUP-GUIDE.md
This guide (HTML)C:\Users\Bean\.claude\setup-guide.html