CCPM (Claude Code Project Mgmt) (Claude Skill) — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

GitHub Issues como fila de trabalho
Git worktrees por issue — trabalho paralelo real de agentes
Comandos slash /start /ship /abandon
Criação automática de PR vinculado à issue
Limpeza no merge/abandon
Funciona em qualquer repositório GitHub com gh instalado

Demo ao vivo

Como fica na prática

pronto

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "ccpm-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "ccpm-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/automazeio/ccpm",
          "~/.claude/skills/ccpm"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add ccpm-skill -- git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: CCPM (Claude Code Project Mgmt)

Rodar 3 sessões do Claude em 3 issues diferentes ao mesmo tempo

👤 Fundadores solo, devs indie ⏱ ~60 min intermediate

Quando usar: Você tem 5 issues pequenas; fazê-las sequencialmente é lento, mas trocar de branch quebra o estado.

Pré-requisitos

CLI gh autenticada — gh auth login — verifique com gh repo view
Skill instalada — git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm

Fluxo

Escolher issues

Use o ccpm. Liste as issues abertas; recomende 3 pequenas que posso fazer em paralelo hoje.✓ Copiado

→ 3 issues com estimativa aproximada, sem bloqueadores entre elas
Iniciá-las

Inicie as issues #42, #43, #45, cada uma em seu próprio worktree. Abra 3 sessões do Claude Code prontas.✓ Copiado

→ 3 worktrees criados em ../wt-42 etc; cada sessão sabe qual issue ela possui
Enviá-las

(Em cada sessão) Quando terminar — /ship — envie a branch e abra o PR vinculado à issue.✓ Copiado

→ PR criado, vinculado à issue, CI inicia

Resultado: Três issues fechadas no fim do dia sem a dor de trocar de branch.

Armadilhas

Issues tocam arquivos sobrepostos → conflitos de merge — A skill avisa quando as issues escolhidas têm sobreposição de arquivos; escolha issues sem sobreposição para o paralelo

Combine com: github

Transformar uma ideia casual em uma issue bem escrita

👤 Qualquer pessoa com excesso de ideias ⏱ ~5 min beginner

Quando usar: Você continua digitando 'oh e também deveríamos...' no chat. Capture-as como issues adequadas.

Fluxo

Capturar

Use o ccpm. Quero adicionar exportação JSON ao dashboard. Crie uma issue com justificativa, critérios de aceitação e um plano aproximado.✓ Copiado

→ Issue bem formada criada no GitHub
Vincular

Vincule a issues relacionadas, se houver.✓ Copiado

→ Vínculos adicionados

Resultado: Ideias viram issues que você pode realmente priorizar depois.

Armadilhas

Issues ficam longas demais — A skill aplica um limite de 200 palavras para o corpo

Combine com: github

Abandonar uma issue iniciada sem deixar branches podres

👤 Qualquer pessoa que tentou algo e reconsiderou ⏱ ~2 min beginner

Quando usar: 30 minutos dentro de uma issue você percebe que a abordagem está errada; quer sair de forma limpa.

Fluxo

Abandonar

/abandon. Remova o worktree, delete a branch, feche a issue com um comentário explicando o porquê.✓ Copiado

→ Worktree removido, branch deletada, issue fechada com explicação

Resultado: Sem branches órfãs assombrando o repositório.

Armadilhas

Você na verdade queria manter parte do trabalho — A skill guarda um patch em /tmp/ccpm-stashes antes de deletar — recuperável por ~7 dias

Combine com: github

Combinações

Combine com outros MCPs para 10× de alavancagem

ccpm-skill + github

Garantir que o CCPM e o MCP do GitHub concordem sobre o estado das issues

Sincronize o estado das issues após cada /ship para que os quadros do projeto reflitam a realidade.✓ Copiado

ccpm-skill + memorix-mcp

Carregar contexto entre os worktrees

Ao iniciar uma issue, recupere entradas do Memorix com tag no componente desta issue.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
list	filters	Encontrar trabalho
start	issue_number	Começar a trabalhar em uma issue
ship	issue_number?	Pronto; pronto para PR
abandon	issue_number, reason	Sair de forma limpa

Custo e limites

O que custa rodar

Cota de API: Limitado pelos limites da API do GitHub (5.000/h autenticado)
Tokens por chamada: Leve — a maioria das operações é git + gh CLI
Monetário: Gratuito
Dica: Não crie issues em excesso — a skill incentiva capturar pensamentos, mas não cada micropensamento

Segurança

Permissões, segredos, alcance

Escopos mínimos: repo (para escrita de issue + PR)

Armazenamento de credenciais: Via gh auth

Saída de dados: API do GitHub

Nunca conceda: admin:org

/abandon deleta branches — flag de confirmação necessária em repositórios compartilhados

Solução de problemas

Erros comuns e correções

git worktree add falha: already used

Um worktree anterior ainda existe; limpe com git worktree prune

Verificar: `git worktree list`

gh PR create com erro 'no commits between'

Faça pelo menos um commit na branch do worktree antes do /ship

Duas sessões reivindicam a mesma issue

A skill escreve um lockfile por issue — o segundo start falha com uma mensagem clara

Alternativas

CCPM (Claude Code Project Mgmt) vs. outros

Alternativa	Quando usar	Troca
Linear MCP	Você usa o Linear, não o GitHub Issues	O CCPM é somente GitHub; o Linear MCP tem seu próprio ecossistema
`git worktree` puro + checklist	Você roda apenas 1 agente por vez	Manual; o CCPM automatiza o ciclo de vida

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills