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

Por qué usarlo

Características clave

GitHub Issues como tu cola de trabajo
Git worktrees por issue — trabajo en paralelo real de agentes
Slash commands /start /ship /abandon
Creación automática de PR vinculado al issue
Limpieza al hacer merge o abandon
Funciona en cualquier repo de GitHub con gh instalado

Demo en vivo

Cómo se ve en la práctica

listo

Instalar

Elige tu 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
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.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 el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

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

Ejecutar 3 sesiones de Claude en 3 issues diferentes a la vez

👤 Fundadores solitarios, desarrolladores indie ⏱ ~60 min intermediate

Cuándo usarlo: Tienes 5 issues pequeños; hacerlos en secuencia es lento pero cambiar de rama rompe el estado.

Requisitos previos

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

Flujo

Elegir issues

Usa ccpm. Lista los issues abiertos; recomienda 3 pequeños que pueda hacer en paralelo hoy.✓ Copiado

→ 3 issues con estimación aproximada, sin bloqueos entre ellos
Iniciarlos

Inicia los issues #42, #43, #45 cada uno en su propio worktree. Abre 3 sesiones de Claude Code listas.✓ Copiado

→ 3 worktrees creados en ../wt-42 etc; cada sesión sabe qué issue le pertenece
Publicarlos

(En cada sesión) Cuando esté listo — /ship — empuja la rama y abre el PR vinculado al issue.✓ Copiado

→ PR creado, vinculado al issue, CI arranca

Resultado: Tres issues cerrados antes del final del día sin el dolor de malabarismo de ramas.

Errores comunes

Los issues tocan archivos solapados → conflictos de merge — La skill avisa cuando los issues elegidos tienen solapamiento de archivos; elige no solapados para paralelo

Combinar con: github

Convertir una idea casual en un issue bien definido

👤 Cualquiera con desbordamiento de ideas ⏱ ~5 min beginner

Cuándo usarlo: Sigues escribiendo 'oh y también deberíamos...' en el chat. Captúralos como issues correctos.

Flujo

Capturar

Usa ccpm. Quiero añadir exportación JSON al dashboard. Crea un issue con razonamiento, criterios de aceptación y un plan aproximado.✓ Copiado

→ Issue bien formado creado en GitHub
Vincular

Vincula a issues relacionados si los hay.✓ Copiado

→ Vínculos añadidos

Resultado: Las ideas se convierten en issues que realmente puedes priorizar después.

Errores comunes

Los issues se vuelven demasiado verbosos — La skill impone un límite de 200 palabras para el cuerpo

Combinar con: github

Abandonar un issue iniciado sin dejar ramas pudriéndose

👤 Cualquiera que haya probado algo y reconsiderado ⏱ ~2 min beginner

Cuándo usarlo: 30 minutos dentro de un issue te das cuenta de que el enfoque es incorrecto; quieres salir limpiamente.

Flujo

Abandonar

/abandon. Elimina el worktree, borra la rama, cierra el issue con un comentario explicando el motivo.✓ Copiado

→ Worktree eliminado, rama borrada, issue cerrado con explicación

Resultado: Sin ramas huérfanas en el repo.

Errores comunes

Querías conservar parte del trabajo — La skill guarda un parche en /tmp/ccpm-stashes antes de borrar — recuperable durante ~7 días

Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

ccpm-skill + github

Asegurar que CCPM y el MCP de GitHub coincidan en el estado del issue

ccpm-skill + memorix-mcp

Llevar contexto entre los worktrees

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar
list	filters	Encontrar trabajo
start	issue_number	Comenzar a trabajar en un issue
ship	issue_number?	Listo; preparado para PR
abandon	issue_number, reason	Salir limpiamente

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Limitado por los límites de la API de GitHub (5000/h con auth)
Tokens por llamada: Ligero — la mayoría de operaciones son git + CLI gh
Monetario: Gratis
Consejo: No sobre-crees issues — la skill incentiva capturar ideas pero no cada micro-pensamiento

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: repo (para escritura de issue + PR)

Almacenamiento de credenciales: Mediante gh auth

Salida de datos: API de GitHub

No conceder nunca: admin:org

/abandon borra ramas — se necesita flag de confirmación para repos compartidos

Resolución de problemas

Errores comunes y soluciones

git worktree add falla: ya en uso

Un worktree anterior todavía existe; limpia con git worktree prune

Verificar: `git worktree list`

gh PR create falla con 'no commits between'

Haz al menos un commit en la rama del worktree antes de /ship

Dos sesiones reclaman el mismo issue

La skill escribe un lockfile por issue — el segundo start falla con un mensaje claro

Alternativas

CCPM (Claude Code Project Mgmt) vs otros

Alternativa	Cuándo usarla	Contrapartida
Linear MCP	Estás en Linear, no en GitHub Issues	CCPM es solo para GitHub; Linear MCP es su propio ecosistema
`git worktree` simple + checklist	Solo ejecutas un agente a la vez	Manual; CCPM automatiza el ciclo de vida

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills