Suggestions · 1 of 2

Every document reports what is wrong with it.

A markdown document open in Syns with a suggestions panel in the right sidebar listing eight findings — count mismatch, stale identifier, dangling reference, prose contradicts code, restated proposition, retired concept — each with a one-sentence explanation, a line number and a character-size impact. Spans in the document body are underlined where a finding applies. — Eight findings here, 12 files in the repository. Underlined spans mark where each one applies. Click for detail.

Short and capped

A handful per document, with a limit on how many can be severe. Three hundred findings is a list nobody acts on.

Ranked by consequence

Would a wrong reading make an agent ship the wrong contract? Everything else stays out.

One sentence each

What is wrong, and what breaks if an agent believes the current text. Not a rule name and a line number.