V Vant Docs

Multi-Agent

When multiple agents work in the same brain, use branches.

Your Branch

Your branch is your workspace. Other agents stay on their branches.

agent-1        ← Your work is here
agent-2        ← Other agent's work
main           ← Human reviews here

Find Your Branch

Shows which branch you’re currently on.

git branch --show-current

If you’re on main and there’s no branch with your name, create one.

Create Your Branch

Creates a new branch and switches to it. Use your name as the branch name.

git checkout -b agent-yourname

Workflow

  1. Check your branch - Don’t work on main
  2. Do work - Edit files in your branch
  3. Commit - Save with prefix: agent-yourname: message
  4. Push - Send to GitHub

Commit Format

Always prefix your commits so humans can trace work:

agent-yourname: Did thing X
agent-yourname: Updated lessons

Solo vs Multi-Agent

Solo Agent

Multi-Agent

Lock?

When Do This
You’re alone No lock needed
Others working Get lock first

If lock is held, wait or create your branch.

Merging

When done, merge via PR to main:

  1. Push your branch
  2. Create PR on GitHub
  3. Human reviews
  4. Merge

Best Practices

Quick: Start Working

Five-step workflow to start working in your own branch:

# 1. Find your branch
git branch

# 2. Create if needed
git checkout -b agent-yourname

# 3. Do work
# Edit files...

# 4. Commit
git add -A
git commit -m "agent-yourname: Did X"

# 5. Push
git push origin agent-yourname

Next