Summary
Recover prior 15-lesson corpus and connect it to Reporter recommendations
5Questions
0Links
0Comments
0PRs
Open questions
- 1 Where do the existing lesson files live?
- 2 Who reviews lesson quality: Brian, Kevin, Bryant, or a teacher reviewer?
- 3 Are lessons whole-class, small-group, individual, or all three?
- 4 Should lessons create assignments in Yawp or remain teacher-facing materials first?
- 5 What metadata is needed for Reporter to recommend a lesson reliably?
Spec body
# Writing lessons revival
Recover the prior writing-lessons work and turn it into a teacher-facing library that can later connect to Yawp Reporter recommendations.
## Source
Granola meeting: `3fbd5f2d-e409-42bd-b585-fed305edd5cd`, **Summer priorities — assignment types, LMS integration, and reporter**, 2026-05-26 1:31 PM CDT.
The meeting referenced roughly 15 previously built lessons with AI-generated variations, voice, and instructional design already developed. Reporter should eventually be able to recommend these lessons when it sees class/student writing patterns.
## Problem
Reporter becomes much more useful if it can answer "what should I teach next?" instead of only reporting "what happened." Yawp may already have a lesson corpus that can become that action layer, but it needs to be found, reviewed, normalized, and made usable.
## Goals
- Locate the existing writing lesson materials.
- Inventory lesson titles, target skills, grade range, assignment type fit, and readiness.
- Preserve the voice/instructional design that already works.
- Create a teacher-only library first.
- Later connect lessons to Reporter findings and assignment-type practice.
## Non-goals
- Auto-assigning lessons to students in v1.
- Claiming lesson recommendations are proven before teacher review.
- Rebuilding the lesson corpus from scratch before checking what already exists.
## UX sketch
Teacher lesson library:
```text
Writing Lessons
Filters: skill | assignment type | grade level | duration
Evidence Integration
Use when: students quote evidence but do not explain it.
Assignment fit: thesis essay, DBQ, LEQ
[Preview] [Assign later]
```
Reporter recommendation later:
```text
Class report finding
Common pattern: evidence is dropped into paragraphs without analysis.
Suggested lesson: Evidence Integration
[Open lesson] [Assign to selected students]
```
## Open questions
- [ ] Where do the existing lesson files live?
- [ ] Who reviews lesson quality: Brian, Kevin, Bryant, or a teacher reviewer?
- [ ] Are lessons whole-class, small-group, individual, or all three?
- [ ] Should lessons create assignments in Yawp or remain teacher-facing materials first?
- [ ] What metadata is needed for Reporter to recommend a lesson reliably?
## Test plan
- Inventory/checklist: all recovered lessons have title, skill tags, target audience, and body content.
- E2E later: teacher opens lesson library and filters by skill.
- E2E later: Reporter links a finding to a lesson without assigning it automatically.
## Engineering handoff checklist
- [ ] Domain context covered
- [ ] File paths in `yawp-2.0` listed
- [ ] Data model implications spelled out, including backward-compat plan
- [ ] UX sketch in prose
- [ ] Edge cases enumerated
- [ ] Test plan written
- [ ] Rollout plan decidedRepo sync
No repo sync metadata recorded yet.