Skip to content
tishad.net
SearchCtrl K

Lessons / Part 10. Coding agents, commands and skills

74 Separate the agent that reads a source from the one that writes

A reader writes a fact sheet and a fresh writer works from that alone, so the notes follow the concepts and not the chapter.

What people usually ask

Write notes on this chapter.

What comes back

Notes in the chapter’s order, with the chapter’s section titles and half its sentences lightly reworded.

Ask this instead

Two agents, not one. Check first that the licence in the front matter of chapter_7.pdf allows reuse; stop if it does not, and record the licence line, title, authors, edition and year at the top of facts.md.
Reader agent: read the chapter and write facts.md, a terse list of every fact, equation, value and definition with its page number, in your own words, no sentence copied.
Writer agent, in a fresh session given facts.md and nothing else: write notes/convection.md organized by concept, not by the chapter's order.
Then compare notes/convection.md against the chapter text for shared runs of eight words or more and report every hit. Expect equations, defined terms and tabulated values to flag, and prose to not; a prose hit is rewritten.
Last, the reader agent checks each statement in the notes against the chapter and marks it confirmed or wrong.

Attach: A chapter whose licence allows reuse, as PDF or plain text, to the reader agent only.

Why it works: a writer that never saw the chapter cannot copy its wording, and the overlap check and the reader’s pass catch what slipped through the fact sheet.

Drafted with Fable 5.1 from my notes; chosen and edited by me.