Skip to main content

Primer

Agents versus folders: why your AI workflow keeps breaking.

You set up a multi agent system three months ago. Now half the time it produces brilliant output and half the time it loops in confusion. What changed? Probably nothing. The system was always going to drift. The structural fix is not a better framework. It is folders.

The hook

Where this shows up.

The first time you wired up a multi agent setup, the demo was magical. Three agents handing off work, each playing a specific role. By month three, the magic is gone. Output quality is unpredictable. Sessions that used to take twenty seconds now take two minutes and produce something you have to fix anyway.

The temptation is to add another framework, swap models, or rebuild the orchestration layer. None of those fix the underlying problem. The problem is structural, and the fix is older than any agent framework.

The misconception

That the model got worse, or you need a more sophisticated agent framework.

What most people believe

The model is the same. The framework is the same. What changed is that your project accumulated state, and the system has nowhere durable to anchor that state. Each session reinvents context from scratch, picks up partial cues from previous chat history, and produces output shaped by whatever fragment it happened to read.

No amount of framework sophistication fixes a system whose memory is a chat window. You need state to live somewhere durable, structured, and inspectable. Like a folder.

The better model

Replace the framework with a folder.

What actually works

The structural problem is not the agent. It is the absence of structure. Agents that share state through chat history have nothing durable to anchor against. Each session reinvents context. The fix is to put the state in files.

  1. 01

    The folder is the source of truth.

    Project context, decisions, configuration, and outputs all live in numbered stage folders. The activity log explains what was done last session. The CONTEXT.md files explain what each stage is for.

  2. 02

    One agent. The right files. The right moment.

    Instead of three agents debating, give one orchestrating agent access to the right files at the right stage. The folder structure is the routing logic.

  3. 03

    Resumability is automatic.

    Any new agent or human can open the folder and see exactly where the project stands. No briefing required. No chat history to dredge through. The folder explains itself.

Three decisions

Make these calls differently this week.

01

Move every recurring workflow to a folder structure.

If you run a workflow more than twice, it gets a folder. Stage folders for the steps. CONTEXT.md for each stage. Activity log at the root. Every artifact lives on disk.
02

Give one agent the right files at the right moment.

The folder structure is the routing logic. The agent reads the relevant stage folder. It does not need to know about future stages or past stages until those stages are reached.
03

Kill any multi agent framework whose value can be reproduced by folders.

If the framework's only job is to pass context between agents, a folder does that job for free. Engineering complexity without proportional capability gain is waste.

How ByteWorthy uses this

What this looks like in our work.

We wrote a longer manifesto on this with five mental models, a seven question decision framework, and a free starter kit you can drop into your project tonight.

Use the kit. Modify it. Ship it. No email gate, no follow up sequence. If you would rather have us build the folder system for your business than build it yourself, that is what our Build engagement is for.

Keep reading

Related primers and pages.

Build something your practice owns.

Book a free call