Starter Harness Designer — Workspace v1

„Ein gutes Template ist besser als ein 100-seitiger Leitfaden."

Für wen ist dieser Skill gedacht?

Personen, die zum ersten Mal einen Harness erstellen
Nicht-Entwickler (Projektmanager, Marketingspezialisten, Autoren, Anwälte, Lehrer, Betriebsmitarbeiter usw.)
Personen, die schnell mit einer validierten Struktur beginnen möchten

Dieser Skill behält die gleiche 3-Phasen-Philosophie (Planer → Generator → Evaluator) wie der Profi-Skill harness-designer-workspace bei, reduziert jedoch die Eingabekomplexität und die Ausgabe-Präzision auf ein Anfängerniveau.

Phase	Profi	Starter (dieser Skill)
Planer	4-stufige Discovery, offene Fragen	3 Multiple-Choice-Fragen → Abgleich mit Exemplar-Nummer
Generator	Design → Datei-/Strukturerstellung	Exemplar-Replikation + Substitution
Evaluator	8-Säulen-unabhängige Prüfung	Leichte Checkliste — nur fehlende Substitutionen und defekte Referenzen

Beziehung zu anderen Harness-Skills

              │ Profi (freies Design)           │ Anfänger (Exemplar-Replikation)
──────────────┼─────────────────────────────────┼────────────────────────────
 Workspace    │ harness-designer-workspace      │ harness-starter-workspace ★ (dieser Skill)
──────────────┼─────────────────────────────────┼────────────────────────────
 Coding       │ harness-designer-coding         │ harness-starter-coding

Wann dieser Skill nicht verwendet werden sollte

App-/Webservice-/API-Entwicklung → harness-starter-coding
Fortgeschrittene Benutzer, die Gestaltungsfreiheit benötigen → harness-designer-workspace
Einfache Fragen oder einmalige Aufgaben → kein Skill erforderlich

Ausführungsablauf (insgesamt 5 Minuten)

