3 ms·
I built MRSF because Markdown review workflows don’t persist well across edits. Inline comments clutter documents. GitHub PR comments disappear once merged. An
by wictorwilen 7mo ago
I built MRSF because Markdown review workflows don’t persist well across edits.
Inline comments clutter documents. GitHub PR comments disappear once merged. And AI agents don’t have a structured way to attach feedback to Markdown that survives refactors.
MRSF is a JSON/YAML sidecar format for Markdown reviews. It includes:
- Anchored comments (line + span + selected text)
- Deterministic re-anchoring after edits
- A JSON Schema for validation
- A CLI (validate, reanchor, status)
- An MCP server so LLM agents can read/write review comments programmatically
The core idea is simple: keep review metadata outside the Markdown file, but robust enough that comments survive document evolution.
I’d especially appreciate feedback on:
- The re-anchoring strategy
- Whether this overlaps too much with LSP diagnostics
- Whether this would be useful outside AI/agent workflows
- Any obvious flaws in the schema design
Repo: https://github.com/wictorwilen/MRSF/ https://github.com/wictorwilen/MRSF/