TEACHING_ROADMAP_IMPLEMENTATION.md

Teaching Roadmap Implementation Log

Goal

Evolve the roadmap feature into a teaching-oriented learning path for beginners.

Plan

1. Backend Updates

   • Update TimelineStage model in app/models/roadmap.py (added prerequisites, checkpoints).
   • Update GeminiRoadmapGenerator in app/services/ai/gemini.py.
     • Implement multi-step pipeline (Plan -> Expand).
     • Implement time-based commit clustering.
     • Update prompts for teaching focus.
   • Linting & Formatting.

2. Frontend Updates

   • Update types in commitly-frontend.
   • Update UI components to render goals, structured tasks, code examples, etc.

Progress

• Backend models updated.
• Gemini service refactored with multi-step pipeline.
• Linting checks.