Write textbook-style tutorial documentation for human readers. Use when creating User Guide pages, concept explanations, or worked-example notebooks.
Write a tutorial page for: $ARGUMENTS
Target audience: human MolPy users — chemists and simulation engineers learning the library.
Output location: docs/user-guide/ as .md or .ipynb.
Follow the narrative arc — not all sections are required, but the order is fixed:
Critical style rules (violations are WRONG, fix immediately):
docs/api/Code example conventions:
import molpy as mpfrom molpy.reacter import Reacter# -> [Atom: C, Atom: O]mol, ff, frame, traj, builder, rxnStep 1 — Understand the target
Read the source module and any existing doc pages for $ARGUMENTS. Use mcp__molpy__get_source and mcp__molpy__list_symbols to inspect the API.
Step 2 — Draft outline (internal only)
Map the narrative arc sections to actual content. Identify: the core pain point, one anchor analogy, the best single end-to-end example scenario.
Step 3 — Write the page
Use the molpy-documenter agent to draft. Pass it the narrative arc, the style rules above, and the key example scenario.
Step 4 — Self-review checklist
Before returning the doc, verify:
Output: the written doc file path + a one-line summary of what the page teaches.