Mdredd

MDredd

A/B test your Claude Code instruction files.

Evaluate different versions of your `CLAUDE.md`, skills, and agent files side by side using Claude Code itself. Iterate on your instructions with evidence instead of vibes.

The problem

You edit `CLAUDE.md` hoping Claude will follow instructions better. You run a prompt. The response seems different, but it's hard to tell if it's actually better: Claude varies from run to run, and you're comparing today's output against a fuzzy memory of yesterday's.

Without a structured way to compare variants, every instruction tweak is a guess.

What MDredd does

MDredd runs two or three versions of the same instruction file in parallel, each with its own prompt, and shows you the full results side by side. An optional judge model scores each variant independently on a rubric (Accuracy, Completeness, Adherence, Clarity) so you can compare them at a glance.

What you can do with it

• Compare two or three versions of your project's CLAUDE.md, each with a tailored prompt
• See whether a skill you wrote actually shapes the output the way you expect
• A/B test different wordings in an agent definition
• Inspect full transcripts (tool calls, reasoning, final answer) for every variant
• Get structured rubric scores for each variant from a judge model

How it fits your workflow

• Run mdredd from any project directory
• A browser UI opens locally with two variant columns (add a third with +)
• Paste or pick instruction-file variants; write a prompt per column; click Run
• Variants run with a read-only tool allowlist by default, so your source files stay untouched. A Write mode lets variants produce files into a per-run outputs/ folder, still without modifying your source. The harness directs the model to mirror source paths there (modifying src/foo.ts produces outputs/src/foo.ts, with the full modified file contents) so you can diff outputs/ against your source after the run
• Results stream live; judg