BatonDeck Skill — Orquestrador de Tarefas para Agentes
tech-sumit/batondeck-skill
Planejar e executar tarefas autonomamente em Kanban colaborativo via MCP
Ver no GitHubMCP server que ensina agentes de código (Cursor/Claude Code) a planejar trabalho em um quadro Kanban compartilhado e executá-lo autonomamente. Organiza árvores de dependências e permite que múltiplos agentes e humanos trabalhem simultaneamente de forma segura, com autenticação OAuth integrada.
Instalação
npx convez-ai tech-sumit/batondeck-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Coordenação de múltiplos agentes de IA em projetos grandes
- Orquestração de pipelines de desenvolvimento com dependências complexas
- Automação de fluxos de trabalho em equipes mistas (agentes + humanos)
Veredito

Ferramenta robusta e bem arquitetada para times que precisam coordenar agentes de IA em escala. Requer compreensão sólida de MCP, OAuth e fluxos de trabalho distribuídos — não é entrada iniciante, mas entrega valor real em cenários multi-agente.
README
A tradução para o português deste README ainda está na fila.
Superseded by batondeck-plugin — the installable plugin (Claude Code + Cursor marketplaces, release zips) built from this content. This repo remains as the source archive.
batondeck-skill
An installable agent skill for BatonDeck — the MCP-native task orchestrator. It teaches your coding agent to plan work onto a shared BatonDeck Kanban board (a richly-detailed dependency tree) and work it autonomously over MCP — claiming tasks, loading each task's full context, doing the work, and auto-unblocking what comes next — safely alongside other agents and humans.
Ships for both Cursor (a .cursor rule + MCP server) and Claude Code (a SKILL.md skill).
Interactive use needs no secrets and no gcloud: the MCP endpoint speaks OAuth 2.1, so your MCP
client (Cursor / mcp-remote) signs you in through a normal Google browser flow. A gcloud-based
script path is kept as an optional advanced/headless option.
Prerequisites
node/npx— the Cursor MCP server usesmcp-remote, which drives the OAuth browser flow.- A Google account. On first connect you'll get a browser sign-in (Google account picker) — that's it.
- Membership in a BatonDeck project. An operator adds you with
add_member { projectId, identityId: "<your-email-or-SA>", role: "agent" | "member" | "admin" }. (A valid sign-in with no membership sees nothing — authorization is by project membership.) - (Advanced / headless only)
gcloudauthenticated (gcloud auth login), for the optional token-minting script path. For an agent service account add it withadd_memberand grant itroles/run.invokeron the core (the BatonDeck repo'sscripts/onboard-agent.sh <sa-email>does both).
Install — Cursor
- Clone this repo into (or beside) your project so
.cursor/andscripts/are at the project root:git clone https://github.com/tech-sumit/batondeck-skill # then copy .cursor/ and scripts/ to your project root, or work inside this repo - Rule —
.cursor/rules/batondeck-worker.mdcis picked up automatically; Cursor's agent applies it whenever you ask it to plan or work the BatonDeck board. - MCP server — enable
batondeckin Cursor Settings → MCP..cursor/mcp.jsonalready pointsmcp-remoteat the hosted MCP endpoint (https://batondeck-mcp-…/mcp); on first use Cursor opens a browser to sign in with Google, then the tools are available natively. To point at a different core URL, change the URL in.cursor/mcp.jsonto your own mcp-gateway/mcp. - Or skip MCP and let the agent use the terminal scripts directly — see the advanced Quickstart.
Install — Claude Code
Make this repo a skill (it has SKILL.md at the root):
git clone https://github.com/tech-sumit/batondeck-skill \
~/.claude/skills/batondeck-worker # user-level; or <project>/.claude/skills/batondeck-worker
Claude Code loads batondeck-worker automatically when a task matches its description.
Quickstart — advanced (terminal scripts + gcloud, for headless/CI)
For interactive use prefer the MCP server above (browser OAuth, no gcloud). The scripts below are the
optional headless path: they mint a Google ID token with your own gcloud and call the core directly.
export BATONDECK_AGENT_SA=my-agent@my-proj.iam.gserviceaccount.com # or leave unset to use your gcloud login
eval "$(scripts/token.sh)" # exports BATONDECK_TOKEN
scripts/mcp.sh list_projects '{}' # discover your projects
export BATONDECK_PROJECT=P-… BATONDECK_BOARD=B-…
scripts/mcp.sh next_task "{\"projectId\":\"$BATONDECK_PROJECT\",\"boardId\":\"$BATONDECK_BOARD\"}"
Every tool { … } in the rule/skill maps to scripts/mcp.sh tool '{ … }'.
What's inside
| Path | Purpose |
|---|---|
.cursor/rules/batondeck-worker.mdc | Cursor rule — the planner/worker playbook |
.cursor/mcp.json | Cursor MCP server (batondeck) — mcp-remote → the mcp-gateway /mcp (OAuth browser flow) |
SKILL.md | Claude Code skill (same playbook) |
references/tools.md | Full MCP tool list + error codes |
scripts/token.sh | (advanced) mint BATONDECK_TOKEN (Google ID token) via gcloud |
scripts/mcp.sh | (advanced) one-shot MCP tool caller (own session) — the headless shell building block |
scripts/cursor-mcp.sh | (advanced) gcloud-token launcher that bridges stdio↔HTTP via mcp-remote |
scripts/seed-tasknet.py | plant a whole dependency tree from a JSON plan in one session |
scripts/worker.sh | one decentralized worker loop (claim → run AGENT_CMD → repeat) |
scripts/fleet.sh | run many workers in parallel to drain a board at max concurrency |
Connection env
| env | meaning |
|---|---|
BATONDECK_CORE_URL | core base URL (default: the hosted reference instance; set to override the default) |
BATONDECK_TOKEN | a Google ID token (audience = core URL) — bring your own, or leave unset to mint |
BATONDECK_AGENT_SA | mint a token by impersonating your agent's service account |
BATONDECK_ON_BEHALF_OF | optional on-behalf-of identity (only when authing as a trusted gateway SA) |
BATONDECK_PROJECT / BATONDECK_BOARD | the project/board the worker + fleet operate on |
License
MIT — see LICENSE.