BlockWatch
Lintador real de Rust que detecta deriva de código/documentación a través de etiquetas de comentarios <block affects=...> -- verificado con el binario compilado real, no solo leyendo el código fuente.
Probado · Funciona
Qué hace
Un lintador agnóstico al lenguaje (CLI de Rust, instalable vía cargo o brew) que valida etiquetas <block> tipo HTML colocadas en comentarios de archivos fuente: listas keep-sorted/keep-unique, restricciones de patrón/cantidad de líneas, y afecta enlaces que obligan a que un archivo emparejado (ej. un enum y su tabla README) cambie junto. Se activa al escribir o editar código en un proyecto que ya usa BlockWatch, o cuando un archivo ya contiene etiquetas <block ...>; la skill le dice al agente que añada etiquetas en la misma edición que introduce un patrón guardable y que verifique con `git diff --patch | blockwatch`.
Informe de la prueba
Instalé el binario real vía `brew install mennanov/blockwatch/blockwatch` (fórmula confiable, compilada en 1s) y ejecuté un A/B completo en un repositorio git desechable: una edición de línea base añadió un lenguaje a una lista de Python pero olvidó silenciosamente la línea README correspondiente sin ninguna advertencia, mientras que la edición guiada por la skill añadió etiquetas `<block affects=...>` en el mismo cambio, mantuvo ambos archivos sincronizados, pasó `git diff --patch | blockwatch` (salida 0), y luego detectó correctamente una edición ingenua posterior con una violación precisa de 'está modificado, pero README.md:supported-langs no lo está' (salida 1) -- pero la afirmación de SKILL.md de que `blockwatch` desnudo (sin diff canalizado) 'valida cada bloque en el árbol' es falsa, verificada empíricamente: con una lista keep-sorted desordenada y sin diff en stdin, sale silenciosamente con 0, contradiciendo el propio texto --help de la herramienta y su propia frase 'solo se valida cuando es tocado por un diff' en otro lugar del mismo archivo.
Probado el: 2026-07-15 · Claude Code 2.x (agent harness)
Instalación
git clone https://github.com/mennanov/blockwatch cd blockwatch mkdir -p ~/.claude/skills cp -r .agents/skills/blockwatch ~/.claude/skills/blockwatch
Comandos y prompts de ejemplo
/blockwatchLintador real de Rust que detecta deriva de código/documentación a través de etiquetas de comentarios <block affects=...> -- verificado con el binario compilado real, no solo leyendo el código fuente.
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
Add a block tag so this Python list stays in sync with README docsI added a new item to this enum, check if the docs need updating tooVerify my code changes with blockwatch before I commit this diff