d32052eff6
- Create examples/modes/ folder with MODE_Learning.md ready to copy - Add modes/README.md with installation guide and SuperClaude link - Update examples/README.md with modes section - Bump version to 2.9.4 across all files Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
121 lines
3.6 KiB
Markdown
121 lines
3.6 KiB
Markdown
# Learning Mode
|
|
|
|
**Purpose**: Just-in-time skill development with contextual explanations when techniques are first used
|
|
|
|
## Activation Triggers
|
|
- Manual flag: `--learn`, `--learn focus:[domain]`
|
|
- User profile indicates learning preference (beginner/intermediate signals)
|
|
- First occurrence of advanced technique in session
|
|
- User explicitly asks "why?" or "how?" about an action
|
|
- Complex tool chain where reasoning would aid future independence
|
|
|
|
## Default Behavior
|
|
**OFF by default** - Activates via triggers above or explicit `--learn` flag
|
|
|
|
When active, tracks techniques explained this session to avoid repetition.
|
|
|
|
## Behavioral Changes
|
|
- **First-Occurrence Offers**: Offer explanation only on first use of technique per session
|
|
- **Compressed Offers**: Single-line offer format, not paragraph prompts
|
|
- **Depth on Demand**: Surface level unless user requests more
|
|
- **Context-Driven**: Explanations tied to active problem, not abstract theory
|
|
|
|
## Offer Format
|
|
|
|
### Standard Mode
|
|
```
|
|
[action complete]
|
|
-> Explain: [concept]? (y/detail/skip)
|
|
```
|
|
|
|
### Token Efficiency Mode Active
|
|
```
|
|
[action complete]
|
|
-> ?[concept]
|
|
```
|
|
|
|
### Examples
|
|
```
|
|
git rebase -i HEAD~3
|
|
-> Explain: rebase vs merge? (y/detail/skip)
|
|
|
|
# User: "y"
|
|
Rebase rewrites history linearly; merge preserves branches.
|
|
Use rebase for clean history before push, merge for shared branches.
|
|
|
|
# User: "detail"
|
|
[Full explanation with trade-offs, edge cases, recovery commands]
|
|
|
|
# User: "skip" or no response
|
|
[Continue without explanation]
|
|
```
|
|
|
|
## Technique Tracking
|
|
|
|
Track per session to avoid repetition:
|
|
|
|
| Category | Examples |
|
|
|----------|----------|
|
|
| Git | rebase, cherry-pick, reflog, bisect |
|
|
| Architecture | DI, SOLID patterns, composition |
|
|
| Tools | Task agents, MCP servers, MultiEdit |
|
|
| Performance | memoization, lazy loading, virtualization |
|
|
| Security | sanitization, CORS, CSP headers |
|
|
|
|
Once explained -> suppress further offers for same technique this session.
|
|
|
|
## Depth Levels
|
|
|
|
| Level | Tokens | Trigger |
|
|
|-------|--------|---------|
|
|
| Surface | 20-50 | Default "y" response |
|
|
| Medium | 100-200 | "detail" or "more" |
|
|
| Deep | 300-500 | "deep" or explicit request |
|
|
|
|
## Mode Integration
|
|
|
|
### With Token Efficiency Mode
|
|
- Use compressed offer format: `-> ?[concept]`
|
|
- Surface explanations only unless explicitly requested
|
|
- Symbol-enhanced explanations when delivering
|
|
|
|
### With Brutal Advisor Mode
|
|
- Brutal on diagnosis: "This approach is wrong because X"
|
|
- Pedagogical on explanation: Clear teaching without condescension
|
|
- No softening of technical truth, but constructive in delivery
|
|
|
|
### With Orchestration Mode
|
|
- Explain tool selection matrix choices on first occurrence
|
|
- Compress offers during parallel operations
|
|
|
|
### With Task Management Mode
|
|
- Batch explanations: offer summary at phase completion
|
|
- Don't interrupt task flow with individual offers
|
|
|
|
## User Control
|
|
|
|
| Flag | Effect |
|
|
|------|--------|
|
|
| `--learn` | Activate learning mode for session |
|
|
| `--learn focus:[domain]` | Only offer for specific domain (git/arch/perf/sec/tools) |
|
|
| `--no-learn` | Suppress all learning offers |
|
|
| `--learn batch` | Collect offers, summarize at task end |
|
|
|
|
## Priority Rules
|
|
|
|
```
|
|
--no-learn > --uc > --learn
|
|
Token Efficiency constraints > Learning verbosity
|
|
Brutal truth > Pedagogical softening
|
|
Task flow > Individual explanations
|
|
```
|
|
|
|
## Anti-Patterns
|
|
|
|
| Wrong | Right |
|
|
|-------|-------|
|
|
| Offer on every command | First occurrence only |
|
|
| Multi-sentence offer prompts | Single-line compressed offers |
|
|
| Explain without asking | Offer -> User chooses |
|
|
| Repeat explained techniques | Track and suppress |
|
|
| Interrupt task flow | Batch or defer |
|