Optimize
Run a final audit for a draft or rewrite and then apply the highest-leverage fixes.
Inputs
- A local article file, usually from
drafts/orrewrites/ - Optional
site_urlor SERP data path if available
Required Actions
- Run:
.venv/bin/python scripts/run_optimize_pipeline.py <article-file>
- Read the generated report:
drafts/optimization-report-<article>.mdor the same directory equivalent
- Apply the important fixes directly to the article
- Re-run the optimize pipeline if the changes are substantial
Optimization Priorities
- Missing or weak keyword placement
- Meta title / description quality
- Readability problems
- Thin sections
- Missing links
- Structure issues
- Low composite quality score
Codex-Specific Notes
- Do not depend on implicit agent execution from the Claude version.
- The script provides deterministic analysis; Codex should provide the judgment and rewriting.