Central Station / YPM-FEATURE-WRITING-LESSONS-REVIVAL

Writing lessons revival

features/writing-lessons-revival.md · Updated 2026-05-26
GET /api/tickets/YPM-FEATURE-WRITING-LESSONS-REVIVAL

Summary

Recover prior 15-lesson corpus and connect it to Reporter recommendations

5Questions 0Links 0Comments 0PRs
Open questions 5 items
  1. 1 Where do the existing lesson files live?
  2. 2 Who reviews lesson quality: Brian, Kevin, Bryant, or a teacher reviewer?
  3. 3 Are lessons whole-class, small-group, individual, or all three?
  4. 4 Should lessons create assignments in Yawp or remain teacher-facing materials first?
  5. 5 What metadata is needed for Reporter to recommend a lesson reliably?
Spec body Markdown
# 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 decided
Repo sync Not recorded

No repo sync metadata recorded yet.