Workflow & Best Practices
Choose the smallest module sequence that fits the user request.
Common Review Paths
- Build/debug path:
compile->bibliography - Prose quality path:
grammar->sentences->logic - Submission hygiene path:
format->figures->title - Language cleanup path:
translationordeai, thenexpressionif tone polish is still needed - Experiment scrutiny path:
experimenton its own unless the user also asks for logic or figure review
Best Practices
- Route to one concern at a time instead of invoking every module by default.
- Preserve
\cite{},\ref{},\label{}, math, and custom macros unless edits are explicitly requested. - Treat script output as raw analysis; convert it into concise LaTeX-friendly findings for the final response.
- Use version control when the user asks for source edits after the review phase.
Revision Order (logic → sentence → lexical, do not reverse)
When a request needs more than one polish pass, apply changes in this order and do not invert it:
- Argument / logic — paragraph order, missing or duplicated main messages, section transitions.
- Sentence structure — split >40-word sentences, passive→active, front-load high-information content.
- Lexical / formatting — AI-tone words, number/unit format, en-dash vs hyphen, acronym consistency.
Why the order is fixed: polishing a sentence's wording (step 3) before fixing structure (step 1) wastes the effort when step 1 later deletes or merges that paragraph. Coarse-to-fine is several times more efficient.