claim-matrix-rewriter

Claim Matrix Rewriter (Evidence-first, NO PROSE)

Purpose: make outline/claim_evidence_matrix.md a navigation/index layer that is driven by evidence packs (not by outline bullets).

Key property: keep the legacy, gate-checked format so downstream QA can rely on stable markers:

Inputs

Outputs

Non-negotiables

NO PROSE: bullets only.
No placeholders: no ... , unicode ellipsis (… ), TODO , (placeholder) , or  .
Claims are evidence-aware:
fulltext-backed: may summarize comparisons
abstract-only/title-only: must be provisional (no strong “dominant trade-offs” language)

Helper script

Script

Quick Start

All Options

See --help .
Requires: outline/subsection_briefs.jsonl , outline/evidence_drafts.jsonl , citations/ref.bib .

Examples

Rewrite the matrix from evidence packs:
Ensure outline/subsection_briefs.jsonl and outline/evidence_drafts.jsonl exist and blocking_missing is empty.
Ensure citations/ref.bib exists and contains the cited keys.
Run: python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace workspaces/<ws>

Troubleshooting

Issue: cited keys are missing from citations/ref.bib

Fix:

Run citation-verifier (or fix the upstream notes) so every referenced key exists before rewriting.

Issue: evidence packs still have blocking_missing

Fix:

Fix upstream evidence (paper-notes / evidence-draft ) first; the matrix should not “paper over” missing evidence.

Source Transparency