dela
5170111823
Rewrite references/pedagogy.md around recite-vs-teach: reader model,
coverage density (sections_in is cite permission, not a to-do list),
intuition-before-formula three-beat, and paper-jump filling.
Every notes/sections/sec-*.tex must now answer gap / takeaway / jump /
omit above the first \section. lint.py checks presence only (it cannot
judge honesty); files opening with "% generated by" are exempt.
- scripts/lint.py: SP025 + is_writer_section / teach_gaps helpers
- tests/no-teach-block/: fixture with takeaway only, wired into test.sh
- examples/*: all 14 writer sections get real teach blocks
- SKILL.md, references/{agents,antipatterns,checklist}.md, DESIGN.md,
assets/notes-template.tex: route writers and consistency agent
through pedagogy.md
10 lines
479 B
Markdown
10 lines
479 B
Markdown
# Antipatterns
|
|
|
|
- Recapping the paper's sections in lecture clothing (see `pedagogy.md`).
|
|
- Drawing a rewrite as `\sfnode` boxes (use `align`).
|
|
- Sending a tensor-shape claim to superfig, or an architecture to supertensor.
|
|
- Loading a figure `.sty` in the notes so sibling warnings leak into the article log.
|
|
- `\input` of a standalone TikZ source instead of `\spfig`.
|
|
- Reusing a `dropped` / retired id for a new object.
|
|
- A decorative group or arrow that is not in the ledger.
|