Files
learning-garden/training/recommendations.md

3.2 KiB

type, date, growth
type date growth
training-recommendations 2026-05-03 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