--- name: writing-process description: Help a researcher turn notes, figures, a story arc, an outline, or a partial manuscript into a scientific paper through staged writing. Use to choose what to write next, build or revise the paragraph-level outline, draft a section from supplied findings, or revise a draft whose structure or length needs work. --- # Writing Process - Start with the author's material and the task they want to finish. - **If they have an outline and ask for a Results paragraph:** draft that paragraph. - **If they ask where to begin:** identify the next writing decision and help them make it. - Use the [19 writing lessons](references/lessons.md) to guide that work. - **If `story_arc.md` or a `claim-review` review exists:** build on its claims, their reviewed scope, and its figure roles; do not rewrite `story_arc.md`. ## Choose the starting point | What the author brings | What to work on now | | --- | --- | | Loose notes, a mind map, or an opening they keep rewriting | Order the ideas, expand the whole outline one level at a time, and give each planned paragraph a purpose. For a perspective or essay, use ideas and supporting arguments as the outline levels. Use lessons 1–6. | | Results or figures for a primary data paper | Use lesson 7 to choose a drafting stage. Work from the figures already available. If the titles are settled, use them as Results headings and draft from the corresponding panels. Use lessons 8–13. | | A draft with an unclear beginning or ending, excess length, or ideas that depend on each other | Find the passage where the reader loses the argument. Revise it, suggest a specific cut, or briefly introduce interdependent concepts before returning to their details. Use lessons 14–19. | ## Work with the author - **For a primary data paper:** Michael Levin's staged writing sequence is (1) story, outline, and working Abstract, (2) figures, starting with their titles, (3) Results, (4) Methods and Acknowledgments, (5) Discussion, and (6) Introduction. - Follow the author's requested stage and build on their completed work. - A figure title states one supported finding; a Results subsection can use several figures to answer one question. - Use the author's scientific story and the evidence they supply. - **If the proposed title asserts a mechanism but the figure establishes only a difference between conditions:** write a title for that difference. - Identify the unresolved question if it matters to the next paragraph. - Preserve missing statistics, citations, or contributor details as explicit gaps. - Ask for additional information only where it changes what can be written. - Return something the author can use in the manuscript, such as ordered paragraph points, figure titles, section prose, or a specific cut with its reason. - When useful, name the next writing action. - **At the end of a full draft:** compare the working Abstract with the finished Results and Discussion, correct any claims that have changed, and apply the venue's length limit. - Once the requested writing step is delivered, stop; do not draft further sections unasked. ## Build the paragraph-level outline - Own `outline.md`: create it from the [outline template](assets/outline-template.md) or revise it in place, preserving the author's material. - Turn the confirmed story arc, or the author's confirmed argument, into the chosen manuscript sections in order; narrative steps need not map one-to-one to sections. - Write one bullet per planned paragraph stating its main point, with the supporting calculation, simulation, or measurement on the same bullet where useful. - Place each figure at its point in the argument with its number, a bounded conclusion-style title, its source file or planned status, and a draft caption covering panels, quantities, conditions, units, and statistical definitions; mark unknown details `UNKNOWN`. - Keep planning notes, claim checks, and open decisions in the template's supporting-notes sections, not in the manuscript outline. - **Early outline:** may include hypotheses and planned work, labeled as such. **Pre-draft outline:** contains completed results and bounded claims only. ## Call on Claim Review only when needed - Call `claim-review` when a claim appears that was not reviewed, when a title, sentence, or outline point is worded more strongly than its reviewed status, or when the underlying evidence changed. - If no review exists, proceed with the author's claims and label them unreviewed; do not run a review unasked. ## Use a slide visual when it helps the current lesson - The lesson guide pairs seven diagrams with the writing decisions they illustrate: - lessons 5–6 when moving from a mind map to an outline and from outline points to paragraphs; - lesson 7 when choosing drafting order; - lessons 9–10 when turning figure titles into Results; - lesson 14 when checking section shapes; - lesson 17 when introducing interdependent ideas. - **When a diagram helps:** link to the corresponding slide in the lesson guide and explain what to look for in the author's material. - **When the author simply needs prose or a cut:** deliver it directly. - The lessons adapt Michael Levin's personal writing method. [Essay](https://thoughtforms.life/how-i-write-papers/) · [Companion slides](https://thoughtforms.life/wp-content/uploads/2026/10/add-to-Substack-post.pdf)