claude-code-ultimate-guide/examples/modes/README.md
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

76 lines
2.2 KiB
Markdown

# 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](./MODE_Learning.md) | Just-in-time explanations when techniques are first used |
## Installation
### 1. Copy the mode file
```bash
cp MODE_Learning.md ~/.claude/
```
### 2. Reference in your CLAUDE.md
Add to `~/.claude/CLAUDE.md`:
```markdown
# Behavioral Modes
@MODE_Learning.md
```
### 3. Add flags (optional)
Add to `~/.claude/FLAGS.md` for flag-based activation:
```markdown
**--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
```bash
# 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](https://github.com/SuperClaude-Org/SuperClaude_Framework):
| 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
- [Guide Section 10.5: SuperClaude Framework](../../guide/ultimate-guide.md#105-superclaude-framework) — Full documentation
- [SuperClaude Repository](https://github.com/SuperClaude-Org/SuperClaude_Framework) — Complete framework