Rezept: Workspace mit Claude Code entwickeln

tm pull holt .claude/ und docs/ — Claude versteht die Plattform und baut Tools für dich.

Wenn du als Entwickler einen neuen Workspace baust oder einen bestehenden erweiterst, ist Claude Code (der Anthropic-Editor) ein massiver Beschleuniger. Der Trick: TaskMonkey gibt dir per tm pull ein vorkonfiguriertes Projekt-Setup, das Claude sofort versteht.

#Was du bekommst

Nach tm pull liegen drei Dinge in deinem Workspace-Ordner:

• .claude/ — Skills, Subagent-Setups, CLI-Allowlist. Claude weiß damit, welche Tool-Konventionen gelten, welche tm-Befehle es ohne Rückfrage ausführen darf, wie Tests aussehen
• docs/ — das vollständige Handbuch als Markdown. Claude nutzt es als Referenz statt zu raten
• Deine eigentlichen Workspace-Configs (apis.php, tools/, assistants/, ...)

Effekt: Du sagst „bau mir ein Tool, das die letzten 5 Bestellungen aus Shopify holt" — und bekommst etwas, das zur Plattform passt. Korrekte Tool-Felder, richtiger Ordnerpfad, Logger-Aufrufe, sinnvolle args_fixture.

#Setup

# CLI installieren (falls noch nicht)
npm install -g taskmonkey-cli

# Anmelden + initial pull
tm login
tm pull

# Claude Code im Workspace öffnen
cd ~/workspaces/mein-workspace
claude

#Typischer Tag

# Hintergrund: live-sync beim Speichern
tm watch

In Claude Code:

Du: bau ein Tool, das aus unserer Shopify-API alle Bestellungen
    der letzten 24h holt, gruppiert nach Status

Claude:
  Ich lege tools/shopify/getOrdersByStatus.php an.
  Schaue erst kurz ins Handbuch, wie ihr Tools strukturiert …

  [liest docs/handbook/04-tools/create-in-config.md]
  [liest config/apis.php — sieht dass shopify schon registriert ist]

  Hier der Vorschlag: …

Du: passt — sync und teste mit einem fixture

Claude:
  Speichern erfolgt. tm watch hat synchronisiert.
  Ich teste mit tm test-tool getOrdersByStatus
  …
  Ergebnis: 3 pending, 1 fulfilled. Möchtest du das Tool
  in den Assistant "bestellungen" einbinden?

#Was die .claude/-Skills typischerweise enthalten

Konkrete Skill-Liste hängt vom Workspace ab — tm pull zieht jeweils die aktuellsten.

#CLI-Allowlist

In .claude/settings.local.json (oder settings.json) steht eine Liste von Befehlen, die Claude ohne Rückfrage ausführen darf. Typisch enthalten:

• tm sync, tm pull, tm watch
• tm test-tool *, tm test-chat *, tm test-conversations
• tm chat, tm tasks, tm history
• tm monitor, tm logs

Damit verbringst du keine Zeit mit „erlauben?"-Klicks für die täglichen Sync-Operationen.

#Workflow für ein neues Feature

1. In Claude beschreiben, was du willst — geschäftlich, nicht technisch
2. Claude liest relevante Doku-Seiten und existierende Tools
3. Claude schreibt die Datei(en), tm watch synct automatisch
4. Claude schlägt vor, das Tool mit tm test-tool zu prüfen — du sagst ja
5. Bei Erfolg: Claude bietet an, einen Conversation-Test zu schreiben
6. Du committest in deinem Editor manuell — Claude bereitet eine Commit-Message vor

#Wichtig

• Claude sieht den Workspace, nicht die Plattform-Codebasis. Es weiß über das Handbuch, wie Tools funktionieren, aber es kann nicht in die Plattform-Internals reinschauen. Das ist Absicht — bewahrt Sicherheit und Plattform-Stabilität.
• apis.php enthält Secrets — wenn du Claude mit tm pull's apis.php arbeiten lässt, sieht es API-Keys. Wenn das ein Problem ist (Compliance, Audit): vor claude lieber keys temporär durch Platzhalter ersetzen.
• Skills aktualisieren sich — gelegentlich tm pull machen, um die neuesten .claude/-Definitionen zu bekommen.

#Wenn du nicht Claude Code nutzt

Funktioniert auch mit anderen LLM-Editor-Integrationen (Cursor, Continue, Cline, ...). Die .claude/-Skills sind speziell auf Claude Code zugeschnitten, aber das Markdown unter docs/ ist universell — du kannst es jedem LLM-Editor als Kontext geben.