PaperLab Chapter Flow Editor
When to Use
USE WHEN: improving chapter structure, transitions, case continuity, or the
overall reading path of a PaperLab book. This skill is useful after source
coverage, figure generation, and notebook execution have already produced enough
material, but before final typesetting.
DO NOT USE for: rewriting scientific claims without validation, changing
numerical results, or deleting pedagogical repetition without review.
Chapter Arc
Each chapter should have a visible arc:
- Opening contract: what engineering decision or student capability the
chapter supports.
- Concept foundation: the minimum theory, terminology, and physical logic.
- Engineering method: equations, workflow, or design procedure.
- Computational or case example: a worked use of the method.
- Decision consequence: what the result changes for concept selection,
operation, risk, or economics.
- Transfer forward: how the output is reused in later chapters.
Flow Checks
Review the chapter for:
- abrupt section starts that need a one-sentence bridge,
- equations introduced before variables or intuition,
- figures placed before the concept needed to read them,
- repeated background that should become a cross-reference,
- case-study material that conflicts with the canonical case thread,
- summaries that repeat headings instead of synthesizing decisions,
- generated source or lecture-checkpoint texture in the main reading path.
Case Thread Pattern
When a recurring case is used across chapters, keep a small handoff pattern:
**Case handoff.** This chapter uses <input> from Chapter N, calculates <result>,
and carries <output> forward to Chapter M where it becomes <later use>.
Use this sparingly. One handoff per case-heavy chapter is usually enough.
Repetition Policy
Some repetition is useful for students; uncontrolled repetition is not. Keep:
- definitions that prevent a chapter from becoming inaccessible,
- summaries in review and exam-preparation chapters,
- short reminders before major calculations.
Compress or move:
- duplicate background paragraphs,
- repeated slide-topic inventories,
- repeated captions or figure explanations,
- repeated "NeqSim implementation" boilerplate that does not add chapter-specific value.
Output Pattern
## Chapter Flow Review: <chapter>
- Status: ready | minor-revision | major-revision
- Chapter arc: <one-sentence assessment>
- Strongest transition: <section or paragraph>
- Weakest transition: <section or paragraph>
- Repetition to keep: <why it helps students>
- Repetition to compress: <what to replace with cross-reference>
- Case-thread action: <none or specific handoff edit>
Editing Rules
- Preserve citations, figure references, equation labels, and NeqSim traceability markers.
- Do not move figures away from their discussion blocks.
- When removing repeated text, keep one canonical explanation and replace the
secondary copy with a short cross-reference.
- Prefer one clean bridge sentence over a long transitional paragraph.
1---2name: paperlab-chapter-flow-editor3description: Edit PaperLab book chapters for narrative flow, chapter arc, section order, transitions, recurring case threads, and controlled repetition. Use when a chapter is technically correct but still feels like assembled lecture notes.4---56# PaperLab Chapter Flow Editor78## When to Use910USE WHEN: improving chapter structure, transitions, case continuity, or the11overall reading path of a PaperLab book. This skill is useful after source12coverage, figure generation, and notebook execution have already produced enough13material, but before final typesetting.1415DO NOT USE for: rewriting scientific claims without validation, changing16numerical results, or deleting pedagogical repetition without review.1718## Chapter Arc1920Each chapter should have a visible arc:21221. **Opening contract**: what engineering decision or student capability the23 chapter supports.242. **Concept foundation**: the minimum theory, terminology, and physical logic.253. **Engineering method**: equations, workflow, or design procedure.264. **Computational or case example**: a worked use of the method.275. **Decision consequence**: what the result changes for concept selection,28 operation, risk, or economics.296. **Transfer forward**: how the output is reused in later chapters.3031## Flow Checks3233Review the chapter for:3435- abrupt section starts that need a one-sentence bridge,36- equations introduced before variables or intuition,37- figures placed before the concept needed to read them,38- repeated background that should become a cross-reference,39- case-study material that conflicts with the canonical case thread,40- summaries that repeat headings instead of synthesizing decisions,41- generated source or lecture-checkpoint texture in the main reading path.4243## Case Thread Pattern4445When a recurring case is used across chapters, keep a small handoff pattern:4647```markdown48**Case handoff.** This chapter uses <input> from Chapter N, calculates <result>,49and carries <output> forward to Chapter M where it becomes <later use>.50```5152Use this sparingly. One handoff per case-heavy chapter is usually enough.5354## Repetition Policy5556Some repetition is useful for students; uncontrolled repetition is not. Keep:5758- definitions that prevent a chapter from becoming inaccessible,59- summaries in review and exam-preparation chapters,60- short reminders before major calculations.6162Compress or move:6364- duplicate background paragraphs,65- repeated slide-topic inventories,66- repeated captions or figure explanations,67- repeated "NeqSim implementation" boilerplate that does not add chapter-specific value.6869## Output Pattern7071```markdown72## Chapter Flow Review: <chapter>7374- Status: ready | minor-revision | major-revision75- Chapter arc: <one-sentence assessment>76- Strongest transition: <section or paragraph>77- Weakest transition: <section or paragraph>78- Repetition to keep: <why it helps students>79- Repetition to compress: <what to replace with cross-reference>80- Case-thread action: <none or specific handoff edit>81```8283## Editing Rules8485- Preserve citations, figure references, equation labels, and NeqSim traceability markers.86- Do not move figures away from their discussion blocks.87- When removing repeated text, keep one canonical explanation and replace the88 secondary copy with a short cross-reference.89- Prefer one clean bridge sentence over a long transitional paragraph.
equinor