¶ Project Hub - Projektmanagement-Plugin
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version. Für ältere Versionen siehe das CHANGELOG.
¶ Inhaltsverzeichnis
- Überblick
- Was Project Hub anders macht
- Hauptfunktionen
- Projekt-Verknüpfungen
- Projekttypen
- Skills-Übersicht
- MCP Tools Übersicht
- Systemanforderungen
- Installation
- Konfiguration
- Kurzanleitung
- Datenspeicherung
- Knowledge-System
- Session-Pattern
- Weiterführende Dokumentation
- Fehlerbehebung
- Lizenz
¶ Überblick
Project Hub ist ein Claude Code Plugin für strukturiertes Projektmanagement direkt in Claude. Es ersetzt verstreute Notizen, E-Mail-Threads und Excel-Listen durch ein zentrales, durchsuchbares Projektregister — mit Kontakten, Gesprächsprotokollen, Entscheidungen und Kommunikations-Drafts, alles im Kontext des aktiven Projekts.
Was Project Hub ist:
- Persistentes "Gedächtnis" pro Kundenprojekt: Stakeholder, Phasen, Verlauf
- Strukturierte Ablage für Meetings, E-Mails, Entscheidungen, Deliverables
- Drafting-Werkzeug für Kommunikation (E-Mail, Slack, Teams) im Projektkontext
- Summary-Generator für Meetings und E-Mails
Was Project Hub nicht ist:
- Kein Code-Repo-Manager (dafür mm-dev-toolkit)
- Kein Buchschreib-Assistent (dafür StoryForge)
- Kein Video-Produktions-Tool (dafür VidCraft)
¶ Was Project Hub anders macht
| Feature | Manuelle Notizen | Project Hub |
|---|---|---|
| Kontakt-Übersicht | Verstreut in Mails, Notizen | Zentrales Kontaktregister pro Projekt |
| Meeting-Protokolle | Word-Dateien, überall | Strukturierte Notizen mit Typ und Datum |
| Entscheidungen | Irgendwo im Chat-Verlauf | Dokumentiert mit Datum und Kontext |
| Kommunikation | Manuell formuliert | Kontextbewusst gedraftet mit /compose |
| Suche | Volltextsuche über alle Dateien | /search über alle Notizen und Kontakte |
| Übergaben | Erneutes Briefing nötig | /resume lädt sofort den vollen Projektkontext |
| Verwandte Projekte | Keine Verknüpfung, manuell im Kopf behalten | Projekte verknüpfbar, sichtbar in Dashboard und Report |
¶ Hauptfunktionen
¶ Typischer Ablauf
¶ Persistenter Projektkontext
Jedes Projekt wird einmal geladen (/project-hub:resume) und Claude kennt danach:
- Alle Stakeholder (intern und extern) mit Rollen
- Aktuelle Phase und Status
- Letzte Aktivitäten und Entscheidungen
- Projekttyp-spezifisches Wissen (Governance, Prozesse, Rollen)
¶ Kontakt-Management
Interne und externe Kontakte mit:
- Rolle im Projekt (Sponsor, Technical Lead, Account Manager, ...)
- Firma / Team
- Kommunikationshistorie
- Tags (optional)
¶ Geteilte Kontakte
Interne Kontakte können als geteilt markiert werden — sie stehen dann in jedem Projekt automatisch zur Verfügung, ohne Duplikate:
- Eigene Mitarbeiter einmal anlegen, in allen Projekten sichtbar
/resumelädt shared contacts unter "Geteilte Kontakte" automatisch mit- Externe Kontakte bleiben immer projektspezifisch (können nicht geteilt werden)
- Beim
/add-contactwird für interne Kontakte gefragt, ob die Person projektübergreifend geteilt werden soll - Duplikat-Schutz: Existiert bereits ein geteilter Kontakt mit gleichem Namen oder gleicher E-Mail, wird jeder weitere Eintrag mit diesen Daten blockiert — unabhängig davon, ob er selbst als geteilt markiert werden soll
¶ Notizen und Protokolle
Typisierte Notizen:
- Meeting — Protokoll mit Datum, Teilnehmern, Action Items
- Email — Eingehende oder ausgehende E-Mails im Kontext
- Decision — Dokumentierte Entscheidungen mit Begründung
- Action Item — Offene Aufgaben mit Deadline und Verantwortlichem
- General — Freitext-Notizen
¶ Dateianhänge
Notizen und Projekte können Dateien anhängen (tool_attach_file). Für PDFs, Word- und Excel-Dokumente wird beim Anhängen automatisch eine .md-Geschwisterdatei erzeugt (per MarkItDown-Konvertierung) — Claude kann den Inhalt dann direkt lesen, ohne das Originalformat zu parsen. Bilder werden dabei übersprungen (keine echte Texterkennung).
Die Konvertierung ist best-effort: Schlägt sie fehl oder existiert bereits eine gleichnamige
.md-Datei, bleibt der Original-Anhang trotzdem erhalten.
¶ Kommunikations-Drafting
/project-hub:compose erstellt Entwürfe für:
- E-Mail (formell oder informell, je nach Kontakt-Kontext)
- Slack-Nachrichten
- Teams-Nachrichten
Der Draft nutzt automatisch Projektkontext, bekannte Kontaktnamen und aktuelle Phase.
¶ Knowledge-System
Pro Projekttyp gibt es ein Wissens-Repository (~/.project-hub/knowledge/{type}/):
- Governance-Dokumente, Prozessbeschreibungen, Rollenübersichten
- Wird beim
/resumeautomatisch geladen - Vom User anpassbar und erweiterbar
¶ HTML-Reports
/project-hub:report generiert vollständige HTML-Reports:
- Vollständiger Projektbericht (full)
- Zusammenfassung (summary)
- Alle Projekte (all-projects)
Verknüpfte Projekte (siehe Projekt-Verknüpfungen) werden in Dashboard und Report automatisch mit angezeigt.
¶ Urlaubsübergabe
/project-hub:vacation-handover generiert ein vollständiges Übergabe-Dokument für alle offenen Projekte des aktiven Projekttyps — auf Basis eines Knowledge-Templates (~/.project-hub/knowledge/{type}/vacation-handover.md). Für merchant-onboarding ist ein solches Template bereits eingebaut.
- Sammelt Projektstatus, offene ToDos, anstehende Meetings, Risiken und Kontakte automatisch aus Notizen und Kontaktdaten
- Ohne konfiguriertes Template bricht der Skill mit einer Anleitung zum Anlegen ab (
/knowledge update vacation-handover) - Auf Zuruf: Export als kopierfertiger Confluence-Block oder Speichern als Notiz im aktiven Projekt
Fehlt für den aktiven Projekttyp ein Template, generiert der Skill kein Dokument — Templates müssen erst über
/project-hub:knowledgeangelegt werden.
¶ Projekt-Verknüpfungen
Zwei Projekte lassen sich miteinander verknüpfen — etwa um einen Folgeauftrag oder einen Multi-Markt-Rollout abzubilden, ohne die Historie manuell im Kopf zu behalten.
| Relation | Bedeutung |
|---|---|
successor |
Projekt A ist der Nachfolger von Projekt B (z.B. "Joybuy 2" nach "Joybuy") |
predecessor |
Umkehrung von successor |
related |
Symmetrische Verknüpfung ohne Richtung (z.B. zwei Märkte desselben Rollouts) |
Verhalten:
- Ein Projektpaar kann nur eine aktive Verknüpfung haben — zum Ändern zuerst entknüpfen
- Verknüpfte Projekte erscheinen automatisch im Dashboard und in HTML-Reports
- Verknüpfungen bleiben bei Export/Import erhalten
Verknüpfungen werden aktuell nur über die MCP-Tools
tool_link_project/tool_unlink_projectgesetzt — ein dediziertes Skill dafür gibt es noch nicht.
¶ Projekttypen
Project Hub kommt mit 6 eingebauten Projekttypen:
| Typ | Einsatz |
|---|---|
merchant-onboarding |
Enterprise-Merchant-Onboarding (BNPL, Direct Debit, Multimarkt) |
it-project |
IT / Software-Projekte |
consulting |
Beratungsprojekte |
marketing |
Marketing-Kampagnen |
event |
Eventplanung und -koordination |
generic |
Allgemeine Projekte |
Eigene Typen via /project-hub:type-creator — definiert Knowledge-Dokumente, Status-Stufen und Rollenmuster.
Detailbeschreibung: Projekttypen
¶ Skills-Übersicht
Project Hub hat 20 Skills, aufgerufen via /project-hub:<skill-name>:
| Skill | Zweck |
|---|---|
new-project |
Neues Projekt anlegen |
get-template |
Ausfüllbare Projektvorlage außerhalb des Chats vorbereiten |
resume |
Projekt laden / wechseln |
dashboard |
Alle Projekte im Überblick |
status |
Projektstatus anzeigen und aktualisieren |
add-contact |
Kontakt hinzufügen |
add-note |
Notiz, Protokoll, E-Mail, Entscheidung erfassen |
edit-note |
Bestehende Notiz bearbeiten |
search |
Volltext-Suche über alle Inhalte |
summarize |
Zusammenfassung aus E-Mail oder Meeting-Transcript |
compose |
E-Mail, Slack- oder Teams-Nachricht draften |
knowledge |
Wissens-Repository anzeigen und verwalten |
session-start |
Session initialisieren, Setup prüfen |
next-step |
Nächsten sinnvollen Schritt empfehlen |
configure |
Plugin-Einstellungen bearbeiten |
setup |
Ersteinrichtung |
type-creator |
Eigenen Projekttyp anlegen |
report |
HTML-Report generieren |
vacation-handover |
Urlaubsübergabe-Dokument für alle offenen Projekte generieren |
help |
Alle Skills anzeigen |
Zusätzlich zu diesen 20 nutzerseitigen Skills existieren interne, maschinell aufgerufene Test-Skills für automatisiertes Rollout-Testing — nicht Teil dieser Referenz.
Detailbeschreibung: Skills im Detail
¶ MCP Tools Übersicht
Der Project Hub MCP Server (project-hub-mcp) stellt folgende Tools bereit:
¶ Projekte
tool_list_projects(status?)— alle Projekte (gefiltert nach Status)tool_get_project(identifier)— Projekt mit allen Metadaten ladentool_create_project(...)— neues Projekt anlegentool_update_project(project_id, ...)— Projektdaten aktualisieren
¶ Projekt-Verknüpfungen
tool_link_project(identifier, related_identifier, relation_type)— zwei Projekte verknüpfen (successor/predecessor/related)tool_unlink_project(identifier, related_identifier)— Verknüpfung entfernen, unabhängig von Richtung oder Typ
¶ Kontakte
tool_list_contacts(project_id)— alle Kontakte eines Projektstool_list_shared_contacts()— alle geteilten Kontakte (projektübergreifend)tool_add_contact(project_id, ..., is_shared?)— Kontakt hinzufügen (is_shared=truefür geteilte)tool_update_contact(contact_id, ..., is_shared?)— Kontakt bearbeiten (Sharing nachträglich änderbar)tool_delete_contact(contact_id)— Kontakt löschentool_search_contacts(query, project_id?)— Kontakte durchsuchen (inkl. geteilte)
¶ Notizen
tool_list_notes(project_id, ...)— Notizen auflistentool_get_note(note_id)— einzelne Notiz ladentool_add_note(project_id, ...)— neue Notiz erfassentool_update_note(note_id, ...)— Notiz bearbeitentool_delete_note(note_id)— Notiz löschentool_search_notes(project_id, query)— Notizen durchsuchen
¶ Knowledge
tool_get_all_knowledge(project_type)— alle Knowledge-Dokumente eines Typs ladentool_get_knowledge(project_type, doc_name)— einzelnes Knowledge-Dokument ladentool_save_knowledge(project_type, doc_name, content)— Knowledge-Dokument speicherntool_delete_knowledge(project_type, doc_name)— Knowledge-Dokument löschentool_list_knowledge(project_type)— verfügbare Knowledge-Dokumente auflisten
¶ Session
tool_get_session()— aktive Session ladentool_set_session(project_id?, ...)— Session setzentool_clear_session()— Session zurücksetzen
¶ Attachments
tool_list_attachments(project_id)— Dateianhänge eines Projekts auflistentool_attach_file(project_id, file_path)— Datei anhängen (erzeugt bei unterstützten Formaten automatisch eine lesbare.md-Geschwisterdatei)tool_list_docs(project_id)— Dokumente im docs-Ordner des Projekts auflisten
¶ Systemanforderungen
| Komponente | Version |
|---|---|
| Claude Code | Latest |
| Python | 3.11+ |
| Betriebssystem | Windows, macOS, Linux |
Kein API-Key nötig — Project Hub nutzt Claude Code's eingebauten Claude-Zugang.
Project Hub läuft nativ unter Windows — kein WSL nötig.
/project-hub:setuplöst den Python-Interpreter automatisch überpy -3auf, auch auf Geräten, bei denen derpython/python3-Alias vom Microsoft Store blockiert ist.
# 1. Marketplace hinzufügen
claude plugin marketplace add markus-michalski/project-hub
# 2. Plugin installieren
claude plugin install project-hub@project-hub
# 3. Ersteinrichtung
/project-hub:setup
Marketplace-Installation ist der bevorzugte Weg: Updates laufen künftig über
claude plugin update project-hub, ein manuellesgit pullentfällt.
# 1. Plugin klonen
git clone https://github.com/markus-michalski/project-hub \
~/.claude/plugins/project-hub
Zur ~/.claude/settings.json hinzufügen:
{
"enabledPlugins": {
"project-hub@project-hub": true
}
}
# 2. Ersteinrichtung
/project-hub:setup
¶ Konfiguration
Konfigurationsdatei: ~/.project-hub/config.yaml
name: Mein Name # Dein Name (für Kommunikations-Drafts)
language: de # Standardsprache (de / en)
Interaktive Konfiguration via /project-hub:configure.
¶ Kurzanleitung
1. /project-hub:setup # Ersteinrichtung
2. /project-hub:new-project # Neues Projekt anlegen
3. /project-hub:add-contact # Stakeholder eintragen
4. /project-hub:add-note # Erstes Meeting protokollieren
5. /project-hub:next-step # Was steht als nächstes an?
6. /project-hub:compose email # E-Mail draften
Zweite Session:
/project-hub:resume [Projektname] # Sofort weitermachen
¶ Datenspeicherung
~/.project-hub/
├── config.yaml # Plugin-Konfiguration
├── project-hub.db # SQLite-Datenbank (Projekte, Kontakte, Notizen)
├── knowledge/
│ ├── merchant-onboarding/
│ │ ├── governance.md
│ │ ├── process.md
│ │ ├── roles.md
│ │ └── vacation-handover.md
│ ├── it-project/
│ │ ├── architecture.md
│ │ ├── charter.md
│ │ └── runbook.md
│ └── {custom-type}/
│ └── ...
└── projects/
└── {project-slug}/
└── docs/
├── emails/
├── meeting-notes/
└── misc/
Unter Windows liegt dasselbe Verzeichnis unter %USERPROFILE%\.project-hub\.
¶ Knowledge-System
Das Knowledge-System speichert projekttyp-spezifisches Wissen, das automatisch beim Laden eines Projekts verfügbar wird.
Eingebaute Knowledge-Dokumente:
| Projekttyp | Dokumente |
|---|---|
merchant-onboarding |
governance.md, process.md, roles.md, vacation-handover.md |
it-project |
architecture.md, charter.md, runbook.md |
consulting |
engagement.md, governance.md, roles.md |
event |
logistics.md, runsheet.md, stakeholders.md |
marketing |
campaign-brief.md, stakeholders.md |
generic |
charter.md |
Eigene Dokumente: Einfach Markdown-Dateien unter ~/.project-hub/knowledge/{type}/ ablegen. Werden automatisch beim nächsten /resume geladen.
Knowledge verwalten: /project-hub:knowledge zeigt alle verfügbaren Dokumente und erlaubt direktes Bearbeiten im Kontext.
¶ Session-Pattern
Beim /resume lädt Project Hub in 8 Schritten:
tool_get_session()— Aktive Session prüfen- Falls kein Projekt aktiv:
tool_list_projects("active")— User wählt Projekt tool_get_project(identifier)— Vollständige Projektdaten ladentool_list_contacts(project_id)— Projektspezifische Kontakte ladentool_list_shared_contacts()— Geteilte Kontakte laden (projektübergreifend)tool_get_all_knowledge(project_type)— Domänen-Wissen ladentool_list_notes(project_id)— Notizen und Aktivitäten laden- Projekt-Zusammenfassung anzeigen
Bei direkter Angabe (/project-hub:resume Acme) wird Schritt 2 übersprungen.
¶ Weiterführende Dokumentation
- Skills im Detail — Alle 20 Skills mit Zweck und Einsatzfall
- Projekttypen — 6 eingebaute Typen + eigene erstellen
- Workflow-Beispiel — Ende-zu-Ende: Merchant-Onboarding
¶ Fehlerbehebung
¶ Problem: Plugin nicht gefunden / Skills nicht verfügbar
ls ~/.claude/plugins/project-hub/skills/
Plugin-Verzeichnis muss in ~/.claude/settings.json unter enabledPlugins eingetragen sein.
¶ Problem: venv fehlt / Python-Dependencies nicht installiert
/project-hub:setup
¶ Problem: Datenbank nicht gefunden
ls ~/.project-hub/
Falls Verzeichnis fehlt: /project-hub:setup einmalig laufen lassen.
¶ Problem: Knowledge-Dokumente werden nicht geladen
Knowledge-Dateien müssen unter ~/.project-hub/knowledge/{project-type}/ liegen. Prüfen mit /project-hub:knowledge.
¶ Problem: Setup unter Windows schlägt mit Exit-Code 49 fehl
Der python/python3-Alias ist auf manchen Windows-Geräten durch den Microsoft Store blockiert. /project-hub:setup erkennt das automatisch und fällt auf py -3 zurück. Schlägt auch das fehl: Python 3.11+ direkt von python.org installieren.
¶ Lizenz
Project Hub ist unter der PolyForm Noncommercial License 1.0.0 lizenziert. Persönliche, nicht-kommerzielle Nutzung ist frei. Kommerzielle Nutzung erfordert eine separate Lizenz.
CLA für Contributors: Beitragsvereinbarung