Validate that a study folder is structurally complete before marking COMPLETE. Checks README sections, IMPROVEMENTS.md tags, artifacts, report sections, figures, and reproducibility notebook. Use when: finishing a study, before writing REVIEW_REQUEST.md, or auditing an existing study.
Run through every check below. Report each as PASS or FAIL with a brief explanation.
Verify the study README.md contains all mandatory sections:
## Problem Class — contains one or more of: OPT, REP, DES, ANA## Motivation — non-empty## Goals — numbered list, at least one goal## Methods — references cqed_sim modules/functions## Analytic Preliminary — present, starts from the first-principles model when feasible, and states controlled approximations (even if it explains why no useful analytic result exists)## cqed_sim Gap Analysis — present## Assumptions — non-empty## Compute & Resource Strategy — present## Expected Outcomes — non-empty## Known Limitations — present## Validation — contains three checkboxes (sanity, convergence, literature)## Status — one of ACTIVE, COMPLETE, BLOCKED## Critical Gaps (P1) section## Recommended Improvements (P2) section## Nice-to-Haves (P3) section## What Was Tried and Did Not Work section## Compute & Resource Notes sectionartifacts/ directory exists and is non-emptystudy_name, date_created, descriptiondata/ directory existsfigures/ directory exists and is non-empty.png and .pdf formatsfig1.png)report/report.tex existsreport/references.bib existsreport/report.pdf exists and is non-zero size\appendix)snake_case or camelCase identifiers in main text prosescripts/reproducibility_notebook.ipynb exists## Validation section has at least two checks marked [x]## Study Validation Report: <study_name>
**Overall:** PASS / FAIL (N of M checks passed)
### Failures
| Check | Section | Issue |
|-------|---------|-------|
| ... | ... | ... |
### Warnings
- ...
### Recommendation
READY FOR REVIEW / NEEDS WORK (list specific items to fix)
If any check fails: