Writing Qec Papers

Required Artifacts And Assumptions

Expected inputs:

• a candidate contribution statement,
• the main artifacts or results that support it,
• the intended audience or venue family if known.

Expected outputs:

• a manuscript plan,
• a manuscript outline,
• a claim-to-evidence matrix,
• a citation bundle,
• a list of missing figures, tables, experiments, or proof details.

Assumptions to make explicit:

• which code family, noise model, and decoder assumptions define the story,
• whether the paper is theory-heavy, benchmark-heavy, software-heavy, or mixed,
• whether reproducibility depends on registry artifacts, local scripts, or external toolchains.

Standard Workflow Checklist

1. Read research-state.yaml and confirm the current project scope and backend assumptions.
2. Classify the paper's main contribution type before drafting prose.
3. Write one sentence for the main claim and one sentence for the strongest supporting evidence.
4. Fill the claim-evidence matrix in templates/claim-evidence-matrix.template.md before expanding the abstract or introduction.
5. Fill the manuscript plan in templates/manuscript-plan.template.yaml so title, claims, venues, reproducibility anchors, and blockers are recorded in one place.
6. Start a source inventory with templates/citation-bundle.template.yaml before the related-work section turns into a memory exercise.
7. Build the outline around evidence-bearing sections instead of generic paper headings alone.
8. Keep figures, tables, proofs, and artifact references tied to named results, not aspirational future work.
9. If a target venue is known, run the venue-positioning skill before finalizing the abstract and introduction.

Validation Loop

Before closing work:

1. confirm every headline claim has an explicit supporting artifact, theorem, or experiment,
2. confirm QEC-specific assumptions are stated in the methods or setup plan,
3. confirm the draft distinguishes results, limitations, and open problems,
4. confirm any missing benchmark or proof work is surfaced as a blocker, not hidden in prose.

Common Issues And Fixes

Contribution inflation

Problem: the draft sounds broader than the evidence actually supports.

Fix: rewrite the title, abstract, and contribution bullets to match the strongest validated result only.

Benchmark without research question

Problem: a paper becomes a pile of plots without a clean scientific or systems question.

Fix: state what decision the benchmark resolves and why existing baselines were insufficient.

Hidden setup assumptions

Problem: the paper omits the code family, schedule, decoder compatibility assumptions, or confidence methodology.

Fix: move those assumptions into a visible setup section and tie figures back to them explicitly.

References

• references/qec-paper-structure.md
• references/citation-workflow.md
• templates/qec-paper-outline.template.md
• templates/claim-evidence-matrix.template.md
• templates/manuscript-plan.template.yaml
• templates/citation-bundle.template.yaml
• ../tailoring-qec-papers-for-physical-review-and-quantum/SKILL.md
• ../../docs/ARTIFACT_MODEL.md
• ../../docs/MANUSCRIPT_ARTIFACTS.md