CCPM (Claude Code Project Mgmt) (Claude Skill) — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

GitHub Issues comme file de travail
Git worktrees par issue — vrai travail agent en parallèle
Commandes slash /start /ship /abandon
Création automatique de PR liée à l'issue
Nettoyage à la fusion/abandon
Fonctionne sur tout dépôt GitHub avec gh installé

Démo en direct

Aperçu en pratique

prêt

Installer

Choisissez votre client

~/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
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : CCPM (Claude Code Project Mgmt)

Faire tourner 3 sessions Claude sur 3 issues différentes simultanément

👤 Fondateurs solo, devs indépendants ⏱ ~60 min intermediate

Quand l'utiliser : Vous avez 5 petites issues ; les faire séquentiellement est lent mais changer de branches casse l'état.

Prérequis

CLI gh authentifié — gh auth login — vérifiez avec gh repo view
Skill installé — git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm

Déroulement

Choisir les issues

Use ccpm. List open issues; recommend 3 small ones I can do in parallel today.✓ Copié

→ 3 issues avec estimation approximative, pas de bloqueurs entre elles
Les démarrer

Start issue #42, #43, #45 each in its own worktree. Open 3 Claude Code sessions ready.✓ Copié

→ 3 worktrees créés à ../wt-42 etc ; chaque session sait quelle issue elle possède
Les livrer

(Dans chaque session) When done — /ship — push branch and open PR linked to the issue.✓ Copié

→ PR créée, liée à l'issue, CI démarre

Résultat : Trois issues fermées d'ici la fin de journée sans la douleur de jongler avec les branches.

Pièges

Les issues touchent des fichiers qui se chevauchent → conflits de fusion — Le skill avertit quand les issues choisies ont un chevauchement de fichiers ; choisissez des issues sans chevauchement pour le parallèle

Combiner avec : github

Transformer une idée informelle en issue correctement dimensionnée

👤 Toute personne débordant d'idées ⏱ ~5 min beginner

Quand l'utiliser : Vous continuez à taper « oh et on devrait aussi... » dans le chat. Capturez-les comme de vraies issues.

Déroulement

Capturer

Use ccpm. I want to add JSON export to the dashboard. Create an issue with rationale, acceptance criteria, and a rough plan.✓ Copié

→ Issue bien formée créée sur GitHub
Lier

Link to related issues if any.✓ Copié

→ Liens ajoutés

Résultat : Les idées deviennent des issues que vous pouvez vraiment trier plus tard.

Pièges

Les issues deviennent trop verboses — Le skill applique un plafond de 200 mots pour le corps

Combiner avec : github

Abandonner une issue démarrée sans laisser des branches en décomposition

👤 Quiconque a essayé quelque chose et reconsidéré ⏱ ~2 min beginner

Quand l'utiliser : 30 minutes après avoir commencé une issue, vous réalisez que l'approche est mauvaise ; vous voulez vous retirer proprement.

Déroulement

Abandonner

/abandon. Remove the worktree, delete the branch, close the issue with a comment explaining why.✓ Copié

→ Worktree supprimé, branche supprimée, issue fermée avec explication

Résultat : Pas de branches orphelines hantant le dépôt.

Pièges

Vous vouliez en fait garder une partie du travail — Le skill stash un patch sous /tmp/ccpm-stashes avant de supprimer — récupérable pendant ~7 jours

Combiner avec : github

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

ccpm-skill + github

S'assurer que CCPM et le MCP GitHub s'accordent sur l'état des issues

ccpm-skill + memorix-mcp

Transporter le contexte entre les worktrees

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler
list	filters	Trouver du travail
start	issue_number	Commencer à travailler sur une issue
ship	issue_number?	Terminé ; prêt pour la PR
abandon	issue_number, reason	Se retirer proprement

Coût et limites

Coût d'exécution

Quota d'API: Limité par les limites de l'API GitHub (5000/h avec auth)
Tokens par appel: Léger — la plupart des opérations sont git + gh CLI
Monétaire: Gratuit
Astuce: Ne créez pas trop d'issues — le skill encourage la capture des pensées mais pas chaque micro-pensée

Sécurité

Permissions, secrets, portée

Portées minimales : repo (pour l'écriture issues + PR)

Stockage des identifiants : Via gh auth

Sortie de données : API GitHub

Ne jamais accorder : admin:org

/abandon supprime les branches — un flag de confirmation est nécessaire pour les dépôts partagés

Dépannage

Erreurs courantes et correctifs

git worktree add échoue : déjà utilisé

Un worktree précédent existe encore ; nettoyez avec git worktree prune

Vérifier : `git worktree list`

gh PR create retourne « no commits between »

Faites au moins un commit sur la branche worktree avant /ship

Deux sessions revendiquent la même issue

Le skill écrit un fichier verrou par issue — le deuxième start échoue avec un message clair

Alternatives

CCPM (Claude Code Project Mgmt) vs autres

Alternative	Quand l'utiliser	Compromis
Linear MCP	Vous utilisez Linear, pas GitHub Issues	CCPM est GitHub uniquement ; Linear MCP est son propre écosystème
`git worktree` simple + checklist	Vous ne faites tourner qu'1 agent à la fois	Manuel ; CCPM automatise le cycle de vie

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills