Workflow: Planning

Turning what research found into steps that can be executed. The emphasis is on assumption surfacing and iterative refinement.

Planning is also a phase within every other workflow.

Starting conditions

Planning starts from research outputs — findings and assumptions — and aims to produce a decomposition that holds under scrutiny. Sometimes the research is formal and the outputs are explicit. Sometimes the planning follows a quick investigation and the inputs are a few observations and a hunch. The method accommodates both, but the confidence in the plan should match the confidence in the research behind it.

The human provides direction: what the goal is, what constraints matter, what’s out of scope. The agent drafts a decomposition. The iteration between them is the planning work.

The decomposition loop

The decomposition is itself a loop. A decomposition that looks clean on first pass often shifts when the steps are structured — dependencies surface, scope questions emerge, assumptions that seemed solid turn out to need validation.

When a decomposition doesn’t hold, the response depends on why. If the research was insufficient — the plan reveals questions that should have been answered already — loop back to research for targeted investigation. If the scope is wrong — structuring reveals the task is larger or differently shaped than expected — reshape scope with the human before continuing. If the steps just need reordering or regrouping, iterate on the decomposition itself.

The human’s role during planning is recognizing which of these is happening. An agent may keep trying to force a decomposition that isn’t working rather than surfacing that the inputs are insufficient — an instance of scope completion bias.

Assumption surfacing

A useful plan has the agents surface the assumptions they’re making so the human can investigate the ones that matter and catch the ones that are wrong before they’re baked into the work.

Planning both surfaces new assumptions — from the decomposition work itself — and pressure-tests assumptions carried forward from research.

Planning as conversation

This phase is a conversation. The agent drafts; the human pushes back on what doesn’t hold and adds context the agent can’t see. This is where the human’s organizational context matters — constraints that aren’t in the code or visible to the agent.

It’s more serial than other phases. The human and agent iterate on a shared decomposition. Where parallelism helps: validating assumptions simultaneously, or having agents draft competing decompositions when the best approach isn’t clear.

Convergence

The decomposition is ready when the steps hold under scrutiny, the assumptions have been triaged and the scope is bounded enough to execute against. If pushing on any part of the plan reopens questions, the loop continues.

When planning is implicit

Sometimes planning doesn’t need its own phase. The research itself reveals what to do and the path is clear enough that a plan adds nothing. A bug investigation that surfaces the root cause often produces the fix as a byproduct.

The signal: if structuring the steps would produce a document that says what everyone already knows, skip it. If the work involves coordination across agents, unknown dependencies, or scope that could expand, make the plan explicit.


This site uses Just the Docs, a documentation theme for Jekyll.