claude-code-ultimate-guide/examples/modes
Florian BRUNIAUX bc07651cdf refactor: restructure repo into thematic directories v3.1.0
Major repository reorganization for improved navigation:

New directory structure:
- guide/ - Core documentation (ultimate-guide, cheatsheet, adoption)
- tools/ - Interactive utilities (audit, onboarding, mobile-access)
- machine-readable/ - LLM/AI consumption (reference.yaml, llms.txt)
- exports/ - Generated outputs (PDFs)

Changes:
- Move 10 files to thematic directories with cleaner names
- Create README.md index for each new directory
- Update 150+ internal links across all documentation
- Add "Repository Structure" section to main README
- Remove redundant npm install command from README header
- Remove unverified cost estimate from prerequisites
- Fix broken anchor link (#-quick-start-15-minutes)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 15:30:02 +01:00
..
MODE_Learning.md feat(examples): add Learning Mode template with SuperClaude reference 2026-01-12 13:38:02 +01:00
README.md refactor: restructure repo into thematic directories v3.1.0 2026-01-13 15:30:02 +01:00

Behavioral Modes

Ready-to-use behavioral mode files for Claude Code. Copy to ~/.claude/ and reference in your CLAUDE.md.

Available Modes

Mode File Purpose
Learning MODE_Learning.md Just-in-time explanations when techniques are first used

Installation

1. Copy the mode file

cp MODE_Learning.md ~/.claude/

2. Reference in your CLAUDE.md

Add to ~/.claude/CLAUDE.md:

# Behavioral Modes
@MODE_Learning.md

3. Add flags (optional)

Add to ~/.claude/FLAGS.md for flag-based activation:

**--learn**
- Trigger: User requests learning mode, "why/how" questions
- Behavior: Enable just-in-time explanations with first-occurrence tracking

**--no-learn**
- Trigger: User wants pure execution without educational offers
- Behavior: Suppress all learning mode offers

Usage

# Activate for entire session
claude --learn

# Focus on specific domain
claude --learn focus:git
claude --learn focus:architecture

# Batch explanations at task end
claude --learn batch

More Modes: SuperClaude Framework

This guide includes only Learning Mode. For a complete behavioral framework with additional modes, check out SuperClaude:

Mode Purpose
Orchestration Smart tool selection, parallel execution optimization
Task Management Hierarchical task tracking with persistent memory
Token Efficiency Symbol-enhanced compression (30-50% token reduction)
Learning Just-in-time skill development (included here)

SuperClaude also includes:

  • FLAGS.md — Behavioral flags (--think, --ultrathink, --delegate, etc.)
  • PRINCIPLES.md — Engineering principles (SOLID, DRY, evidence-based)
  • RULES.md — Actionable rules with priority system
  • MCP server documentation (Context7, Sequential, Serena)

See Also