jlevy/practical-prose/pprose-compare

Run pprose as pprose <command> if on PATH, else uvx pprose@0.4.0 <command>

(zero-install via uv).

Run pprose --help for every command, pprose skill for the other Practical Prose

skills, and pprose list for all on-demand playbooks, style guides, and procedures

(pprose shortcut, pprose guidelines, pprose runbook each print one by name).

Compare Practical Prose Evaluations

This is read-only on source documents. It writes or prints comparison reports.

Use it after each input document already has a validated Practical Prose eval report.

Inputs

• Paths to two or more validated *.eval.md reports.
• Optional labels or pair specs for deltas, such as old=new.

Steps

1. Run pprose runbook practical-prose-eval-compare for the full procedure.

1. Validate each input:

``bash pprose report validate path/to/artifact.eval.md --complete ``

1. Generate the comparison:

``bash pprose compare a.eval.md b.eval.md --format unified --pairs 'a=b' > comparison.md ``

Add --table-styles only when generating a report for a browser that supports the optional table-style microformat.

1. Add human analytical prose only when the user asks for a full report, and ground it

in specific table cells.

Output

Return the comparison path or table, validation status for each input, and any alignment or rubric-version warnings.