Paper Write

Ocupación

Categorías

Documentos

Inputs

1. PAPER_PLAN.md — outline with claims-evidence matrix, section plan, figure plan (from /paper-plan)
2. NARRATIVE_REPORT.md — the research narrative (primary source of content)
3. Generated figures — PDF/PNG files in figures/ (from /paper-figure)
4. LaTeX includes — figures/latex_includes.tex (from /paper-figure)
5. Bibliography — existing .bib file, or will create one

If no PAPER_PLAN.md exists, ask the user to run /paper-plan first or provide a brief outline.

Orchestra-Guided Writing Overlay

Keep the existing insleep workflow, file layout, and defaults. Use the shared references below only when they improve writing quality:

• Read ../shared-references/writing-principles.md before drafting the Abstract, Introduction, Related Work, or when prose feels generic.
• Read ../shared-references/venue-checklists.md during the final write-up and submission-readiness pass.
• Read ../shared-references/citation-discipline.md only when the built-in DBLP/CrossRef workflow is insufficient.

These references are support material, not extra workflow phases.

Templates

Venue-Specific Setup

The skill includes conference templates in templates/. Select based on TARGET_VENUE:

ICLR:

\documentclass{article}
\usepackage{iclr2026_conference,times}
% \iclrfinalcopy  % Uncomment for camera-ready

NeurIPS:

\documentclass{article}
\usepackage[preprint]{neurips_2025}
% \usepackage[final]{neurips_2025}  % Camera-ready

ICML:

\documentclass[accepted]{icml2025}
% Use [accepted] for camera-ready

IEEE Journal (Transactions, Letters):

\documentclass[journal]{IEEEtran}
\usepackage{cite}  % IEEE uses \cite{}, NOT natbib
% Author block uses \author{Name~\IEEEmembership{Member,~IEEE}}

IEEE Conference (ICC, GLOBECOM, INFOCOM, ICASSP, etc.):

\documentclass[conference]{IEEEtran}
\usepackage{cite}  % IEEE uses \cite{}, NOT natbib
% Author block uses \IEEEauthorblockN / \IEEEauthorblockA

Project Structure

Generate this file structure:

paper/
├── main.tex                    # master file (includes sections)
├── iclr2026_conference.sty     # or neurips_2025.sty / icml2025.sty / IEEEtran.cls + IEEEtran.bst
├── math_commands.tex           # shared math macros
├── references.bib              # bibliography (filtered — only cited entries)
├── sections/
│   ├── 0_abstract.tex
│   ├── 1_introduction.tex
│   ├── 2_related_work.tex
│   ├── 3_method.tex            # or preliminaries, setup, etc.
│   ├── 4_experiments.tex
│   ├── 5_conclusion.tex
│   └── A_appendix.tex          # proof details, extra experiments
└── figures/                    # symlink or copy from project figures/

Section files are FLEXIBLE: If the paper plan has 6-8 sections, create corresponding files (e.g., 4_theory.tex, 5_experiments.tex, 6_analysis.tex, 7_conclusion.tex).

Workflow

Step 0: Backup and Clean

If paper/ already exists, back up to paper-backup-{timestamp}/ before overwriting. Never silently destroy existing work.

CRITICAL: Clean stale files. When changing section structure (e.g., 5 sections → 7 sections), delete section files that are no longer referenced by main.tex. Stale files (e.g., old 5_conclusion.tex left behind when conclusion moved to 7_conclusion.tex) cause confusion and waste space.

Step 1: Initialize Project

1. Create paper/ directory
2. Copy venue template from templates/ — the template already includes:
   • All standard packages (amsmath, hyperref, cleveref, booktabs, etc.)
   • Theorem environments with \crefname{assumption} fix
   • Anonymous author block
3. Generate math_commands.tex with paper-specific notation
4. Create section files matching PAPER_PLAN structure

Author block (anonymous mode):

\author{Anonymous Authors}

Step 2: Generate math_commands.tex

Create shared math macros based on the paper's notation:

