/ Verzeichnis / Playground / CCPM (Claude Code Project Mgmt)
● Community automazeio ⚡ Sofort

CCPM (Claude Code Project Mgmt)

von automazeio · automazeio/ccpm

GitHub Issues und Git-Worktrees als Projektmanagement-Schicht für Claude Code nutzen — jedes Issue wird ein Branch, jeder Agent arbeitet isoliert, keine gegenseitige Beeinflussung.

CCPM (Claude Code Project Management) behandelt GitHub Issues als Arbeitseinheit für AI-Coding-Agenten. Jedes Issue erhält seinen eigenen Git-Worktree (Branch + isolierter Checkout), damit mehrere Claude-Sitzungen parallel arbeiten können, ohne sich gegenseitig zu stören. Der Skill bietet Befehle zum Erstellen von Issues aus Prompts, zum Beanspruchen, Ausliefern als PRs und Bereinigen. Entwickelt für Solo-Entwickler, die mehrere Claude-Tabs gleichzeitig betreiben.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

bereit

Installieren

Wählen Sie Ihren 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
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

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

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

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

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

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

Continue nutzt ein Array von Serverobjekten statt einer Map.

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

In context_servers hinzufügen. Zed lädt beim Speichern neu.

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

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: CCPM (Claude Code Project Mgmt)

3 Claude-Sitzungen auf 3 verschiedenen Issues gleichzeitig betreiben

👤 Solo-Gründer, Indie-Entwickler ⏱ ~60 min intermediate

Wann einsetzen: Du hast 5 kleine Issues; sequenzielles Abarbeiten ist langsam, aber Branch-Wechsel bricht den Zustand.

Voraussetzungen
  • gh-CLI authentifiziertgh auth login — mit gh repo view verifizieren
  • Skill installiert — git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm
Ablauf
  1. Issues auswählen
    Use ccpm. List open issues; recommend 3 small ones I can do in parallel today.✓ Kopiert
    → 3 Issues mit grober Schätzung, keine Blocker dazwischen
  2. Starten
    Start issue #42, #43, #45 each in its own worktree. Open 3 Claude Code sessions ready.✓ Kopiert
    → 3 Worktrees unter ../wt-42 usw. erstellt; jede Sitzung weiß, welches Issue sie besitzt
  3. Ausliefern
    (In each session) When done — /ship — push branch and open PR linked to the issue.✓ Kopiert
    → PR erstellt, mit Issue verknüpft, CI gestartet

Ergebnis: Drei Issues bis Tagesende erledigt, ohne Branch-Jonglage.

Fallstricke
  • Issues berühren überlappende Dateien → Merge-Konflikte — Skill warnt, wenn ausgewählte Issues Dateiüberschneidungen haben; nicht-überlappende für parallele Arbeit wählen
Kombinieren mit: github

Eine beiläufige Idee in ein richtig ausgearbeitetes Issue verwandeln

👤 Alle mit Ideen-Überlauf ⏱ ~5 min beginner

Wann einsetzen: Du tippst immer wieder ‚oh und wir sollten auch...' in den Chat. Halte sie als echte Issues fest.

Ablauf
  1. Erfassen
    Use ccpm. I want to add JSON export to the dashboard. Create an issue with rationale, acceptance criteria, and a rough plan.✓ Kopiert
    → Gut ausgearbeitetes Issue auf GitHub erstellt
  2. Verknüpfen
    Link to related issues if any.✓ Kopiert
    → Verknüpfungen hinzugefügt

Ergebnis: Ideen werden zu Issues, die du später tatsächlich triagieren kannst.

Fallstricke
  • Issues werden zu ausführlich — Skill erzwingt eine 200-Wörter-Obergrenze für den Body
Kombinieren mit: github

Ein gestartetes Issue sauber aufgeben ohne verrottende Branches zu hinterlassen

👤 Alle, die etwas ausprobiert haben und es überdenken ⏱ ~2 min beginner

Wann einsetzen: 30 Minuten in ein Issue hinein erkennst du, dass der Ansatz falsch ist; du möchtest sauber aussteigen.

Ablauf
  1. Aufgeben
    /abandon. Remove the worktree, delete the branch, close the issue with a comment explaining why.✓ Kopiert
    → Worktree weg, Branch gelöscht, Issue mit Erklärung geschlossen

Ergebnis: Keine verwaisten Branches, die das Repo heimsuchen.

Fallstricke
  • Du wolltest eigentlich einen Teil der Arbeit behalten — Skill legt ein Patch unter /tmp/ccpm-stashes ab vor dem Löschen — für ~7 Tage wiederherstellbar
Kombinieren mit: github

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

ccpm-skill + github

Sicherstellen, dass CCPM und GitHub MCP über den Issue-Status übereinstimmen

ccpm-skill + memorix-mcp

Kontext über die Worktrees hinweg tragen

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
list filters Arbeit finden 0
start issue_number Arbeit an einem Issue beginnen 0
ship issue_number? Fertig; bereit für PR 0
abandon issue_number, reason Sauber aussteigen 0

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
Durch GitHub-API-Limits begrenzt (5000/h mit Auth)
Tokens pro Aufruf
Gering — die meisten Operationen sind git + gh CLI
Kosten in €
Kostenlos
Tipp
Nicht zu viele Issues erstellen — Skill ermutigt zum Festhalten von Ideen, aber nicht jeden Mikrogedanken

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: repo (für Issue + PR write)
Credential-Speicherung: Via gh auth
Datenabfluss: GitHub API
Niemals gewähren: admin:org

Fehlerbehebung

Häufige Fehler und Lösungen

git worktree add schlägt fehl: bereits verwendet

Ein vorheriger Worktree existiert noch; mit git worktree prune bereinigen

Prüfen: `git worktree list`
gh PR create meldet ‚no commits between'

Mindestens einen Commit auf dem Worktree-Branch vor /ship machen

Zwei Sitzungen beanspruchen dasselbe Issue

Skill schreibt eine Lockfile pro Issue — zweiter Start schlägt mit klarer Meldung fehl

Alternativen

CCPM (Claude Code Project Mgmt) vs. andere

AlternativeWann stattdessenKompromiss
Linear MCPDu nutzt Linear statt GitHub IssuesCCPM ist nur für GitHub; Linear MCP ist sein eigenes Ökosystem
Plain `git worktree` + ChecklisteDu betreibst nur einen Agenten gleichzeitigManuell; CCPM automatisiert den gesamten Lifecycle

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen