source-tutorial-spec

Source Tutorial Spec

Triggers & routing

• Trigger: source tutorial spec, tutorial from sources, learner profile, tutorial specification, generate tutorials from materials.
• Use when: source-tutorial 's C2, it is necessary to, based on sources/index.jsonl / sources/provenance.jsonl , lock down audience, prerequisites, learning objectives, source scope, and running example policy.

Builds the C2 tutorial contract from the ingested source corpus, not from a bare topic prompt.

Inputs

• sources/index.jsonl
• sources/provenance.jsonl
• GOAL.md
• DECISIONS.md

Output

• output/TUTORIAL_SPEC.md

Contract

The spec must include:

• ## Audience
• ## Prerequisites
• ## Learning objectives
• ## Non-goals
• ## Source scope
• ## Running example policy
• ## Delivery shape

It should also embed machine-readable structured data for downstream deterministic planning.

Script boundary

scripts/run.py should:

• read the ingested source bundle
• derive a grounded tutorial scope
• write the markdown spec and structured seed block

Keep phrase extraction, concept selection, and source matching in shared tutorial tooling, not in the thin skill wrapper.

Acceptance

• output/TUTORIAL_SPEC.md exists
• the required sections are present
• source families are named explicitly
• running example policy is concrete or explicitly omitted

Non-goals

• concept DAG construction
• module sequencing
• tutorial prose writing