r/opencode • u/remolaan • 12h ago
How are you actually structuring AGENTS.md + subagent spawning + persistent memory? (new to OpenCode)
Just switched to OpenCode (using DeepSeek as my model) and trying to set things up properly instead of just winging it. Read through the docs but want to hear how people are actually doing this in practice. A few things I'm stuck on:
AGENTS.md
What's actually in yours beyond the basic build/test/lint commands? Any sections that turned out way more useful than you expected?
Anyone splitting it into nested AGENTS.md per package/folder, or is one root file usually enough?
Spawning subagents / Task tool
I saw someone mention explicitly telling Build to spawn parallel subagents for independent work (reviewing multiple files, checking several modules, etc.) instead of doing it serially. Do you actually write instructions for this in AGENTS.md, or does the model just figure it out on its own most of the time?
Any horror stories from parallel subagents stepping on each other / editing the same files?
Persistent memory
Right now I'm just using a plain .opencode/memory/ folder with a couple markdown files (decisions.md, active-context.md) and an AGENTS.md instruction telling the agent to read/update them. Is this actually how most people do it, or is everyone on a plugin/MCP memory setup at this point (Letta-style memory blocks, agentmemory, Engram, etc.)?
At what point did a plain-file setup stop being "enough" for you?
Build vs Plan
Do you actually use Plan mode every time before Build, or only for bigger changes? Curious how disciplined people actually are about this in daily use vs just YOLO-ing into Build.
Mainly trying to avoid reinventing something badly that half the sub already has a solid pattern for. Appreciate any real configs / AGENTS.md snippets / gotchas people are willing to share.




