{"slug": "a-shared-folder-doesn-t-hand-work-between-agents-a-progress-log-does", "title": "A shared folder doesn't hand work between agents. A progress log does", "summary": "A developer tested the claim that a shared folder of agent instructions (AGENTS.md, CLAUDE.md) lets agents from different apps hand off work seamlessly when one hits a usage limit, and found it does not hold: rules files describe how to work, not where the last session stopped. Running a git-backed task board with roughly 27 parallel workers on one account, the developer found that when the limit cut all workers at once, only work already written to disk survived — 5 partial batches and 3 partial reviewer verdicts — and now caps parallel workers at 18. The recommended practice is to persist partial results and progress notes to disk and commit by path so the next session can resume.", "body_md": "When an agent hits its usage limit mid-task, the next agent, in the same app or another one, knows nothing about what just happened. It knows only what the previous session wrote down. A shared folder of rules does not change that, because rules are not state.\n\nA recent video promised the opposite. Put one common folder of instructions in the repository, it said, and agents from different apps will pick up each other's work without a gap when one runs out of quota. We checked the claim on 6 November. It does not hold, and the reason fits in one line: AGENTS.md and CLAUDE.md tell a session how to work, not where the last one stopped.\n\nSay the limit hits at 02:14, halfway through a refactor. The session dies. Its context dies with it: what it tried, which tests it ran, which file it was halfway through. A new session opens and reads the rules folder. Now it knows the code style, the test command and the branch policy. It does not know the task is half done.\n\nAnthropic describes the version that works in its engineering write-up on harnesses for long-running agents (November 2025). Every session starts the same way. It reads a progress file (`claude-progress.txt` in their harness), reads the git log, then picks one unfinished feature and works on that. Continuity is not something the tools provide. The previous session either kept up the habit of writing things down or it didn't.\n\n``` php\nrules  (AGENTS.md, CLAUDE.md)        -> how to work       -> survives anything, says nothing about now\nstate  (progress log, task list,     -> where we stopped  -> exists only if the last session wrote it\n        git commits)\n```\n\nThe claim has one true part. A shared instructions file can be read by more than one tool, so rules do travel between apps. That is useful. It is not a handover.\n\nWe run krilal board, a task board that models work through on their own. One model executes, another reviews, and the board itself is a git repository: a card is a markdown file, and moving a card is a commit. That makes it a fair test bench for exactly this question.\n\nAt one point we had about 27 parallel workers running on one account. The limit cut all of them at once. Then it happened again, right after. No agent handed anything to another agent, because no agent was left to hand it to.\n\nWhat survived was what had already been written to disk. Workers that saved results as they went left 5 partial batches and 3 partial reviewer verdicts behind, and that work was not lost. We now cap parallel workers at 18.\n\nKeep two numbers apart. About 27 is how many workers went down together. Eight is how many partial results the disk kept. The second number is the whole argument of this piece.\n\nNone of these is a product feature. They are rules we keep in our own workers. This is our practice, not a standard.\n\n**1. Write partial results to disk as you go.** A result that lives only in context disappears when the session is cut. A result in a file gives the next session somewhere to start.\n\n```\nfor item in batch:\n    result = process(item)\n    append(results_file, result)          # written now, not at the end\n    update(progress_file, last_done=item.id)\n```\n\n**2. Commit by path, and leave a note for the next session.** A commit is the one record the next session is sure to read. We stage only the files the task touched, so the history shows exactly what this session changed and nothing else. An illustrative example:\n\n```\ngit add src/billing/invoice.ts tests/invoice.test.ts\ngit commit -m \"invoice: totals done; rounding still open (see progress.md)\"\n\n# progress.md\n- [x] totals\n- [ ] rounding\n- next: run tests/invoice.test.ts first; two cases were failing at stop\n```\n\n**3. Keep the alarm outside the agents.** This is the one people miss. A thread in r/AI_Agents (21 September) described an account limit that stopped every scheduled task for 19 hours. That included the task whose job was to report failures. In our words, the rule the thread landed on is this: whatever tells you an agent has failed cannot itself be an agent on the same account. The thread's fixes were a heartbeat that runs outside the agents and separate keys for the tasks that must not stop.\n\n``` php\nagents    -> write a heartbeat file every N minutes\nwatchdog  -> plain cron job: no model, separate credentials\n          -> if the heartbeat is older than 2 x N: send an alert\n```\n\nThe watchdog is boring on purpose. It has no model, no shared limit and nothing to run out of.\n\nSuppose a tool shipped real session state: the open task, the last command, the partial output. Suppose an agent from a different vendor could read that state and resume from it without anyone writing it down. Then the claim would hold. We haven't seen this yet. If we do, we will say so here, at the same length.\n\nIn our view, handover is a discipline, not a feature. The cost is real but small:\n\nIn return, a limit at 02:14 should cost you the last few minutes of work, not the whole night.\n\n**Isn't AGENTS.md enough if every tool reads it?**\n\nIt carries rules from one tool to another. It does not carry where the work stopped. That goes in a progress file and in commits.\n\n**Can't the next agent just read the code and work out what was going on?**\n\nIn our experience, sometimes, partly, and at a cost. Without a note it cannot tell a deliberate half-change from a broken one. A three-line progress entry takes the guessing out.\n\n**Why not raise the limit or add accounts?**\n\nLimits still hit. On our board, one account cut about 27 workers at once, twice in a row. More headroom changes when the cut happens. It doesn't change what happens to unsaved work.\n\n**Who should watch the agents?**\n\nSomething that is not an agent and does not share their limit: a plain scheduled check with its own credentials that reads a heartbeat the agents write.\n\n**How many parallel agents is safe?**\n\nIt depends on the account and the work. We settled on 18 after two cuts at about 27. Measure your own.\n\nThe numbers above come from krilal board. The board's whole record is a git history you can read, blame and revert, and that is why a cut-off session can be picked up at all. The short version of this argument is here: [https://www.iloblique.com/blog/shared-folder-does-not-hand-work-between-agents](https://www.iloblique.com/blog/shared-folder-does-not-hand-work-between-agents).\n\nIf you have agents that need to survive the night, we'd like to hear about it.\n\n*Originally published at [iloblique.com](https://www.iloblique.com/blog/shared-folder-does-not-hand-work-between-agents).*", "url": "https://wpnews.pro/news/a-shared-folder-doesn-t-hand-work-between-agents-a-progress-log-does", "canonical_source": "https://dev.to/iloblique/a-shared-folder-doesnt-hand-work-between-agents-a-progress-log-does-22l0", "published_at": "2026-11-14 11:10:14+00:00", "updated_at": "2026-11-14 11:20:51.831484+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools"], "entities": ["Anthropic", "krilal board", "r/AI_Agents"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/a-shared-folder-doesn-t-hand-work-between-agents-a-progress-log-does", "markdown": "https://wpnews.pro/news/a-shared-folder-doesn-t-hand-work-between-agents-a-progress-log-does.md", "text": "https://wpnews.pro/news/a-shared-folder-doesn-t-hand-work-between-agents-a-progress-log-does.txt", "jsonld": "https://wpnews.pro/news/a-shared-folder-doesn-t-hand-work-between-agents-a-progress-log-does.jsonld"}}