% math_commands.tex — shared notation
\newcommand{\R}{\mathbb{R}}
\newcommand{\E}{\mathbb{E}}
\DeclareMathOperator*{\argmin}{arg\,min}
\DeclareMathOperator*{\argmax}{arg\,max}
% Add paper-specific notation here

Step 3: Write Each Section

Process sections in order. For each section:

1. Read the plan — what claims, evidence, citations belong here
2. Read NARRATIVE_REPORT.md — extract relevant content, findings, and quantitative results
3. Draft content — write complete LaTeX (not placeholders)
4. Insert figures/tables — use snippets from figures/latex_includes.tex
5. Add citations — for ML conferences (ICLR/NeurIPS/ICML/CVPR/ACL/AAAI): use \citep{} / \citet{} (natbib). For IEEE venues: use \cite{} (numeric style via cite package). Never mix natbib and cite commands.

Before drafting the front matter, re-read the one-sentence contribution from PAPER_PLAN.md. The Abstract and Introduction should make that takeaway obvious before the reader reaches the full method.

Section-Specific Guidelines

§0 Abstract:

• Use the 5-part flow from ../shared-references/writing-principles.md: what, why hard, how, evidence, strongest result
• Must be self-contained (understandable without reading the paper)
• Start with the paper's specific contribution, not generic field-level background
• Include one concrete quantitative result
• 150-250 words (check venue limit)
• No citations, no undefined acronyms
• No \begin{abstract} — that's in main.tex

§1 Introduction:

• Open with a compelling hook (1-2 sentences, problem motivation)
• State the gap clearly ("However, ...")
• Give a brief approach overview before the reader gets lost in details
• List 2-4 specific, falsifiable contributions as a numbered or bulleted list
• Preview the strongest result early instead of saving it for the experiments section
• End with a brief roadmap ("The rest of this paper is organized as...")
• Include the main result figure if space allows
• Target: 1-1.5 pages
• Methods should begin by page 2-3 at the latest

§2 Related Work:

• MINIMUM 1 full page (3-4 substantive paragraphs). Short related work sections are a common reviewer complaint.
• Organize by category using \paragraph{Category Name.}
• Organize methodologically, by assumption class, or by research question; do not write paper-by-paper mini-summaries
• Each category: 1 paragraph summarizing the line of work + 1-2 sentences positioning this paper
• Do NOT just list papers — synthesize and compare
• End each paragraph with how this paper relates/differs

§3 Method / Preliminaries / Setup:

• Define notation early (reference math_commands.tex)
• Use \begin{definition}, \begin{theorem} environments for formal statements
• For theory papers: include proof sketches of key results in main body, full proofs in appendix
• For theory papers: include a comparison table of prior bounds vs. this paper
• Include algorithm pseudocode if applicable (algorithm2e or algorithmic)
• Target: 1.5-2 pages

§4 Experiments:

• Start with experimental setup (datasets, baselines, metrics, implementation details)
• Main results table/figure first
• Then ablations and analysis
• Every claim from the introduction must have supporting evidence here
• For each major experiment, make explicit what claim it supports and what the reader should notice
• Target: 2.5-3 pages

§5 Conclusion:

• Summarize contributions (NOT copy-paste from intro — rephrase)
• Limitations (be honest — reviewers appreciate this)
• Future work (1-2 concrete directions)
• Ethics statement and reproducibility statement (if venue requires)
• Target: 0.5 pages

Appendix:

• Proof details (full proofs of main-body theorems)
• Additional experiments, ablations
• Implementation details, hyperparameter tables
• Additional visualizations

Step 3.5: Theory Paper Consistency Pass (theory papers only)

Run this pass after drafting all sections and before building the bibliography.

Trigger heuristic: treat the paper as theory-heavy if PAPER_PLAN.md labels it as theory/analysis, or if the drafted sections contain 5 or more formal result environments (\begin{theorem}, \begin{lemma}, \begin{proposition}, \begin{corollary}).

Proof source search: search the workspace for any standalone full-proof source file whose name or contents indicate a canonical proof version (proof, appendix, full, complete, supplement, supplementary). If such a file exists, prompt the user exactly:

Inline full proofs from {file}? [Y/n]

Default to Y.

