rdr-refine

name	rdr-refine
metadata	{"argument-hint":"<NNNN> [--commit | --no-commit]"}
description	Use to remove contradiction, redundancy, change-history narration, and bloat from an RDR draft. Runs Stage 3 before assumption verification. Trigger for refine RDR, $rdr-refine, or /rdr-refine.

rdr-refine — Stage 3 (Refine)

Remove internal contradiction, redundancy, and bloat so the draft is internally consistent before its claims are verified. Refine fixes the document; it does not verify the world (that's Stage 4).

Usage

Codex: $rdr-refine <NNNN>
Claude: /rdr-refine <NNNN>

1. Read rdr-common.md; run §seam-bind + §rdr-resolve to bind $RDR_RESOURCES, RDR_PATH.
2. Run the prompt 03-refine.prompt.md. The RDR is a Draft — edit it in place; rewrite to reflect the current world, don't preserve superseded content. Keep decision rationale; cut the history that produced it. It uses the Domain-priors section of $RDR_RESOURCES to decide which side of a contradiction is right (a clause that violates a product principle is the side to fix). EXCEPTION: a Status: Draft [revised from Final …] qualifier is live state, not history — leave it.

Review gate (Stage 03-refine.md)

• All change-history gone (no Rescope Note / Refinement Context / "retained as history" / "this is now wrong" annotation) — only the current design remains.
• Decision rationale NOT cut by mistake (rationale = why this design; history = what it used to be — keep the first, cut the second).
• Contradictions actually resolved, not deleted on one (wrong) side.
• Failure mode triaged, not just patched (the prompt routes the cure).
• Proportionate to the change's risk (contract count, not word count).

Next step (rdr-common §next-step)

• If autocommit is on, run §commit for refine first (see the rdr-common table).
• Next: /rdr-resolve NNNN — verify the Critical Assumptions against reality.
• A contradiction that's a real design hole → /rdr-propose NNNN (the approach is underspecified).
• /rdr-status NNNN to re-orient.