What problem does it solve? Plumbline lint runs can surface many comment-hygiene and citation violations at once, and deciding how to resolve each one manually is slow. This Skill walks every violation and proposes a concrete fix — delete the comment, convert load-bearing content into an assertion, type, or name, or resolve an unresolved citation — without applying anything automatically. ## Core Features & Use Cases - Heuristic fix proposals: Comments containing "must"/"always"/"requires" are routed toward assertions; "deliberate"/"intentional" toward naming; restatements and TODO/FIXME/HACK markers toward deletion. - Citation and test-rule handling: Unresolved citations get proposals to correct the slug, create the missing artifact, or remove the citation; no-tests violations get revert-or-move proposals. - Read-only review workflow: Suggestions are printed with rationale and walked through with the user one at a time; nothing is bulk-applied. - Use Case: After a lint run flags 30 comment violations across a codebase, run the suggest command to get a draft action for each, then confirm or override each proposal interactively. ## Quick Start Ask the assistant to run /ok-plumbline:suggest to list proposed fixes for the current project's Plumbline lint violations.