1. [Planer] 3 Multiple-Choice-Fragen
2. [Planer] Abgleich mit Exemplar-Nummer + Preset-Empfehlung
3. [Generator] Replikation des harness-100-Exemplars
4. [Generator] Substitution von Projektname und Domänenbegriffen
5. [Evaluator] Leichte Checkliste (5 Sekunden)
6. Abschlussmeldung („So verwenden Sie es jetzt")

Phase 0: Pattern Match (Planer)

Frage 1 — Was möchten Sie tun? (ein Satz in natürlicher Sprache)

Der Benutzer antwortet in einem Satz. Beispiele:

„Ich möchte ein Team, das die Planung, das Drehbuch und das Thumbnail für ein YouTube-Video erstellt."
„Ein Team, das Risikoklauseln aus Verträgen extrahiert."
„Automatisierung des monatlichen Newsletter-Versands."

Frage 2 — Welche Kategorie passt am besten? (Multiple Choice, 8 Optionen)

Siehe references/exemplar-index.md. Auswahl aus den folgenden 8 Kategorien:

Nr.	Kategorie	Beispiele
1	🎬 Content-Erstellung	YouTube, Podcast, Newsletter, Comics, Übersetzung
4	📊 Business & Strategie	Startup, Marktforschung, Preisgestaltung, Finanzmodell
5	🎓 Bildung & Lernen	Sprach-Tutor, Prüfungsvorbereitung, Curriculum-Design
6	⚖️ Recht & Compliance	Verträge, Patente, Datenschutz (DSGVO)
7	🏃 Lebensstil	Ernährung, Fitness, Steuern, Reisen
8	📝 Kommunikation & Dokumente	Technisches Schreiben, SOP, Angebote
9	🏢 Betrieb & Prozesse	Einstellung, Onboarding, Audit, Beschaffung
10	🌐 Spezialisierte Domänen	Immobilien, ESG, IP-Portfolio

Basierend auf den Schlüsselwörtern aus Frage 1 werden automatisch 1–3 Empfehlungen vorgeschlagen; der Benutzer muss sie nur bestätigen.

Behandlung fehlgeschlagener Zuordnungen (Ähnlichkeit < 0.5):

Die 3 nächsten Kandidaten werden vorgeschlagen mit der Frage: „Welche davon passt am besten?"
Wenn keine passt, wird eine Umleitung zum Profi-Skill harness-designer-workspace empfohlen.

Frage 3 — Wie lautet der Projektname?

Kurz genug für Ordner- und Dateinamen (z. B. youtube-production, contract-review, monthly-newsletter).

Frage 4 — Möchten Sie einen Änderungsverlauf? (optional, ja/nein)

„Soll ein Bereich geschaffen werden, um festzuhalten, was und warum sich bei zukünftigen Verbesserungen dieses Teams ändert?"

ja → Automatische Erstellung des 05-flow-history/-Wikis + flow-change-protocol.md (erster Build wird als Änderung 0001 erfasst)
nein → Keine Erstellung (spätere manuelle Hinzufügung möglich)

Verwendungszweck: Team-Retrospektiven, Überprüfung der Gründe für Rollbacks, Referenz für die Erstellung ähnlicher Teams. Keine Auswirkung auf den täglichen Gebrauch.

Verwaltungsprinzip: Dieses Protokoll dokumentiert nur Änderungen am Workflow-System (Regeln, Prozesse, Tools, CLAUDE.md). Die vom System erstellten Ergebnisse (Rechercheergebnisse, Berichte, Analysen, Agenda-Einträge) werden nicht dokumentiert. Unterscheidungskriterium: „Wäre das nächste Ergebnis anders, wenn diese Änderung nicht vorgenommen worden wäre?" → Anders = Systemänderung = Dokumentation / Gleich = Ergebnis = keine Dokumentation erforderlich. Details: 00-system/protocols/flow-change-protocol.md

Frage 3.5 (bedingt — nur für forschungsorientierte Kategorien)

📊 Business & Strategie, 🎓 Bildung & Lernen, 🌐 Spezialisierte Domänen — wird nur bei Auswahl dieser Kategorien angezeigt. Bei inhaltsorientierten Kategorien (z. B. Content-Erstellung) wird die Frage übersprungen.

„Müssen Sie bei der Bearbeitung mehrerer Agenden auf bestehende Forschungsergebnisse verweisen?"

Ja → Inklusive Wiki:
- Überprüfung der Installation des /graphify-Skills (automatisch: ~/.claude/skills/graphify/ oder .claude/skills/graphify/)
- Bei fehlender Installation: Erklärung + Installationsoption (global/projektbezogen/nicht installieren)
- ⚠️ Bei Auswahl von „Nicht installieren": „Wiki-Funktion deaktiviert. Kann später durch Installation von /graphify und /wiki-update erstellt werden."
Nein → Kein Wiki

Phase 1: Preset-Auswahl (Bewertungsgewichtung)

Nach erfolgreichem Abgleich werden 3 Presets zur Auswahl empfohlen:

Preset	Beschreibung	Automatische Empfehlungskriterien
[Ausgewogen] (Standard)	Gleichmäßige Gewichtung aller Qualitätskriterien	Standardwert
[Qualität zuerst]	Reviewer, Testszenarien, NOT-Trigger doppelt gewichtet	Kategorien Recht, Medizin, Finanzen, IP
[Geschwindigkeit zuerst]	Scale Mode = Single, nur leichte Checkliste	Einmaliger Prototyp, Einzelarbeit

Das ausgewählte Preset wird in _workspace/00_input.md festgehalten.

Phase 2: Generator — Exemplar-Replikation und Substitution

Replikationsschritte (automatischer Fallback)

Die Verfügbarkeit von gh wird automatisch erkannt, um die optimale Download-Methode zu wählen. git allein reicht ebenfalls aus.

EXEMPLAR="{NN}-{exemplar-name}"   # Ergebnis des Planer-Abgleichs (z. B. 01-youtube-production)
BASE="ko/$EXEMPLAR/.claude"

if command -v gh &>/dev/null && gh auth status &>/dev/null 2>&1; then
  # ── Methode A: GitHub CLI (gh) ──────────────────────────────
  echo "📡 Download über gh api-Methode..."
  FILES=$(gh api "repos/revfactory/harness-100/git/trees/main?recursive=1" \
    --jq ".tree[] | select(.path | startswith(\"$BASE/\")) | select(.type==\"blob\") | .path")
  mkdir -p .claude/agents .claude/skills
  while IFS= read -r filepath; do
    rel="${filepath#$BASE/}"
    dest=".claude/$rel"
    mkdir -p "$(dirname "$dest")"
    gh api "repos/revfactory/harness-100/contents/$filepath" \
      --jq '.content' | base64 -d > "$dest"
    echo "  ✅ $dest"
  done <<< "$FILES"
else
  # ── Methode B: git sparse checkout (wenn gh nicht verfügbar) ─
  echo "📡 Download über git sparse checkout-Methode..."
  TMP=$(mktemp -d)
  git clone --depth 1 --filter=blob:none --sparse \
    https://github.com/revfactory/harness-100.git "$TMP"
  git -C "$TMP" sparse-checkout set "$BASE"
  mkdir -p .claude
  cp -r "$TMP/$BASE/." .claude/
  rm -rf "$TMP"
  echo "  ✅ sparse checkout abgeschlossen"
fi

Bedingung	Verwendete Methode	Benötigte Tools
`gh` installiert + angemeldet	Methode A (gh api)	gh
Nur `git` verfügbar	Methode B (sparse checkout)	git
Beides nicht verfügbar oder fehlgeschlagen	Methode C (direkte Erstellung durch Claude nach Benutzerbestätigung)	Keine

Wenn sowohl Methode A als auch B fehlschlagen, informiert Claude den Benutzer direkt:

⚠️ Das Template konnte nicht von GitHub abgerufen werden.

Ursache: Weder gh noch git sind verfügbar, oder es besteht keine Internetverbindung.

In diesem Fall kann Claude die Harness-Dateien auf Basis der Exemplar-Index-Beschreibung direkt erstellen. Beachten Sie jedoch, dass es sich nicht um eine tatsächlich validierte Vorlage handelt, sondern um eine strukturelle Reproduktion durch Claude. Dies kann zu Qualitätsunterschieden führen.

Möchten Sie fortfahren?

Ja → Claude erstellt die .claude/-Dateien direkt (basierend auf exemplar-index.md)

Nein → Abbruch hier. Bitte stellen Sie die Internetverbindung her oder installieren Sie git und versuchen Sie es erneut.

Wenn der Benutzer Ja wählt: Claude liest die entsprechende Exemplar-Beschreibung in references/exemplar-index.md und erstellt direkt die Struktur mit CLAUDE.md, agents/ und skills/. Wenn der Benutzer Nein wählt: sofortiger Abbruch mit Anleitung zum erneuten Versuch.

Ergebnis nach Abschluss:

.claude/
├── CLAUDE.md
├── agents/
│   ├── {spezialist-1}.md
│   ├── {spezialist-2}.md
│   ├── {spezialist-3}.md
│   ├── {spezialist-4}.md
│   └── {reviewer}.md
└── skills/
    ├── {orchestrator}/skill.md
    └── {agent-erweiternd}/skill.md

Erstellung des Ordners _workspace/ (für Ergebnisse, Nummerierungskonvention 00_input.md, 01_*.md, ...)

Substitutionsregeln

Ursprungselement	Substitutionsinhalt	Beispiel
Harness-Name	Projektname des Benutzers	`01-youtube-production` → `my-youtube-show`
Domänenbegriffe (global)	Domänenbegriffe des Benutzers	„YouTube-Video" → „Podcast-Episode"
Trigger-Schlüsselwörter	Domänenschlüsselwörter des Benutzers	Youtube-bezogen → Podcast-bezogen
Agenten-Rollenname	Nur bei Bedarf ersetzen	`scriptwriter` → Beibehaltung empfohlen
Domänenframeworks	Unbedingt beibehalten	Porter's, IRAC, Bloom's sind Kernkompetenzen
`_workspace/NN_*.md`	Beibehalten (Nummerierungskonvention)	Nummern niemals ändern

Zusätzliche Ordnerstruktur (v2):

50-reports/[Agendaname]/v[N]/report.md — isolierte Berichte pro Agenda
60-exports/[Agendaname]/ — abgeleitete Ergebnisse (Folien, externe Freigaben usw.)
CARL Frontmatter: agenda:, type:, tags: YAML-Frontmatter in den 70-playbook/-Templates enthalten
(bei Wiki-Auswahl) 45-wiki/ — Wissensgraph-Speicher
(bei Wiki-Auswahl) research-wiki-Skill — referenziert das unabhängig geschützte Wiki
(bei Wiki-Auswahl) /wiki-update-Befehl — Erstellung und Aktualisierung des Wikis
(bei Frage 4 mit Ja) 05-flow-history/ + 00-system/protocols/flow-change-protocol.md — Flow-Änderungsverlaufs-Wiki. Erstellung von 5+1 Dateien basierend auf ~/.claude/skills/harness-designer-workspace/references/flow-history-template.md.

Liste der automatischen Substitutionsverbote:

Eingebettete Framework-Namen (AIDA, IRAC, Bloom's, ADDIE, Porter's, DCF, Van Westendorp, SMART usw.)
Verzeichnisname _workspace/ und Ergebnisnummern
Protokollbegriffe wie SendMessage, TaskCreate
Definitionen der Scale Modes
Verzeichnisname 45-wiki/
Skill-Name research-wiki
Text der Unabhängigkeitsprotokoll-Wiki-Referenzregel
Automatische Korrektur durch bkit: Domänenframeworks (AIDA, IRAC, Bloom's usw.), independence-protocol, SendMessage-Protokoll, _workspace/-Nummerierungssystem — dürfen nicht durch Vorschläge von bkit-Agenten (code-analyzer, pm-lead usw.) geändert werden
Schleifenelemente: Abschlusskriterien (Endbedingungen), Reviewer-Prüfreihenfolge (Reviewer ist der Letzte), Bewertungsformat des review_report — Substitution oder Löschung verboten (eine Schleife benötigt Goal+Check+Endbedingung)

Begriffserklärung (für Benutzererklärungen, interne Struktur bleibt unverändert)

Interne Dateien bleiben im Original. Nur bei Erklärungen für Benutzer wird vereinfacht:

Original	Vereinfacht
Orchestrator	Teamleiter
Agent-Extending Skill	Fachwissensbuch
Dependency DAG	Aufgabenreihenfolge
Scale Modes	Teamgrößenmodus
Trigger Boundaries	Aufrufbedingungen
Cross-validation	Gegenprüfung

Phase 3: Evaluator — Leichte Checkliste

Anstelle der 8-Säulen-Prüfung des Profi-Skills wird nur die Substitutionsintegrität geprüft.

Automatische Prüfung (5 Sekunden)

Bei Fehlschlag

Fehlende Substitution erkannt → Rückfrage an den Planer („Welchen Begriff möchten Sie ersetzen?")
Strukturelles Defizit → Erneute Replikation des entsprechenden Exemplars und erneute Substitution
3 Fehlschläge → Umleitung zum Skill harness-designer-workspace

Phase 4: Abschlussmeldung (vereinfachter Bericht für Nicht-Entwickler)

✅ Der Harness ist bereit!

📁 Speicherort: /ihr-projekt/.claude/
👥 Teammitglieder (5):
   - Stratege: Themenfindung, Wettbewerbsanalyse
   - Drehbuchautor: Erstellung des eigentlichen Drehbuchs
   - Thumbnail-Designer: Bildgestaltung
   - SEO-Verantwortlicher: Suchmaschinenoptimierung
   - Reviewer: Gesamtqualitätsprüfung

🚀 Verwendung:
   1. Geben Sie in Claude Code "/meine-youtube-show plane das nächste Video" ein
   2. Das Team arbeitet nacheinander, Ergebnisse werden im Ordner _workspace/ gespeichert
   3. Ergebnisse in der Reihenfolge 00_input.md bis 05_review_report.md

🔄 Arbeitsweise des Teams (Schleife):
   Das Team arbeitet in einer Schleife: „Ziel (Goal) → Arbeit → Prüfung (Check) → Abschluss bei Bestehen".
   Der letzte Reviewer-Bericht (0X_review_report.md) zeigt das Prüfergebnis.
   Wenn das Ergebnis nicht zufriedenstellend ist, fordern Sie bitte konkret eine Überarbeitung an —
   diese endgültige Entscheidung ist Ihre Aufgabe (äußere Schleife).

📘 Nächste Schritte:
   - Falls Ihnen etwas nicht gefällt, bearbeiten Sie .claude/agents/{Rolle}.md
   - Für komplexere Anforderungen verwenden Sie den Skill harness-designer-workspace

Referenzen

exemplar-index.md — Index von 73 Workspace-Exemplaren
Original: https://github.com/revfactory/harness-100 (Apache-2.0)
Profi-Variante: harness-designer-workspace
Coding-Variante: harness-starter-coding

Starter Harness Designer – Workspace v1

Was ist Starter Harness Designer – Workspace v1?

In Ihrer bevorzugten KI fragen

Dokumentation