107 lines
3.2 KiB
Markdown
107 lines
3.2 KiB
Markdown
---
|
|
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
|
|
- **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
|
|
- **chassis, actuator, drive** → Mechanical Level 1
|
|
- **advanced mechanisms** → Mechanical Level 2
|
|
|
|
### If working on pneumatic tasks → Pneumatics Level 1 or 2
|
|
- **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
|
|
- **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 |