Vahtian

Writing

Agile writing. Four decisions that finish a paper

A stalled paper is usually stuck on one decision, not on your writing.

It rarely announces itself as a decision problem. It feels like you have simply forgotten how to write. Most of the time, that is not what has happened. The writing stopped because the paper is waiting for a decision you have not made yet.

RecognitionIt is Tuesday evening

You promised yourself that tonight you would finally work on the manuscript. The document opens where you left it three weeks ago. You read the first paragraph. You change a couple of words. You wonder whether the introduction should really begin somewhere else. You open another paper, just to check one thing.

Forty minutes later you have changed three sentences, deleted two, and answered one email. Nothing important has moved. That is painfully familiar. It feels as though you cannot write anymore. Usually, that is not what happened. The writing stopped because the paper is waiting for a decision, and until that decision is made, no amount of sitting at the desk will move it.

What I noticedThe fast papers and the slow papers

For a long time I thought slow writing meant I lacked discipline. Then I noticed something odd. On some papers I could write two thousand words in a weekend. On others I spent the same weekend rewriting a single paragraph, and hating all of it.

The difference was almost never motivation. The fast papers had already answered the important decisions before I opened the document: what the paper was about, which result carried it, where it ended. The slow papers were still asking questions I had not admitted I was avoiding. Once I saw that, being stuck stopped feeling like a character flaw and started feeling like a diagnosis.

The problemThe blank page is often an innocent bystander

Academic writing advice usually assumes the paper already knows what it wants to say. Write every morning. Do not edit while you draft. Lower your standards and fix it later. Those are useful habits once the argument exists. They do almost nothing when the manuscript itself is undecided.

A confused paper produces confused writing. It feels like a writing problem, so you reach for more discipline, more reading, more hours in the chair. The real gap is upstream of the sentence. Some decision about what the paper is has not been made, and every paragraph you try to write inherits that confusion. The blank page takes the blame for a problem it did not cause.

This matters because the fix is different. You cannot grind your way past a missing decision. You can only make it. Naming the decision turns a vague sense of being behind into one concrete thing to do next, which is a far easier place to begin than shame.

What is agile writing?

Agile writing is a decision-centred framework for scientific writing. It helps researchers identify whether a manuscript is being held up by its backbone, focus, working process, or readiness for the next stage. The researcher then chooses one bounded obstacle to resolve, writes to test that resolution, and reassesses what is blocking progress next.

It does not assume that every writing problem is a decision problem. Writing itself remains part of the thinking, and some obstacles arise from data, collaborators, supervision, workload, or uncertainty that cannot be solved by the writer alone.

The four areasWhat a manuscript rests on

A paper that moves tends to be settled in four areas. Each one is a decision more than a skill, and each one shows symptoms you will recognise long before you would think to name the area. When a draft is stuck, one of these is usually the reason.

Backbone

The symptoms are familiar. You rewrite the introduction every week and still dislike it. Every result seems equally important, so none of them leads. A reviewer asks what the paper is actually about, and the question stings because you are not certain. You cannot say the manuscript in one sentence without it turning into three.

Those are rarely writing problems. They are backbone problems. The backbone is the spine the paper hangs on: one research question, one most-important result, and a main message you could state in a single sentence, together with a clear sense of what the paper leaves out. When the backbone is unset, every sentence feels forced, because there is nothing underneath for it to serve. Most researchers realise this eventually: every paper is really saying one thing, and the difficulty is deciding what that one thing is.

Focus

Many manuscripts quietly try to become two papers. Halfway through drafting you remember another interesting analysis. Then a subgroup that seems a shame to leave out. Then a second hypothesis you already have the data for. Soon four stories are competing for the same abstract, and the reader cannot tell which one you actually care about.

Readers rarely wish a paper had tried to do more. They notice immediately when it tries to do too much. Focus is the decision that one table or figure carries the message, that the other results are ranked behind it, and that not every interesting finding belongs in this paper. When focus is unset, the structure wobbles and the writing order keeps changing under you.

Process

I almost never tell a student to write the discussion. That task is too large to start and too vague to finish, so it sits on the list for weeks. Explain why Figure 2 differs from Smith and colleagues is small enough to finish in one sitting, and finishing it produces momentum that write the discussion never will.

Process is the decision to work in tasks that fit inside a single session, to always know what the next one is, and to keep your text, tables, and comments in one place. When the process is unset, even a clear paper moves in fits and starts, because every sitting begins by rediscovering where you were. Momentum is easier to keep than to create, so my aim at the end of every writing session is not to finish the paper. It is to leave the next decision obvious.

Readiness

Some manuscripts are finished months before they are submitted. The authors simply do not believe it yet. Another adjective is polished. Another reference is added. Another colleague is asked to take a look. Slowly, perfection takes the place of progress, and the paper that was ready in March is still on the desk in June.

Readiness is the decision to tell a necessary fix from a cosmetic one, to let feedback lead to a bounded round rather than an open one, and to give the manuscript a clear next destination. It is partly a scientific judgement. It is also, honestly, a decision you have to let yourself make. When readiness is unset, a nearly finished paper keeps circling, because nothing tells you it is time to let it go. At some point the manuscript stops improving and starts hiding.

Writer's blockThree myths worth dropping

Most of what we believe about being stuck points in the wrong direction. Three beliefs do the most damage.

  • I need more motivation. More often you need one scientific decision. Motivation tends to return on its own once the decision is made, because there is finally something concrete to do.
  • I need to read more papers. Many researchers already know more than enough to write. Another week in the literature often feels productive because it postpones making the difficult decision.
  • I should start with the introduction. Most introductions become far easier once the results have found their story. The introduction is usually the last part to settle, not the first.

From the supervisor’s chairThe question I ask first

“What decision are you avoiding?” the question that restarts more drafts than any deadline

When a student’s writing has stalled, I have learned not to open with “why haven’t you written.” I ask what decision they are avoiding. Within a few minutes we usually find it. Sometimes the research question is still moving. Sometimes two analyses are competing for the lead. Sometimes the conclusion no longer matches the results, and some quiet part of the author already knew. Once that decision is made, the writing tends to restart surprisingly quickly. The block was never really about words.

Find your own bottleneckTwo free self-checks

The self-check is not a personality test. It does not tell you whether you are a good researcher, and it does not grade your manuscript. It asks sixteen practical questions about the paper in front of you right now, and makes the bottleneck visible: where the work is probably waiting. Many people find that the problem they had filed under procrastination is really one missing decision.

You rate each statement, the result is computed in your own browser, and nothing is uploaded. It is a starting point for a conversation with yourself or a supervisor, not a verdict on the paper.

After the checkChange one area, not all four

The point of naming a bottleneck is to stop working on everything at once. If the backbone is the low area, decide the question and the one result before you touch the introduction again. If it is process, break the next session into a single task you can actually finish, instead of reopening the whole document. One area at a time is slower to plan and much faster to finish.

The pointThe writing moves again

Scientific writing is not the act of producing sentences. It is the act of making defensible decisions, then explaining them clearly. The sentences come afterwards.

Every finished paper contains thousands of words, so the problem was never that you could not produce them. Papers rarely stall because the author cannot write. They stall because one important decision is still standing in front of the next sentence. Agile writing is the habit of removing one obstacle at a time. Then the writing moves again.

One more thing has mattered in my own writing more than any method. I write best with one particular collaborator. Not because we think alike, but because we think differently. My strengths cover their blind spots, and theirs cover mine. The best writing partners do not make the work easier. They make the thinking better. Every researcher deserves someone who asks the question they were not about to ask themselves.

Related guidesRead next