final-method-explainer

name	final-method-explainer
description	Build the authoritative final method explanation for a submission-ready subquestion from the method card, human decision ledger, code plan, final results, and robustness evidence.

Purpose

Explain the selected method completely without re-authoring why the human chose it.

Preconditions

• rigor_profile is submission or writer handoff is explicitly requested.
• Human method choice and result verdicts are recorded in qx_decisions.jsonl.
• Approved code ran and final result/robustness evidence exists.

Sources

Use:

• qx_method_card.md
• qx_decisions.jsonl
• planning/model_assumptions.md
• planning/symbol_table.md
• qx_code_plan.md
• final run summary and result analysis
• robustness summary/report

Read legacy candidate and iteration logs only for migration.

Workflow

1. Resolve the final method and baseline from the latest non-stale human decisions.
2. Transcribe the human's selection rationale faithfully and cite its decision_id.
3. Explain:
   • goal and scope;
   • assumptions, including human-confirmed necessity labels;
   • symbols and units;
   • mathematical formulation;
   • inputs, outputs, objective/criteria, and constraints;
   • solution procedure;
   • baseline and why it is valid;
   • fallback trigger and whether it fired;
   • validation, robustness, limitations, and applicable range.
4. Ensure formulas match code and symbol table.
5. Save methods/Qx/qx_final_method_explanation.md.

Rules

• Do not infer the chosen method from best metrics.
• Do not invent the why-this-method narrative.
• Do not create a new pending decision artifact.
• Do not restate a long iteration diary; include only material eliminated alternatives and evidence.
• Do not include unsupported numerical claims.

Verification

• Final method and rationale trace to decision IDs.
• Assumptions, symbols, formulas, units, and code agree.
• Baseline is usable rather than merely diagnostic.
• Risks, fallback behavior, and limitations are explicit.
• The explanation is self-contained enough for the writer.