source-tutorial-writer

name

source-tutorial-writer

description

Use when approved tutorial context packs exist and the run needs the final article-first tutorial deliverable. **Trigger**: source tutorial writer, tutorial drafting, 教程正文, 从资料写教程. **Use when**: `source-tutorial` 的 C3，`outline/tutorial_context_packs.jsonl` 已就绪，且 `DECISIONS.md` 已勾选 `Approve C2`。 **Skip if**: C2 未批准，或 context packs 还没准备好。 **Network**: none. **Guardrail**: 正文必须 reader-first，但不能写出 sources 没支持的内容。

Source Tutorial Writer

Writes the final tutorial markdown from approved module packs and the locked C2 structure.

Inputs

• outline/tutorial_context_packs.jsonl
• outline/module_plan.yml
• DECISIONS.md

Output

• output/TUTORIAL.md

Contract

The tutorial must:

• start with reader orientation
• follow the approved module order
• keep per-module teaching sections explicit
• keep source notes visible but lightweight

Per module, the writer should emit:

• ### Why it matters
• ### Key idea
• ### Worked example
• ### Check yourself
• ### Source notes

Script boundary

scripts/run.py should:

• block on missing Approve C2
• load module packs in approved order
• render the deterministic tutorial scaffold/content into output/TUTORIAL.md

Keep rendering and pack interpretation in shared tutorial tooling, not in the wrapper.

Acceptance

• output/TUTORIAL.md exists
• the required reader-orientation sections exist
• every module includes the required teaching subsections

Non-goals

• self-loop QA reporting
• article/slides compilation