Observación: Una Herramienta de Anotación en Markdown para Flujos de Trabajo de Código en Claude

Qué hace Remark

Remark aborda un punto de fricción específico al usar Claude Code: revisar archivos de especificaciones o instrucciones y dejar comentarios para el agente. El desarrollador detrás de él descubrió que pegar notas en el chat desconecta los comentarios del archivo, mientras que dejar notas directamente en markdown es desordenado porque el agente las lee como contenido o las elimina.

Características y comandos clave

La herramienta es una aplicación nativa para macOS con estas capacidades específicas:

• Anotar cualquier archivo Markdown en línea resaltando secciones y agregando comentarios
• Exportar anotaciones con remark export file.md - esto genera una lista JSON que contiene exactamente lo que se marcó, dónde en el archivo y el contexto circundante
• Limpiar anotaciones resueltas con remark resolve
• Operación solo local - nada sale de tu máquina

Integración con Claude Code

La integración con Claude Code funciona a través de un sistema de habilidades:

• Ejecuta remark install-skill para instalar una habilidad en tu directorio .claude/skills/
• La habilidad cubre el formato de anotación, incluyendo cómo leer las exportaciones, cómo marcar anotaciones como resueltas y cómo manejar coincidencias parciales cuando el archivo ha cambiado desde la revisión

Detalles técnicos

La herramienta fue construida con Claude Code, que escribió la mayor parte del backend en Rust y el algoritmo de reanclaje. Está disponible para macOS con una prueba gratuita de 7 días, luego una compra única de $17. Las opciones de instalación incluyen:

• Descarga directa desde getremark.app
• Homebrew: brew install mfreiwald/tap/remark

Este tipo de herramienta es útil para desarrolladores que revisan regularmente y proporcionan comentarios sobre archivos de instrucciones de Claude Code, ofreciendo una forma estructurada de mantener el contexto de los comentarios dentro de los archivos reales que se están revisando.