BlockWatch

Echte Rust linter die code/docs drift vangt via <block affects=...> commentaar tags -- geverifieerd met de daadwerkelijke gebouwde binaire, niet alleen door de bron te lezen.

Door mennanov · mennanov/blockwatch

Getest · Werkt ★ 9.2/10

BlockWatch — Echte Rust linter die code/docs drift vangt via <block affects=...> commentaar tags -- geverifieerd met de daadwerkelijke gebouwde binaire, niet alleen door de bron te lezen.

Wat het doet

Een taal-agnostische linter (Rust CLI, installeerbaar via cargo of brew) die HTML-achtige <block> tags in commentaarregels van bronbestanden valideert: keep-sorted/keep-unique lijsten, line-pattern/line-count beperkingen, en affects links die een gekoppeld bestand (bijv. een enum en zijn README-tabel) samen laten veranderen. Wordt geactiveerd bij het schrijven of bewerken van code in een project dat BlockWatch al gebruikt, of wanneer een bestand al <block ...> tags bevat; de skill instrueert de agent om tags toe te voegen in dezelfde bewerking die een guardable patroon introduceert en te verifiëren met `git diff --patch | blockwatch`.

Testrapport

Installeerde de echte binaire via `brew install mennanov/blockwatch/blockwatch` (vertrouwde formule, gebouwd in 1s) en voerde een volledige A/B-test uit in een wegwerp git-repo: een naïeve basisbewerking voegde een taal toe aan een Python-lijst maar vergat stilzwijgend de bijbehorende README-regel zonder waarschuwing, terwijl de door de skill geleide bewerking `<block affects=...>` tags toevoegde in dezelfde wijziging, beide bestanden synchroon hield, `git diff --patch | blockwatch` passeerde (exit 0), en vervolgens een opvolgende naïeve bewerking correct ving met een precieze 'is modified, but README.md:supported-langs is not' schending (exit 1) - maar de claim van SKILL.md dat een kale `blockwatch` (geen diff gepiped) 'elke block in de tree valideert' onjuist is, empirisch geverifieerd: met een ongesorteerde keep-sorted lijst en geen diff op stdin sluit het stilzwijgend af met 0, wat in tegenspraak is met de eigen --help tekst van de tool en zijn eigen 'alleen gevalideerd wanneer aangeraakt door een diff' zin elders in hetzelfde bestand.

Getest op: 2026-07-15 · Claude Code 2.x (agent harness)

Installatie

git clone https://github.com/mennanov/blockwatch
cd blockwatch
mkdir -p ~/.claude/skills
cp -r .agents/skills/blockwatch ~/.claude/skills/blockwatch

Commando's en voorbeeldprompts

  • /blockwatchEchte Rust linter die code/docs drift vangt via <block affects=...> commentaar tags -- geverifieerd met de daadwerkelijke gebouwde binaire, niet alleen door de bron te lezen.

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • Add a block tag so this Python list stays in sync with README docs
  • I added a new item to this enum, check if the docs need updating too
  • Verify my code changes with blockwatch before I commit this diff