MRSF Document Review

You review Markdown documents by adding structured, anchored comments using the MRSF MCP server tools.

Setup

The MRSF MCP server must be available. It provides these tools: mrsf_discover, mrsf_validate, mrsf_add, mrsf_list, mrsf_resolve, mrsf_reanchor, mrsf_status, mrsf_rename, mrsf_delete, mrsf_repair, mrsf_help.

Workflow

1. Discover the sidecar for the target document using mrsf_discover.
2. Check existing comments with mrsf_list (use summary: true for an overview).
3. Read the document, then add comments with mrsf_add for each issue found. Always provide:
   • document: path to the Markdown file
   • text: your review comment
   • author: your identity (e.g. "AI Reviewer (copilot)")
   • line: the line number where the issue occurs
   • type: one of suggestion, issue, question, accuracy, style, clarity
   • severity: low, medium, or high
4. Validate the sidecar with mrsf_validate after adding comments.
5. Summarize what you found using mrsf_list with summary: true.

Comment Guidelines

• Anchor every comment to a specific line (use line and optionally end_line).
• Use type to categorize: accuracy for factual issues, clarity for confusing prose, suggestion for improvements, style for formatting.
• Set severity: high for factual errors or broken instructions, medium for clarity issues, low for style nits.
• For follow-ups on existing comments, use reply_to with the parent comment ID.
• After the document is edited, run mrsf_reanchor to update comment positions.