If the user accepts:

• import the full theorem/lemma statement plus proof block into the appendix source (A_appendix.tex or the appendix file named by the plan)
• use the main-body theorem statement as the canonical public statement; the appendix copy must match it unless the main-body statement is being revised in the same pass
• do not leave placeholders such as "see supplementary proof document" or "proof omitted for brevity"
• preserve theorem labels, equation labels, and proof structure exactly
• keep the main body proof sketches short, but never let the appendix be a sketch-only placeholder when a full proof source exists

If no standalone full-proof source exists:

• use proof sketches only when they are actually written as proof sketches, not placeholders
• do not fabricate an external proof document reference

Restatement audit:

• Compare every theorem/lemma/proposition statement that is restated in the appendix against the main-body version
• Do not diff proof bodies; only audit statements, hypotheses, case splits, quantifiers, domains, notation, variable names, and terminology for defined objects
• Treat stationary vs terminal, changed assumption names, or missing case splits as mismatches unless explicitly documented
• If the appendix needs different wording, add an explicit notation bridge instead of silently renaming concepts
• Resolve all mismatches before Step 4

Empirical motivation: in our April 2026 NeurIPS run, the default behavior generated "see supplementary proof document" placeholders in the appendix. We had to manually pull 1264 lines of full proofs from a standalone proof_dllm_full.tex file. Without this pass, theory papers ship with sketch-only appendices that fail at theory venues.

Step 4: Build Bibliography

CRITICAL: Only include entries that are actually cited in the paper.

1. Scan all citation references in the drafted sections (\citep{}/\citet{} for ML conferences, \cite{} for IEEE venues)
2. Build a citation key list
3. For each citation key:
   • Check existing .bib files in the project/narrative docs
   • If not found and DBLP_BIBTEX = true, use the verified fetch chain below
   • If not found and DBLP_BIBTEX = false, search arXiv/Scholar for correct BibTeX
   • NEVER fabricate BibTeX entries — mark unknown ones with [VERIFY] comment
4. Write references.bib containing ONLY cited entries (no bloat)

Verified BibTeX Fetch (when DBLP_BIBTEX = true)

Three-step fallback chain — zero install, zero auth, all real BibTeX:

Step A: DBLP (best quality — full venue, pages, editors)

# 1. Search by title + first author
curl -s "https://dblp.org/search/publ/api?q=TITLE+AUTHOR&format=json&h=3"
# 2. Extract DBLP key from result (e.g., conf/nips/VaswaniSPUJGKP17)
# 3. Fetch real BibTeX
curl -s "https://dblp.org/rec/{key}.bib"

Step B: CrossRef DOI (fallback — works for arXiv preprints)

# If paper has a DOI or arXiv ID (arXiv DOI = 10.48550/arXiv.{id})
curl -sLH "Accept: application/x-bibtex" "https://doi.org/{doi}"

Step C: Mark [VERIFY] (last resort) If both DBLP and CrossRef return nothing, mark the entry with % [VERIFY] comment. Do NOT fabricate.

Why this matters: LLM-generated BibTeX frequently hallucinates venue names, page numbers, or even co-authors. DBLP and CrossRef return publisher-verified metadata. Upstream skills (/research-lit, /novelty-check) may mention papers from LLM memory — this fetch chain is the gate that prevents hallucinated citations from entering the final .bib.

If the DBLP/CrossRef flow is not enough, load ../shared-references/citation-discipline.md for stricter fallback rules before adding placeholders.

Automated bib cleaning — use this Python pattern to extract only cited entries:

import re
# 1. Grep all \citep{...}, \citet{...}, and \cite{...} from all .tex files
# 2. Extract unique keys (handle multi-cite like \citep{a,b,c} or \cite{a,b,c})
# 3. Parse the full .bib file, keep only entries whose key is in the cited set
# 4. Write the filtered bib

This prevents bib bloat (e.g., 948 lines → 215 lines in testing).

Enforced Bib Hygiene Validation — run immediately after the filtered references.bib is written.

python3 - <<'PY'
import io, json, re, sys, urllib.parse, urllib.request
from pathlib import Path