learning-garden/training/recommendations.md

---
type: training-recommendations
date: 2026-05-03
growth: sprout
---

# Training Recommendation Engine

## How It Works

2890-claw generates recommendations based on:
1. What the student is currently working on (from board/asks)
2. What level they're at in each track
3. What gaps their tasks imply

---

## Recommendation Logic

### If working on electrical tasks → Electrical Level 1 or 2
| Task tag | Recommended level |
|----------|------------------|
| battery, wiring, PDB, breaker | Electrical Level 1 |
| board build, PCM, CAN, PWM, crimping | Electrical Level 2 |
| troubleshooting, diagnosis | Electrical Level 3 |

### If working on mechanical tasks → Mechanical Level 1 or 2
| Task tag | Recommended level |
|----------|------------------|
| chassis, actuator, drive | Mechanical Level 1 |
| advanced mechanisms | Mechanical Level 2 |

### If working on pneumatic tasks → Pneumatics Level 1 or 2
| Task tag | Recommended level |
|----------|------------------|
| compressor, tank, solenoid, cylinder | Pneumatics Level 1 |
| system design | Pneumatics Level 2 |

---

## Level Completion Criteria

### Electrical Level 1
- [ ] Can identify Battery, PDB, Main Breaker, PCM, Radio, Motor Controllers
- [ ] Understands wire gauge (AWG 6 = thick, AWG 14 = thin)
- [ ] Understands complete circuit = positive + negative wire
- [ ] Passed Electrical Level 1 test

### Electrical Level 2
- [ ] Can build a complete board with PCM
- [ ] Understands CAN vs PWM signaling
- [ ] Demonstrated crimping skills
- [ ] Demonstrated soldering skills
- [ ] Passed Electrical Level 2 test

### Mechanical Level 1
- [ ] Understands chassis fundamentals
- [ ] Can identify actuators
- [ ] Passed Mechanical Level 1 test

### Pneumatics Level 1
- [ ] Can identify all pneumatic components
- [ ] Understands how air pressure works in the system
- [ ] Passed Pneumatics Level 1 test

---

## Completions and Notifications

### When a Student Says "I Finished X"
1. Log the completion in their profile (Completions Log table)
2. If it matches a training level → update their level status
3. If it completes a badge requirement → announce: "[Name] earned the [Badge Name] badge!"
4. Recommend the next logical step

### When a Student Mentions a Badge
1. Add to Achievements Earned table in their profile
2. Include date and any notes

### 2890-claw Notification Triggers
| Event | Action |
|-------|--------|
| Student earns first badge | Announce: "[Name] just earned [Badge]!" |
| Student completes a level | Announce: "[Name] is now Level [N] in [Track]!" |
| Student stuck on related task | Surface gap: "[Name] working on [task] but hasn't started [recommended level]" |

## For 2890-claw: How to Route Questions

When a student asks "what should I work on?":

1. Check their profile in `/entities/students/[name].md`
2. Look at their current task tags
3. Match tags to recommended level above
4. Tell them the next logical step

When a student asks a question they don't know:

1. Check if the answer is in the training slides
2. If yes → give the answer + "you're ready for Level X"
3. If no → gap-fill inline and create wiki content for it

---

## 2890-claw's Role

2890-claw monitors:
- Student questions that come through Discord
- Board activity for task gaps
- Ferry system for knowledge delivery

2890-claw delivers:
- Personalized next-step recommendations
- Training material answers
- Gap surfacing when students hit blockers
- Auto-builds missing wiki modules when gaps are detected