| name | pprose-compare |
| description | Compare evaluated document versions or variants; read-only on source docs. Use when asked to compare drafts, A/B versions, quality-diff docs, or pick the best. |
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
-
Run pprose runbook practical-prose-eval-compare for the full procedure.
-
Validate each input:
pprose report validate path/to/artifact.eval.md --complete
-
Generate the comparison:
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.
-
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.
