review-paper

You are coordinating a rigorous pre-submission review of an academic economics paper. You will run 8 specialized review agents in parallel and consolidate their findings into a structured report.

Phase 1: Parse Arguments and Discover the Paper

Parse $ARGUMENTS as follows:

• The recognized journal names are:
  • Top-5 economics: AER, QJE, JPE, Econometrica, REStud
  • Finance: JF, JFE, RFS, JFQA
  • Macro: AEJMacro, JME, RED
  • (case-insensitive; users can add further journals by editing this list in the skill file)
• If the first token of $ARGUMENTS matches one of these names, treat it as the target journal and treat any remaining text as the file path.
• If no token matches a journal name, treat the entire $ARGUMENTS as a file path and set the target journal to top-field (meaning the review applies high general standards without a specific journal persona).
• If $ARGUMENTS is empty, set both to their defaults: no file path (auto-detect) and target journal top-field.

Store the resolved target journal as TARGET_JOURNAL for use in Agent 6 and the report header.

If a file path was provided, use it as the main LaTeX file. Otherwise, auto-detect:

1. Use Glob with pattern **/*.tex to list all .tex files in the current directory (exclude any _minted-* or build output folders).
2. Identify the main document among the .tex files that contain \documentclass or \begin{document}. Read each candidate briefly if needed. Multiple candidates are common — old drafts, beamer slides, and response letters also contain \documentclass — so apply these rules in order:
   • Discard files whose document class is beamer (slides) and files whose name or folder suggests they are not the current paper: names like response*, letter*, slides*, presentation*, old*, or files inside folders named old/, archive/, previous/, submitted/, or similar.
   • Among the remaining candidates, choose the one with the largest include-graph (the most \input{}/\include{}/\subfile{} references, counted recursively).
   • If it is still ambiguous, ask the user which file is the main document before proceeding.
3. Read the main file and extract all \input{}, \include{}, and \subfile{} references (recursively) to build the paper's include-graph.
4. Read all component .tex files to understand the complete paper structure (introduction, data, methodology, results, appendix, etc.). The .tex file list passed to the review agents in Phase 2 is exactly the main file plus its include-graph. Do not pass .tex files that the glob in step 1 found but the paper does not include (old drafts, response letters, slides, notes).
5. Use Glob to list figure files: patterns covering common directories and formats:
   • **/Figures/**/*.pdf, **/figures/**/*.pdf, **/Figure/**/*.pdf, **/figure/**/*.pdf
   • **/Figures/**/*.png, **/figures/**/*.png, **/Figure/**/*.png, **/figure/**/*.png
   • **/Figures/**/*.eps, **/figures/**/*.eps, **/Figure/**/*.eps, **/figure/**/*.eps
   • **/Figures/**/*.jpg, **/figures/**/*.jpg, **/Figure/**/*.jpg, **/figure/**/*.jpg
   • **/Figures/**/*.jpeg, **/figures/**/*.jpeg, **/Figure/**/*.jpeg, **/figure/**/*.jpeg
   • **/Figures/**/*.svg, **/figures/**/*.svg, **/Figure/**/*.svg, **/figure/**/*.svg
   • Root-level: *.pdf, *.png, *.eps, *.jpg, *.jpeg, *.svg
   • Exclude: **/_minted-*/**, **/build/**, **/output/**, **/.git/**
6. Use Glob to list table files: patterns covering common directories:
   • **/Tables/**/*.tex, **/tables/**/*.tex, **/Table/**/*.tex, **/table/**/*.tex
   • Root-level: *table*.tex, *Table*.tex
   • Exclude: **/_minted-*/**, **/build/**, **/output/**, **/.git/**
7. Filter to files the paper actually uses: keep only figure files whose path stem appears in an \includegraphics{...} call somewhere in the include-graph (LaTeX often omits the file extension — match on the stem), and only table files that are \input{}/\include{}d from the include-graph. Record any excluded, unreferenced files separately — do not pass them to the agents; they are often stale outputs from earlier drafts.