Skip to content

REFLECTION-WIDGET-GUIDE.md

Latest commit

 

History

History
155 lines (110 loc) · 5.48 KB

REFLECTION-WIDGET-GUIDE.md

File metadata and controls

155 lines (110 loc) · 5.48 KB

Reflection Widget - User Guide

The Reflection Widget lets you chat with AI mentors to reflect on and analyze your Music Blocks project. Using this tool, you can learn quickly and improve your coding and music skills.

Table of Contents

  1. Getting Started
  2. Meet Your AI Mentors
  3. Sending Messages
  4. Widget Features
  5. Understanding the Analysis Report
  6. Keyboard Shortcuts
  7. Troubleshooting
  8. Tips for Best Results

Getting Started

  1. Open the Reflection Widget
  • You will find the reflection block in the widget palette (available in both beginner and advanced modes).
  • Drag it to your workspace and click it to open the widget.
  • The widget will automatically read your current project code before starting the conversation.
  1. Choose Your Mentor
  • When the widget opens, you will see three mentor icons at the top.
  • Click on the mentor icon that matches what kind of help you need.
  • You can switch mentors at any time during the conversation.
  1. Start the Conversation
  • Your mentor will first read your project and share their initial thoughts.
  • They may ask if their understanding of your project is correct.
  • Confirm or correct their understanding to begin the reflection.

Meet Your AI Mentors

There are three AI mentors in the widget, each with a different focus:

  • Rohan (Meta) — General project reflection. Rohan is an expert at helping you think about your project as a whole. He will discuss your goals, challenges, and overall learning journey.

  • Beethoven (Music) — Music-specific advice. The famous composer Ludwig van Beethoven is here to help you improve your music compositions, theory knowledge, and creative choices.

  • Alan (Code) — Coding help. Alan Kay, a pioneer in computer science, will assist you with coding concepts, code structure, and programming logic. He asks critical questions to deepen your technical thinking.

Tip: Start with Rohan if you are unsure where to begin. He will help you identify which area needs the most attention and can guide you toward Beethoven or Alan.

Sending Messages

  • Press Enter or click Send to send your message.
  • Your mentor will respond with reflective questions or feedback.
  • Provide detailed responses to receive better, more personalized feedback.
  • The AI mentors will ask reflective questions to help you think more deeply about your work.
  • When the conversation feels complete, you can ask your mentor to generate an analysis report.

Widget Features

Feature How to Access Description
Summary / Report Click the notes icon View or generate an analysis report (available after 10+ messages)
Change Mentor Click mentor icons at top Switch between Rohan, Beethoven, and Alan at any time
Save Conversation Click the save icon Download your full chat as a .txt file
Refresh Project Click the refresh icon Update the widget with your latest project code after making changes

Understanding the Analysis Report

After 10 or more messages, you can generate an analysis report by clicking the notes icon. The report includes:

  • Learning Outcomes — What you have learned during this session
  • Areas for Improvement — Specific aspects of your project that could be improved
  • Next Steps — Concrete actions you can take to move forward
  • Conversation Summary — A brief overview of your discussion

Note: The report is cumulative. Each new report builds on previous reports and conversations, giving you a long-term view of your progress over time.

Keyboard Shortcuts

Key Action
Enter Send message
Shift + Enter Add a new line without sending

Troubleshooting

The mentor seems to misunderstand my project.

  • Click the refresh icon to reload your latest project code.
  • Try rephrasing your description and give more context about what your project is supposed to do.

The widget is not responding.

  • Check your internet connection, as the widget requires an active connection to communicate with AI mentors.
  • Try refreshing your browser and reopening the widget.

I cannot find the Reflection block in the palette.

  • Make sure you are in advanced mode. Switch to advanced mode from the settings menu if needed.

Tips for Best Results

  • Have a long, detailed conversation. The more you share, the better the feedback you receive.
  • Let your mentors lead the questions — answer them thoughtfully rather than trying to guide the conversation yourself.
  • Use the Refresh Project button whenever you make changes to your project so your mentor always has the latest code.
  • Save your conversation regularly using the save icon so you have a record of your reflections.
  • Review your analysis reports over multiple sessions to track your growth and improvement over time.

Enjoy reflecting and improving your projects with the help of AI mentors!