Study Guide

Generate study materials for reviewing and testing comprehension of source content.

Workflow

Study guide progress:
- [ ] Step 1: Gather sources
- [ ] Step 2: Analyze content and identify key concepts
- [ ] Step 3: Generate study guide
- [ ] Step 4: Validate quality

Step 1: Gather sources

Read files, fetch URLs, or accept pasted text. Ask the user for sources if none are provided. Read every source completely before writing anything.

Step 2: Analyze content and identify key concepts

• Identify core concepts, arguments, and frameworks in the sources.
• Track specialized terminology and definitions used by the sources.
• Note relationships between concepts (causes, comparisons, dependencies).
• Flag areas where sources provide different perspectives on the same topic.

Step 3: Generate study guide

Follow this structure exactly:

# [Topic]: Study Guide

## Overview

[1-2 paragraphs orienting the reader to what the sources cover and the
key areas of focus.]

## Short-Answer Quiz

1. [Question requiring a 2-3 sentence answer]
2. [Question]
...
10. [Question]

## Answer Key

1. [Answer with source attribution]
2. [Answer]
...
10. [Answer]

## Essay Questions

1. [Open-ended question with scope guidance, e.g., "Discuss at least
   two perspectives from the readings..."]
2. [Question]
...
5. [Question]

## Glossary

**[Term A]**: [Definition drawn from sources, 1-2 sentences.]

**[Term B]**: [Definition drawn from sources, 1-2 sentences.]

[Continue alphabetically for every specialized term in the sources.]

Step 4: Validate quality

Before finalizing, verify:
- [ ] All 10 short-answer questions are answerable from the sources
- [ ] Answer key is accurate with source attribution
- [ ] Questions use varied stems (define, explain, compare, evaluate)
- [ ] No yes/no or trivial questions
- [ ] Essay questions require synthesis, not just recall
- [ ] Essay questions include scope guidance
- [ ] Glossary covers every specialized term in the sources
- [ ] Glossary is alphabetical with 1-2 sentence definitions
- [ ] Markdown renders correctly

Question design

Short-answer questions:

• Test comprehension of key concepts, not trivia or minor details.
• Vary question stems: "Define...", "Explain how...", "Compare...", "What is the significance of...", "Describe the relationship between..."
• Each answer should require 2-3 sentences — not a single word, not a paragraph.
• Spread questions across all major topics in the sources.

Essay questions:

• Require synthesis across sources or critical evaluation of arguments.
• Include scope guidance so the student knows the expected depth: "citing at least three examples", "discuss at least two perspectives", "compare and contrast..."
• Avoid questions answerable in one sentence (too narrow) or requiring a dissertation (too broad).
• At least one question should ask the student to evaluate or take a position.

Glossary rules

• Include every specialized or technical term used in the sources.
• Prefer the source's own definition where one is provided.
• Definitions are 1-2 sentences. Do not use the term in its own definition.
• Alphabetical order. Bold the term, follow with a colon and definition.

Anti-patterns

• Questions with obvious answers that do not test understanding.
• Questions requiring knowledge not present in the sources.
• Glossary definitions that are circular ("X is the process of doing X").
• Essay questions so narrow they have one correct answer.
• Skipping the Overview section — students need orientation.
• Answers in the Answer Key that do not cite which source supports them.

Skill handoffs

When	Run
After study guide is written, audit prose quality	docs-writing