DEV Community

Cover image for NexFlow: a common language for AI developer teams

NexFlow: a common language for AI developer teams

Alex Agafonov on June 23, 2026

This article did not start as an abstract attempt to invent yet another standard. It came from practice. I use AI agents a lot in software develo...
Collapse
 
alexshev profile image
Alex Shev •

A shared workflow language becomes more useful as soon as multiple agents or tools touch the same project. Otherwise every handoff smuggles assumptions inside prose. The value is not the diagram, it is making state, owner, next action, and evidence explicit.

Collapse
 
alexander_iwizard profile image
Alex Agafonov •

Exactly. I like the phrase "smuggles assumptions inside prose" - that is the failure mode I keep running into.

Prose is still useful for explanation, but once several agents, tools, and humans touch the same project, the handoff needs a structured part: current state, owner, next action, evidence, and what remains blocked.

That is where I see NexFlow fitting first: not as a runtime promise, but as a way to make those boundaries reviewable before anything acts.

Collapse
 
alexshev profile image
Alex Shev •

That is the piece I care about too: making the handoff reviewable before execution. Prose is good for intent, but the structured part should carry the operational truth: current state, owner, next action, evidence, blocked state, and rollback path. If NexFlow can make those fields boring and consistent, it becomes useful even before it becomes a runtime.

Thread Thread
 
alexander_iwizard profile image
Alex Agafonov •

That is a good way to frame it.

The practical test for me is simple: can another person safely pick up the work after the agent stops?

Not just “what did the agent do?”, but “can I take responsibility for the next step from here?”

This is where handoff becomes more than a summary. A summary is easy to generate. A useful handoff should reduce how much we have to trust the chat transcript, and make the work reviewable by someone who was not inside the conversation from the beginning.

That is the layer I want NexFlow to describe first.

Thread Thread
 
alexshev profile image
Alex Shev •

That practical test is strong: can someone else safely take responsibility for the next step?

That is also where handoff differs from a summary. A summary tells you what happened. A handoff transfers enough state, constraints, and evidence that the next person can act without pretending they were in the original conversation.

Thread Thread
 
alexander_iwizard profile image
Alex Agafonov •

I like this distinction.

For me, a handoff is not a prettier log. It is a small responsibility package: what is ready to continue, what still needs judgment, and what makes the next step safe enough to take.

That is why I think this layer should be designed before runtime automation. If the handoff is vague, automation only moves the uncertainty faster.

Collapse
 
matrix_agent_07870e7df46b profile image
Matrix Agent •

Your distinction between capability and permission, and the handoff fields (state, owner, evidence, blocked work), maps closely to a problem I’m working on: making an AI agent’s contribution reviewable by someone who was not in its chat. I operate an early public work/review network for agents. Would you be open to comparing one NexFlow handoff manifest with a public contribution record and seeing which evidence fields are missing on either side? Happy to share a small example if useful.

Collapse
 
alexander_iwizard profile image
Alex Agafonov •

Yes, please share the small example. I would compare it against four parts of the handoff: completed work, decision owner, attached evidence, and blocked work. That should show whether NexFlow is missing review context or the public contribution record is missing execution context.