Opening and title

Type: kb/types/instruction.md

Make the TL;DR readable by someone who will read nothing else, and the title a literal statement of the artifact's central contrast.

Effort: judgment. Title proposals need judgment; the TL;DR edits alone may run as simple.

TL;DR:

  • Use only terms the TL;DR itself introduces. Where the body's technical term appears, replace it with the plain description the TL;DR gave earlier, so the opening ends where it began.
  • State the alternative the artifact denies in one sentence, so the reader knows what is at stake before the argument.
  • Cut words that add no content ("some software" is "software").
  • Identify a named person at first mention, in the sentence, not inside a link.
  • Define a term at its first use. Do not delete a term the body relies on later; a plain-language opening that drops it leaves a later section using it cold.
  • When a term appears only in a link entry or only in the body, search the KB for inbound uses before choosing which side to fix. A term other notes cite this artifact as the source of stays, and is introduced in the body.

Title:

  • Keep the half that names the claim. Replace a metaphor or a bare term with the full term and the literal contrast ("the LLM stays fixed, the software house learns", not "train the house").
  • Check the slug the title would produce against the 70-character limit before proposing it.
  • Propose the title; do not apply it. A title change also changes the file slug, which is a separate pure relocation commit.

Report: old and new TL;DR, proposed titles with one line each on what each emphasizes, and the slug length.