● Communauté
automazeio
⚡ Instantané
CCPM (Claude Code Project Mgmt)
par automazeio · automazeio/ccpm
Utilisez GitHub Issues + Git worktrees comme couche de gestion de projet pour Claude Code — chaque issue devient une branche, chaque agent travaille en isolation, pas de contamination croisée.
CCPM (Claude Code Project Management) traite les GitHub Issues comme unité de travail pour les agents de code AI. Chaque issue obtient son propre Git worktree (branche + checkout isolé), pour que plusieurs sessions Claude puissent travailler en parallèle sans se marcher dessus. Le skill fournit des commandes pour créer des issues depuis des prompts, les revendiquer, les livrer en PR et nettoyer. Conçu pour les devs solo qui font tourner plusieurs onglets Claude à la fois.
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
Cas d'usage
Usages concrets : CCPM (Claude Code Project Mgmt)
Quand l'utiliser : Vous avez 5 petites issues ; les faire séquentiellement est lent mais changer de branches casse l'état.
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
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
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
Combinaisons
Associez-le à d'autres MCPs pour un effet X10
S'assurer que CCPM et le MCP GitHub s'accordent sur l'état des issues
Transporter le contexte entre les worktrees
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 |