Liborius
30f45a5889
DOJO.md: - #22 (klassische variation_tags-Endpoints) ergänzt um Cloud-Update- Hinweis: in Plenty Cloud gesperrt, Verweis auf #34 - #33 NEU: Silent-Deny erkennen via Content-Type-Check (200+text/html als Erfolg melden ist die häufigste Lügen-Quelle bei Plenty-Schreib- Operationen) - #34 NEU: Variation-Tag-Manipulation in Plenty Cloud — Lese-Pfade, add-only PUT auf /rest/pim/variations für Hinzufügen, Bulk-DELETE /rest/pim/variations/tags für Entfernen; Plenty-Rollen-System hat keine Tag-Edit-Permission ANTI-PATTERNS.md: - #13 (Tag-Operationen idempotent) ergänzt um Cloud-Update-Hinweis - #19 NEU: Klassische /variation_tags-Endpoints in Plenty Cloud nutzen (Silent-Deny-Pattern, Verweis auf DOJO #34 als Fix)
Plenty Dojo
Gesammelte Lektionen aus der Arbeit mit der Plentymarkets REST API — von AI-Agenten für AI-Agenten.
Dieses Repo ist eine geteilte Wissensbasis, die Claude Code (oder andere AI-Coding-Agenten) beim Arbeiten mit Plentymarkets nutzen und erweitern.
Was ist drin?
| Datei | Inhalt |
|---|---|
DOJO.md |
Allgemeine API-Patterns & Lektionen |
ANTI-PATTERNS.md |
Was man NICHT tun soll |
instances/ |
Platz für shop-spezifische Lektionen (gitignored, siehe unten) |
Installation
1. Repo klonen
git clone https://git.tradeo.de/sebastian/plenty-dojo.git ~/.claude/plenty-dojo
2. Install-Script ausführen
bash ~/.claude/plenty-dojo/install.sh
Das Script:
- Symlinkt den
/plenty-dojoSkill nach~/.claude/commands/ - Erstellt eine Vorlage für deine Plenty-ID unter
instances/
3. Shop-spezifische Lektionen einrichten (optional)
Das instances/-Verzeichnis ist für shop-spezifische Learnings (eigene Status-Codes, Workflows, IDs). Diese werden nicht ins Haupt-Repo gepusht.
Option A — Eigenes PID-Repo (empfohlen für Teams):
Wenn dein Team ein eigenes PID-Repo hat (z.B. plenty-dojo-7843), klone es als instances/:
rm -rf ~/.claude/plenty-dojo/instances
git clone <PID-REPO-URL> ~/.claude/plenty-dojo/instances
Danach kannst du shop-spezifische Änderungen separat committen und mit deinem Team teilen.
Option B — Lokale Datei (nur für dich):
Erstelle einfach eine Datei instances/<DEINE-PID>.md — sie wird vom Haupt-Repo ignoriert.
4. CLAUDE.md ergänzen
Füge in die CLAUDE.md deines Projekts (oder global in ~/.claude/CLAUDE.md) ein:
## Plenty Dojo
- Vor jeder Plenty-Integration die Dojo-Dateien lesen:
- `~/.claude/plenty-dojo/DOJO.md`
- `~/.claude/plenty-dojo/ANTI-PATTERNS.md`
- `~/.claude/plenty-dojo/instances/<DEINE-PID>.md` (falls vorhanden)
- Nach jedem Bugfix prüfen, ob ein neues Learning ins Dojo gehört (`/plenty-dojo lernen`).
Nutzung
Der Skill wird über Claude Code aufgerufen:
| Befehl | Was passiert |
|---|---|
/plenty-dojo oder /plenty-dojo lernen |
Analysiert die aktuelle Konversation und schlägt neue Einträge vor |
/plenty-dojo zeigen |
Zeigt alle Einträge mit Statistik |
/plenty-dojo suchen <begriff> |
Durchsucht alle Dojo-Dateien |
/plenty-dojo sync |
Holt neue Einträge von anderen und pusht eigene |
Beitragen
Direkt in DOJO.md oder ANTI-PATTERNS.md schreiben und pushen. Der /plenty-dojo lernen Befehl hilft beim Formulieren — er analysiert die aktuelle Konversation, klassifiziert das Learning (allgemein vs. shop-spezifisch) und formatiert den Eintrag.
Jeder Eintrag enthält:
- Lektion — ein Satz
- Warum — was genau passiert ist
- Pattern — Codebeispiel (richtig)
- Anti-Pattern — Codebeispiel (falsch)
- Entdeckt — Datum + Kontext