mcpField
C
claim-matrix-rewriter

claim-matrix-rewriter

github.com/willoscarProductivity51743 installsUpdated 4w ago
Repository

About claim-matrix-rewriter

claim-matrix-rewriter rebuilds a claim-evidence matrix from subsection briefs, evidence drafts, and references, making it an evidence-driven index. It preserves a fixed format for downstream QA and calibrates claims to the available evidence.

Key features

  1. 01Build a matrix from evidence packs
  2. 02Require a claim and at least two evidence bullets per subsection
  3. 03Preserve the compatible Markdown marker format
  4. 04Distinguish full-text evidence from abstract- or title-only evidence

Use cases

  1. 01Rebuild a claim-evidence matrix from evidence drafts
  2. 02Provide a stable matrix format for downstream quality checks
  3. 03Keep claims provisional when evidence is limited

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill claim-matrix-rewriter

After installing, type/claim-matrix-rewriterin Claude Code to confirm it loaded.

Bundled filesscripts/run.py

Details

From the project README

Claim Matrix Rewriter (Evidence-first, NO PROSE)

Triggers & routing

  • Trigger: claim matrix rewriter, rewrite claim-evidence matrix, evidence-first claim matrix, matrix index, 证据矩阵重写, 从证据包生成矩阵.

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:

  • - Claim: (one per subsection)
  • - Evidence: (>=2 per subsection)

Inputs

  • outline/subsection_briefs.jsonl
  • outline/evidence_drafts.jsonl
  • citations/ref.bib

Outputs

  • outline/claim_evidence_matrix.md

Non-negotiables

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

Helper script

  • uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --help
  • uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>

Script

Quick Start
  • uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --help
  • uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>
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: uv run python .codex/skills/claim-matrix-rewriter/scripts/run.py --workspace <workspace>

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.

Comments

Markdown supported