convez.ai
MCP ServerAutomaçãoAvançado
tech-sumit

BatonDeck Skill — Orquestrador de Tarefas para Agentes

tech-sumit/batondeck-skill

Planejar e executar tarefas autonomamente em Kanban colaborativo via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP 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-skill

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 uses mcp-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) gcloud authenticated (gcloud auth login), for the optional token-minting script path. For an agent service account add it with add_member and grant it roles/run.invoker on the core (the BatonDeck repo's scripts/onboard-agent.sh <sa-email> does both).

Install — Cursor

  1. Clone this repo into (or beside) your project so .cursor/ and scripts/ 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
    
  2. Rule — .cursor/rules/batondeck-worker.mdc is picked up automatically; Cursor's agent applies it whenever you ask it to plan or work the BatonDeck board.
  3. MCP server — enable batondeck in Cursor Settings → MCP. .cursor/mcp.json already points mcp-remote at 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.json to your own mcp-gateway /mcp.
  4. 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

PathPurpose
.cursor/rules/batondeck-worker.mdcCursor rule — the planner/worker playbook
.cursor/mcp.jsonCursor MCP server (batondeck) — mcp-remote → the mcp-gateway /mcp (OAuth browser flow)
SKILL.mdClaude Code skill (same playbook)
references/tools.mdFull 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.pyplant a whole dependency tree from a JSON plan in one session
scripts/worker.shone decentralized worker loop (claim → run AGENT_CMD → repeat)
scripts/fleet.shrun many workers in parallel to drain a board at max concurrency

Connection env

envmeaning
BATONDECK_CORE_URLcore base URL (default: the hosted reference instance; set to override the default)
BATONDECK_TOKENa Google ID token (audience = core URL) — bring your own, or leave unset to mint
BATONDECK_AGENT_SAmint a token by impersonating your agent's service account
BATONDECK_ON_BEHALF_OFoptional on-behalf-of identity (only when authing as a trusted gateway SA)
BATONDECK_PROJECT / BATONDECK_BOARDthe project/board the worker + fleet operate on

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados