/ Diretório / Playground / CCPM (Claude Code Project Mgmt)
← Todos os servidores ↗ GitHub
● Comunidade automazeio ⚡ Instantâneo

CCPM (Claude Code Project Mgmt)

por automazeio · automazeio/ccpm

Use GitHub Issues + Git worktrees como sua camada de gerenciamento de projetos para o Claude Code — cada issue vira uma branch, cada agente trabalha isolado, sem contaminação cruzada.

O CCPM (Claude Code Project Management) trata GitHub Issues como a unidade de trabalho para agentes de IA. Cada issue recebe seu próprio Git worktree (branch + checkout isolado), para que múltiplas sessões do Claude possam trabalhar em paralelo sem pisar uma na outra. A skill fornece comandos para criar issues a partir de prompts, reivindicá-las, enviá-las como PRs e fazer a limpeza. Construído para devs solo que rodam várias abas do Claude ao mesmo tempo.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

pronto

Instalação

Repositório do autor · Documentação oficial de Skills do Claude

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.

Fluxo
  1. 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
  2. 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
  3. 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
  1. 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
  2. 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
  1. 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

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

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

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

AlternativaQuando usarTroca
Linear MCPVocê usa o Linear, não o GitHub IssuesO CCPM é somente GitHub; o Linear MCP tem seu próprio ecossistema
`git worktree` puro + checklistVocê roda apenas 1 agente por vezManual; 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