worply-dev/claude-code-skills

Organisationsdesign-Fähigkeit (Organisationsdesign-Skill)

Durch gezielte Fragen werden die Anforderungen ermittelt, Rollen (Agenten) definiert und darauf basierend die Verzeichnisstruktur, CLAUDE.md-Dateien sowie der Harness (Rules / Hooks / Skills / Settings) generiert.

Unterstützt alle Größenordnungen – von der Definition einer einzelnen Rolle für persönliche Ziele bis hin zu großen Organisationen.

Gesamtübersicht der Ergebnisse

.claude/
  rules/
    role-<name>.md          ← Betriebsregeln für jede Rolle (mit Pfadzuordnung)
  skills/
    ask-<name>/SKILL.md     ← Fähigkeit zum Aufrufen jeder Rolle
  settings.json             ← Hooks, Berechtigungen, Aktivierung des Agent-Teams (wird ergänzt)
org/
  <role>/CLAUDE.md          ← Entwurfsdokument für jede Rolle
  workflows/                ← Workflow-Definitionen (welches Muster für welche Aufgabe)
  README.md                 ← Organigramm (Mermaid)

Ablauf

Nutze das AskUserQuestion-Tool, um die Anforderungen interaktiv mit Auswahlmöglichkeiten zu ermitteln. Präsentiere nicht alle Schritte auf einmal, sondern gehe Schritt für Schritt vor.

Verwendung von AskUserQuestion

• Jede Frage sollte 2–4 Auswahlmöglichkeiten bieten („Sonstiges (Freitext)“ wird automatisch hinzugefügt, daher nicht selbst auflisten).
• Für Fragen, bei denen Mehrfachauswahl sinnvoll ist, multiSelect: true setzen.
• Empfohlene Optionen an den Anfang setzen und mit „(Empfohlen)“ kennzeichnen.
• Maximal 4 Fragen in einem einzigen Aufruf stellen.
• Die description der Optionen sollte ergänzende Erläuterungen enthalten, um die Entscheidung zu erleichtern.

---

Schritt 0: Bestandsaufnahme (automatisch)

Beim Start der Fähigkeit wird automatisch (ohne Benutzerfragen) Folgendes überprüft:

1. Existiert das Verzeichnis org/? (Suche mit Glob nach org/**/CLAUDE.md)

2. Wenn es existiert:

   • Lies org/README.md und die CLAUDE.md jeder Rolle.

   • Fasse die aktuelle Organisationsstruktur (Rollenliste, Beziehungen, Verantwortungsbereiche) als Text zusammen.

   • Überprüfe auch den Status des Harness:

     • Existenz von .claude/rules/role-*.md
     • Existenz von .claude/skills/ask-*/SKILL.md
     • Überprüfung der Hooks-Konfiguration in .claude/settings.json

   • Analysiere auch andere Dateien im Projekt (Quellcode, Dokumentation usw.), um zu prüfen, ob die aktuelle Organisation mit der Realität übereinstimmt.

   • Identifiziere Verbesserungspunkte unter folgenden Gesichtspunkten:

     • Abdeckungslücken: Funktionsbereiche im Projekt, für die es keine zuständige Rolle gibt.
     • Rollenüber-/unterversorgung: Nicht genutzte Rollen oder Rollen mit ungleicher Lastverteilung.
     • Inkonsistente Beziehungen: Berichtslinien oder Kommunikationspfade, die nicht der Realität entsprechen.
     • Status der Sub-Agenten: Ist eine Orchestrator-Rolle definiert? Enthalten die CLAUDE.md-Dateien der Rollen einen Abschnitt „Sub-Agent-Ausführungsprotokoll“? Ist ein empfohlenes Modell angegeben?
     • Fehlende Harness-Komponenten: Gibt es Rollen, für die noch keine Rules / Skills / Hooks generiert wurden?

   • Fasse die Verbesserungspunkte als Vorschläge zusammen.

   • Frage mit AskUserQuestion den Modus ab:

     Was möchten Sie tun? (multiSelect: false, header: "Modus")

     label	description
     Überarbeiten	Aktuelle Struktur überprüfen und verbessern
     Hinzufügen	Neue Rolle zur bestehenden Struktur hinzufügen
     Nur Harness generieren	Nur Harness (Rules/Skills/Hooks) für bestehende Rollen hinzufügen
     Neu erstellen	Vorhandene Struktur ignorieren und neu erstellen

   • Bei „Überarbeiten“: Beginne mit Schritt 3 (Rollendefinition) basierend auf den Verbesserungsvorschlägen.

   • Bei „Hinzufügen“: Beginne mit Schritt 2 (Funktionsermittlung), wobei die bereits vorhandenen Funktionen als ausgewählt gelten.

   • Bei „Nur Harness generieren“: Gehe direkt zu Schritt 5 (Harness-Generierung).

   • Bei „Neu erstellen“: Starte normal mit Schritt 1.

3. Wenn es nicht existiert: Starte normal mit Schritt 1.

---

Schritt 1: Zielklärung

Stelle die folgenden drei Fragen in einem einzigen Aufruf mit AskUserQuestion:

F1. Was möchten Sie erreichen? (multiSelect: true, header: "Ziel")

label	description
Produktentwicklung	Ein Produkt wie eine Dienstleistung oder App entwickeln
Content-Erstellung	Inhalte wie Artikel, Videos, Materialien erstellen und veröffentlichen
Prozessoptimierung	Bestehende Arbeitsabläufe verbessern oder automatisieren
Forschung & Lernen	Recherche, Analyse, Kompetenzaufbau – Wissen vertiefen

F2. Wer ist die Zielgruppe? (multiSelect: true, header: "Zielgruppe")

label	description
Ich selbst	Für persönliche Zielerreichung oder Selbstmanagement
Teammitglieder	Für Kollegen im Unternehmen oder Projekt
Kunden / Klienten	Für direkte Geschäftspartner oder Kunden
Endbenutzer	Für allgemeine Nutzer oder eine Community

F3. Wie groß ist der Umfang? (multiSelect: false, header: "Größenordnung")

label	description
Einzelperson	Konfiguration für einen persönlichen Agenten / Zuständigen
Kleines Team	Kleine Konfiguration für 2–5 Personen
Mittleres Team	Teamkonfiguration für 6–20 Personen
Organisation / Abteilung	Große Konfiguration für 20+ Personen

Ordne die Antworten in einer Checkliste und hole eine Textbestätigung vom Benutzer ein. Fahre mit dem nächsten Schritt fort, sobald Zustimmung besteht.

---

Schritt 2: Ermittlung der benötigten Funktionen

Basierend auf den Antworten aus Schritt 1 werden vier relevante Funktionen vorgeschlagen. Stelle eine Frage mit AskUserQuestion:

Welche Funktionen werden benötigt? (multiSelect: true, header: "Funktionen")

Die Auswahlmöglichkeiten werden dynamisch basierend auf dem Ziel aus Schritt 1 ausgewählt (4 Stück aus dem Pool): Planung & Strategie / Design & Architektur / Entwicklung & Implementierung / Design & UI/UX / Test & Qualitätssicherung / Recherche & Informationssammlung / Schreiben & Dokumentation / Marketing & Kundenakquise / Vertrieb & Kundenbetreuung / Kundensupport / Projektmanagement / Datenanalyse / Finanzen & Buchhaltung / Personal & Recruiting / Infrastruktur & Betrieb

Nach der Auswahl frage: „Gibt es weitere Funktionen?“. Falls ja, zeige weitere vier aus dem Restpool. Wiederhole dies, bis der Benutzer zufrieden ist.

---

Schritt 3: Rollendefinition

Basierend auf den in Schritt 2 ausgewählten Funktionen wird automatisch ein Rollenkonfigurationsvorschlag erstellt und als Text präsentiert.

F1. Ist diese Konfiguration in Ordnung? (multiSelect: false, header: "Konfigurationsprüfung")

label	description
Ja, diese Konfiguration ist OK	Mit dem vorgeschlagenen Rollenset fortfahren
Ich möchte eine Rolle hinzufügen	Es fehlen noch Rollen
Ich möchte zusammenführen/löschen	Zu viele Rollen, möchte welche zusammenführen
Ich möchte Namen ändern	Rollennamen korrigieren

Falls Änderungen nötig sind, bitte den Benutzer, dies per Freitext unter „Sonstiges“ anzugeben. Wiederhole dies, bis der Benutzer zustimmt.

F2. Wie ist die Beziehung zwischen den Rollen? (multiSelect: false, header: "Beziehung")

label	description
Flach	Alle sind gleichberechtigt, keine Hierarchie
Führungsmodell	Eine Person ist der Koordinator, die anderen sind Mitglieder
Hierarchisch	Mehrere Ebenen: Abteilungsleiter → Leiter → Mitglieder
Hub-Modell	Eine zentrale Rolle koordiniert mit allen anderen

F3. Bestätigung der Verantwortungsbereiche Präsentiere die vorgeschlagenen Verantwortungsbereiche jeder Rolle als Text und frage: „Ist dieser Inhalt in Ordnung? / Möchten Sie etwas ändern?“ (Änderungen per Freitext).

---

Schritt 3.5: Entwurf der Ausführungsarchitektur

Die Details dieses Schritts sind in architecture-design.md zu finden.

Inhalt: Auswahl von SubAgent / Agent Team, Orchestrator-Worker-Design, Teamzusammenstellung, Modellzuweisung.

---

Schritt 4: Bestätigung und Generierung

Präsentiere das Mermaid-Diagramm und die Rollenliste als Text sowie die Gesamtübersicht der Ergebnisse (siehe Abschnitt „Gesamtübersicht der Ergebnisse“).

Frage mit AskUserQuestion zur endgültigen Bestätigung:

Darf ich die Generierung durchführen? „Generieren / Möchte korrigieren“. Nach Bestätigung erfolgt die vollständige Generierung inklusive Schritt 5 (Harness-Generierung).

---

Schritt 5: Harness-Generierung

Die Details der Generierungslogik sind in harness-generation.md zu finden. Vorlagen sind in templates.md zu finden.

Regeln für die Verzeichnisstruktur:

• Das Verzeichnis jeder Rolle wird unter org/<role>/ erstellt.
• Falls das org/-Verzeichnis bereits existiert, wird die bestehende Konfiguration ergänzt oder aktualisiert.
• Bei Hierarchien werden verschachtelte Verzeichnisse angelegt, bei flachen Strukturen werden sie parallel angeordnet.

Wichtige Hinweise

• Rollennamen (Verzeichnisnamen) müssen in englischer Kleinschreibung im Kebab-Case sein.
• Der Inhalt der CLAUDE.md wird in deutscher Sprache verfasst.
• Stelle sicher, dass die Verantwortungsbereiche jeder Rolle klar voneinander getrennt sind.
• Vermeide Begriffe wie „Firma“ oder „Unternehmen“; verwende stattdessen allgemeine Begriffe wie „Organisation“, „Team“ oder „Konfiguration“.
• Bei persönlicher Nutzung werden Rollen als „Zuständige Person“ oder „Agent“ bezeichnet.
• Bei der Harness-Generierung ist darauf zu achten, dass die vorhandene settings.json nicht beschädigt wird – führe einen differenzierten Merge durch.
• Für allowed-tools gilt das Prinzip der minimalen Rechtevergabe: Füge nur die Tools hinzu, die für die jeweilige Rolle tatsächlich benötigt werden.