Feedback

2. Check dependencies by running:

   python {framework_path}/skills/feedback/scripts/check_dependencies.py
   

   If dependencies are missing, prompt the user to install them before continuing.

3. Verify required files exist:

   • assignment.md (required)
   • rubric.md (required)
   • submissions/ folder with at least one file (required)

   If any are missing, tell the user what's needed and stop.

4. Extract text from submissions:

   python {framework_path}/skills/feedback/scripts/extract_submission_text.py --input submissions --out feedback_extracted
   

5. Render Excel charts (if any .xlsx files exist):

   python {framework_path}/skills/feedback/scripts/render_xlsx_quicklook.py --input submissions --out feedback_rendered
   

6. Read the framework instructions from {framework_path}/skills/feedback/SKILL.md

7. Read reference materials:

   • assignment.md
   • rubric.md
   • {framework_path}/skills/feedback/references/economical_writing_principles.md
   • course_concepts.md (if present)

8. Enumerate submissions by parsing filenames. Group by username.

9. Read parallelism setting from wmf-config.yaml: review.max_parallel_agents (default: 3)

10. Process submissions in parallel batches:

    • For each batch of N submissions (where N = max_parallel_agents):
      • Spawn N Task agents in a single message with subagent_type: "general-purpose"
      • Each agent follows the isolated review workflow from the framework SKILL.md
      • Wait for all N to complete before starting the next batch
    • Each agent writes to feedback/{username}.md

11. Report completion with summary of submissions reviewed.

    </workflow>

Parallelism Settings

Configure review.max_parallel_agents in wmf-config.yaml:

Multi-Round Reviews

If submissions are organized in rounds (submissions/round1/, submissions/round2/):

1. Check wmf-config.yaml for submissions.rounds.enabled: true
2. Use round-specific folders: feedback_extracted_round{N}/, feedback_round{N}/
3. For resubmissions, compare to prior round feedback per config setting

Output

Feedback files are written to feedback/ (or feedback_round{N}/ for rounds).

Each file contains:

• Section A: Reviewer Notes - Technical audit for instructor only
• Section B: Writer Feedback - Teaching-focused guidance to share with writer