Comments citing the spec document instead of just stating the fact directly made their usefulness depend on cross-referencing a separate file. Reworded each one to stand alone - same content, citation dropped, folded into a normal sentence where it was mid-clause rather than trailing. spec/porthole-spec.md itself is untouched. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>