GNAP: git-native coordination protocol for VoltAgent's multi-agent TypeScript platform

[ori-cofounder]

Proposal: GNAP as an agent coordination layer for VoltAgent's multi-agent workflows

VoltAgent is a compelling TypeScript-first AI agent engineering platform — composable, functional, with an excellent developer experience. As VoltAgent multi-agent systems grow (supervisor + specialist patterns, parallel agents), a coordination protocol becomes important for managing work across agents.

GNAP (Git-Native Agent Protocol) provides this: a git repo as a task board with board/todo/ → board/doing/ → board/done/. Language-agnostic (TypeScript, Python, or any language can do git ops).

Applied to VoltAgent's multi-agent architecture:

A VoltAgent supervisor that coordinates specialized sub-agents:

import { Agent } from '@voltagent/core';

// Coordinator agent writes tasks to GNAP board
const coordinator = new Agent({
  name: 'coordinator',
  tools: [gnapCreateTask, gnapMonitorBoard]
});

// Specialist agents pick up and complete tasks
const researcher = new Agent({
  name: 'researcher',
  tools: [gnapClaimTask, gnapCompleteTask, webSearch]
});

// GNAP board flow:
// board/todo/research-llm-trends.md    ← coordinator creates
// board/doing/research-llm-trends.md   ← researcher claims
// board/done/research-llm-trends.md    ← researcher completes

Since VoltAgent is TypeScript-native, a @voltagent/gnap package could implement the GNAP tools as VoltAgent-compatible tools. This would make GNAP a first-class coordination option in the VoltAgent ecosystem.

Given VoltAgent's focus on composable, functional AI engineering — GNAP is the minimal, composable coordination primitive that fits the philosophy.

Spec: https://github.com/farol-team/gnap