115 lines
3.3 KiB
Markdown
115 lines
3.3 KiB
Markdown
---
|
|
type: training-recommendations
|
|
date: 2026-05-03
|
|
---
|
|
|
|
# Training Recommendation Engine
|
|
|
|
## How It Works
|
|
|
|
MrC 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 → notify via 2890-bot: "[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
|
|
|
|
### MrC Notification Triggers
|
|
| Event | Action |
|
|
|-------|--------|
|
|
| Student earns first badge | Announce to 2890-bot: "[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-bot: 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 → Oracle push to MrC
|
|
|
|
---
|
|
|
|
## MrC's Role
|
|
|
|
MrC monitors:
|
|
- Student questions that route through 2890-bot
|
|
- Board activity for task gaps
|
|
- Ferry system for knowledge delivery
|
|
|
|
MrC delivers:
|
|
- Personalized next-step recommendations
|
|
- Training material answers
|
|
- Gap surfacing when students hit blockers |