How I run 4–8 parallel coding agents with tmux and Markdown specs
I’ve been running parallel coding agents with a lightweight setup for a few months now with tmux, Markdown files, bash aliases, and six slash commands. These are vanilla agents - no subagent profiles or orchestrators, but I do use a role naming convention per tmux window:
Planner : Build Markdown specs for new features or fixes
: Build Markdown specs for new features or fixes Worker : Implement from a finished spec
: Implement from a finished spec PM: Backlog grooming and idea dumping
Most actual code writing happens from a finished spec I call Feature Designs (FDs). An FD is just an md file that has:
the problem we are trying to solve
all solutions that were considered including pros and cons for each
the final solution with an implementation plan including what files need to be updated
verification steps
... continue reading