# Revision Materials — Per-Topic Generation

For each confirmed topic, produce these outputs. All content must come from the knowledge base (memory search), not from training data.

## 1. Summary

A concise explanation of everything the student needs to know for this topic. Written for the student to read independently.

**Behaviour:**
- Search memory for the topic content and extract the key facts, definitions, and relationships
- Use precise, assessment-appropriate language — not dumbed-down paraphrases
- Organise logically: definitions first, then processes/relationships, then applications
- Include specific details the knowledge base provides (dates, names, values, formulae, named examples)
- Keep it dense — this is revision, not first-encounter teaching
- Adapt the language complexity to the student's age, but do not sacrifice precision for simplicity

## 2. Flashcards

Question-and-answer pairs for active recall practice.

**Behaviour:**
- Write questions that mirror assessment phrasing — use command words relevant to the subject (define, explain, describe, compare, evaluate, calculate)
- One concept per card
- Answers should be concise and specific — what an assessor would accept
- Cover every key term, definition, and process in the topic
- Include application questions, not just recall — "Why does X happen?" not just "What is X?"
- Aim for 8-15 cards per individual topic depending on content density

**Format:**
Present as a numbered list of Q/A pairs:
```
1. Q: [Question]
   A: [Answer]
```

## 3. Assessment Questions

Assessment-style questions at varying difficulty.

**Behaviour:**
- 3-5 questions per topic
- Mix question types: short answer, explanation, application
- Grade by difficulty: label each as Foundation, Intermediate, or Higher
- Write plausible distractors for multiple-choice questions — drawn from within the same topic, not obviously absurd
- Include the expected answer or mark scheme points for each question
- Where the subject uses specific command words, use them

## 4. Key Terms

A glossary of essential vocabulary for the topic.

**Behaviour:**
- Every technical term the student would encounter in this topic
- Definitions that match the precision expected at the student's level
- Include the term as used in context where helpful
- Order alphabetically within each topic

## 5. Visual Overview

Generate an image summarising the topic's key concepts and relationships.

**Behaviour:**
- Use `image_generate` to create a visual overview — an infographic-style image showing the main concepts, their relationships, and key facts
- The image should work as a one-page visual reference the student can glance at during revision
- Describe the image content precisely in the generation prompt: topic name, key concepts to include, relationships to show, any diagrams or flows that would help
- For science topics: include diagrams (cell structures, food webs, circuit diagrams)
- For maths topics: include worked examples and formula summaries
- For humanities topics: include timelines, cause-and-effect flows, key figure summaries

## 6. Video Summary (Future)

When HeyGen video generation is available, generate a short video explanation of each topic.

**Behaviour:**
- Write a script suitable for a 2-3 minute video summary of the topic
- The script should be structured as spoken narration — clear, direct, assessment-focused
- Save the script to memory alongside the other materials so it can be used for video generation when the capability is available
- Mark this output as "script ready — video generation pending"

## Saving to Memory

Save each topic's materials to memory as a single file at:
```
memory/public/study-packs/{subject}/{topic-slug}.md
```

Use a consistent structure within each file:
```
# {Topic Name}

## Summary
...

## Flashcards
...

## Assessment Questions
...

## Key Terms
...

## Visual Overview
[Generated image reference]

## Video Script
[Script text — pending video generation]
```

## Quality Check

Before saving, verify:
- Every flashcard and assessment answer traces back to knowledge base content
- No content has been introduced from general knowledge or training data
- Key terms match the terminology used in the knowledge base
- The difficulty spread is appropriate for the student's age and level
