skills/education-module-creation/references/source-coverage.md

# Source coverage standard

Apply this standard whenever a user asks to turn supplied notes, PDFs, documents, recordings, lectures, or other source material into Education modules or lessons.

## Default outcome: a comprehensive learning companion

Treat the source as the curriculum. The default deliverable must closely follow it in a teachable structure; it is not a compact gist, executive summary, list of headline themes, or lightly expanded synopsis.

Only produce a shortened treatment when the user explicitly asks for a summary, overview, highlights, recap, quick study guide, short course, or a stated reduction in scope or depth.

Do not decide that a source is too long and silently reduce it to a few broad lessons. Add folders and lessons as needed to cover the source with useful depth.

## Build a coverage map before writing

Create a private source-to-module map before any Education write. For each substantive source section, record:

- The source location: timestamp range for video/audio; page and heading for PDFs/documents; section/heading for notes.
- Main claim or topic.
- Supporting explanations, definitions, examples, named entities, chronology, evidence, qualifications, and cited resources that materially teach the topic.
- The intended folder and lesson where it will be represented.

Use the map to choose natural teaching units. Retain meaningful chronology, causal chains, comparisons, demonstrations, and transitions; do not flatten them into isolated bullets.

For long recordings, this map is evidence that the complete source was reviewed, not an optional planning aid. Do not create lessons from an excerpt, keyword search, or a high-level transcript summary. Work through the full timestamped source in chronological sections and reconcile those sections into the map before writing.

## What must be preserved

Cover every substantive topic and its material supporting detail unless it is genuinely repetitive, administrative, inaccessible, or explicitly out of scope. In particular, preserve when present:

- Definitions, distinctions, mechanisms, and reasoning—not only conclusions.
- Examples, demonstrations, worked problems, case studies, and counterexamples.
- Named people, places, events, dates, terminology, and chronology when they carry the teaching content.
- Qualifications, uncertainty, disagreements, limitations, and source-specific interpretations.
- Tables, code, quotations, diagrams, figures, citations, and links in their appropriate supported rich-text forms.
- Connections and transitions that explain why one topic follows another.

Condense genuine repetition, verbal filler, greetings, housekeeping, and off-topic material. Do not use “conciseness” to omit substantive explanations or examples.

## Source-specific evidence

- For lectures and recordings, retain timestamps in the coverage map and use the verified transcript as the factual source. Include timestamped raw links when they materially help a learner revisit an explanation.
- For PDFs and documents, retain page/heading locations while mapping material. Preserve accompanying figures and captions when they contribute to understanding.
- For notes, retain the author’s structure, examples, links, and code where present; do not replace detailed notes with generic textbook prose.

## Coverage audit before creation

Before creating drafts, compare the module outline and proposed lesson bodies with the source map:

1. Every substantive source section must map to a lesson or be listed with a specific reason for omission.
2. Each lesson must explain the underlying reasoning and examples needed for its topic, not just state a conclusion.
3. Broad lesson titles must not hide unrelated omitted subtopics; split them when depth or navigation requires it.
4. Lesson order must preserve the source’s meaningful progression unless a clearer pedagogical order is explicitly justified.
5. If the source cannot be accessed, transcribed, or read fully, say so and do not claim comprehensive conversion.
6. Each proposed lesson body must contain the mapped explanation, reasoning, examples, and evidence needed to teach its topic. A short synopsis of the timestamp range does not satisfy coverage.

After creation, verify that the saved hierarchy and returned HTML still represent the mapped material. Report only material omissions that are concrete and source-specific.