brycewang-stanford/submit

Submit

Final submission gate combining full verification, score enforcement, and submission checklist.

Input: $ARGUMENTS — target journal name (optional).

Workflow

Step 1: Pre-Flight Checks

1. Verify manuscript exists at docs/overleaf/_main.tex
2. Check for existing quality reports in output/log/
3. Verify analysis outputs exist in output/tables/ and output/figures/
4. Check Replication/ directory exists (if not, flag for /data-deposit)

Step 2: Run Full Verification

If /paper-excellence hasn't been run recently (check report dates in output/log/):

• Run the full paper excellence review (econometrics, code, paper, bibliography)

Step 3: Run Replication Audit

If Replication/ exists:

• Run /audit-replication Replication/

Step 4: Score Gate

Check against thresholds:

| Requirement | Threshold | Status | |-------------|-----------|--------| | Aggregate score | >= 90 | PASS/FAIL | | Econometrics component | >= 80 | PASS/FAIL | | Code component | >= 80 | PASS/FAIL | | Paper component | >= 80 | PASS/FAIL | | Replication (if exists) | >= 8/10 checks | PASS/FAIL |

If any requirement FAILS: List specific blocking issues and stop. Do not generate submission materials.

Step 5: Generate Submission Package

If all gates pass:

1. Cover letter draft (save to output/log/cover_letter_[journal]_[date].tex):

   • Addressed to current editor
   • 1 paragraph: what the paper does (sewage spill capitalisation using EDM data)
   • 1 paragraph: why this journal (fit with environmental/housing economics)
   • 1 paragraph: originality confirmation
   • Suggested referees (3-5, from /target-journal if available)

2. Final checklist (save to output/log/submission_checklist_[date].md):

   # Submission Checklist: [Journal]
   
   ## Manuscript
   - [ ] Title page with affiliations and contact info
   - [ ] Abstract within word limit
   - [ ] JEL codes (2-3): Q53, R31, Q58
   - [ ] Keywords: sewage spills, house prices, hedonic pricing, environmental disamenity, EDM
   - [ ] Journal formatting guidelines followed
   
   ## Data and Code
   - [ ] Replication package assembled
   - [ ] Data availability statement in manuscript
   - [ ] Restricted data flagged (Land Registry, Zoopla)
   
   ## Quality Gates
   - [ ] Aggregate score: XX/100 (>= 90 required)
   - [ ] All components >= 80
   - [ ] No unresolved CRITICAL issues
   
   ## Submission
   - [ ] Upload manuscript PDF
   - [ ] Upload replication package (if required)
   - [ ] Upload cover letter
   - [ ] Submit via [portal]
   

Step 6: Present Results

# Submission Report
**Date:** YYYY-MM-DD
**Target Journal:** [name]
**Aggregate Score:** XX/100

## Gate Status: [PASS / FAIL]

| Component | Score | Threshold | Status |
|-----------|-------|-----------|--------|
| Aggregate | XX | >= 90 | ... |
| Econometrics | XX | >= 80 | ... |
| Code | XX | >= 80 | ... |
| Paper | XX | >= 80 | ... |
| Replication | X/10 | >= 8/10 | ... |

## Generated Materials
- Cover letter: output/log/cover_letter_*.tex
- Checklist: output/log/submission_checklist_*.md

## Remaining Steps (manual)
1. Review and customise cover letter
2. Upload to [submission portal]
3. Enter suggested referees
4. Submit

Principles

• This is the final gate. Score >= 90 with all components >= 80.
• If it fails, stop. List blocking issues. Don't generate submission materials for a failing paper.
• Cover letter is a draft. The user must review and customise before sending.
• Manual submission. This skill prepares materials but does NOT submit to journals.
• Be realistic. If the paper isn't ready, say so clearly.