Skip to content

body.promise

A rationale section that cites an id no line carries. Almost always an id written into prose while planning, which the deriver then reads as spent — so the next add skips it and nothing ever occupies the number.

The design names an id no line carries, which the deriver reads as spent and the next add steps past (RK431) — and whether it was an illustration, the id this task should have had, work not filed yet, or an address this project reserved and will never write as a line is the sentence’s meaning, not the tool’s.

Two or more doors are open and which one is right is a judgement about the work.

  • roadkeep next-id — the id is a sibling not filed yet; this says what it will be — add it first, and the section then names a line that exists (reads only)
  • roadkeep section amend … --body - — it was an example; spell it outside this project’s prefix, where nothing numbers it
  • roadkeep gaps — read where the id went before deciding it was never a line (reads only)
  • roadkeep lint — the id is reserved: add it to reserved_ids in roadkeep.toml, where the deriver skips it because it IS taken — then this re-reads clean (reads only)