homework

name: homework description: "This skill should be used when the user types /homework, /homework check, /homework done, /homework submit, or says 'what's my homework', 'show my assignment', 'I finished my homework', or 'mark homework complete'. Manages the active homework assignment in learning/homework/active.md." version: 1.0.0

/homework — Homework Management

You manage the student's active homework assignment. Route to the correct sub-command based on what the user typed.

Command Routing

/homework or "what's my homework" or "show my assignment"

→ Run the Display workflow

/homework check or "check my homework" or "give me feedback"

→ Run the Check workflow

/homework done or /homework submit or "I finished my homework" or "mark homework complete"

→ Run the Submit workflow

Display Workflow

1. Read learning/homework/active.md
2. If the file contains the placeholder "No active homework" or is empty:
   • Respond: "You don't have any active homework right now! Complete your next lesson with /learn to unlock assignments."
3. Otherwise, display the full homework assignment in a nicely formatted way
4. End with: "When you're done, use /homework submit to mark it complete, or /homework check for feedback on your work."

Check Workflow

1. Read learning/homework/active.md to get the requirements
2. Say: "Great! Show me what you've built or describe what you did. I'll give you feedback on each requirement."
3. Wait for student's response
4. For each requirement in the homework:
   • Evaluate whether the student's work meets it
   • Give specific, constructive feedback
   • Use ✅ for met requirements, ⚠️ for partially met, ❌ for not yet met
5. Summary feedback with encouragement
6. Do NOT mark homework as complete — only /homework submit does that
7. End with: "Once you're happy with your work, use /homework submit to complete this assignment!"

Submit Workflow

1. Read learning/homework/active.md
2. If no active homework, respond: "No active homework to submit! Use /learn to continue your curriculum."
3. Confirm with the student: "Are you ready to mark this homework as complete? Reply 'yes' to confirm."
4. Wait for confirmation
5. On confirmation: a. Read learning/progress/current-state.md to get current phase number and date b. Archive the homework: copy content to learning/homework/completed/phase-{N}-homework-{YYYY-MM-DD}.md c. Add a header to the archived file: # Phase {N} Homework — Completed {date} d. Clear learning/homework/active.md — replace content with:

   # Active Homework
   
   No active homework at the moment. Complete a phase to unlock your next assignment!
   

   e. Celebrate! "Amazing work completing Phase {N} homework! You're making real progress." f. Tell them what comes next: "Keep going with /learn to continue your journey!"

Reference

See references/homework-format.md for the active.md format and archive naming conventions.