Claude Code Best Practice: ein lebendiger Index für den Übergang vom Improvisieren zum Arbeiten mit Agenten

Alles, was man über shanraisshan/claude-code-best-practice wissen muss: ein Referenzleitfaden, Beispiele und Workflows, um die Primitiven von Claude Code diszipliniert zu nutzen.

---

Was Claude Code Best Practice ist

Claude Code Best Practice ist ein von Shayan Rais (shanraisshan) kuratiertes Dokumentationsrepository. Sein erklärtes Ziel ist der Übergang vom „Vibe Coding” zur Agenten-Engineering. Es liefert kein Modell, keinen Server und kein installierbares Plugin: Es sammelt und verknüpft Dokumentation, versionierte Beispiele und Empfehlungen für Claude Code.

Seine Landkarte umfasst Subagenten, Befehle, Skills, Hooks, MCP-Server, Konfiguration, Speicher, Wiederherstellungspunkte, Startoptionen und Workflows. Das Repository unterscheidet drei Dinge: die Best-Practice-Dokumentation, eine lokale Implementierung unter .claude/ und externe Quellen. Deshalb dient es eher als Kurs und Musterkatalog denn als einzelner vorgeschriebener Workflow.

Der Leitfaden selbst empfiehlt, ihn nicht als einen Skill zu lesen, den man installiert und ausführt. Er rät dazu, die Primitiven von Claude Code zu studieren, das Beispiel /weather-orchestrator auszuführen und das Muster Befehl → Agent → Skill für den eigenen Workflow wiederzuverwenden.

Der Ursprung: Dokumentation eines sich schnell wandelnden Sets

Das Repository wurde am 31. Oktober 2025 erstellt. Der erste Commit von diesem Zeitpunkt trägt schlicht den Titel Initial commit. Das GitHub-Konto identifiziert seinen Autor als Shayan Rais, Softwarearchitekt bei disrupt.com, mit Sitz in Karachi, Pakistan.

Während dieser Recherche tauchte kein unabhängiger, überprüfbarer Launch-Eintrag auf. Die überprüfbare Geschichte beschränkt sich daher auf die Erstellung des Repositorys und seine öffentliche Entwicklung. Das README präsentiert sich als praktische Antwort auf die kontinuierliche Erweiterung von Claude Code: Es führt eine Funktionstabelle, eine Sammlung von Tipps aus offiziellen und Community-Quellen, lokale Implementierungen und ein Berichtsprotokoll.

Im Projekt besteht eine zentrale Spannung: Claude Code erhält immer mehr native Fähigkeiten, während das Ökosystem externe Befehle, Skills und Frameworks hervorbringt. Das Repository schlägt nicht vor, das Native zu ersetzen. Im Gegenteil, es verlinkt die offizielle Anthropic-Dokumentation zusammen mit eigenen und Drittanbieter-Beispielen; es listet zum Beispiel Planungsmodi, Agententeams, Worktrees, geplante Aufgaben, Reviews und Konfiguration. Der Leitfaden versucht, diese Teile zu ordnen und klarzustellen, was ein nativer Mechanismus ist und was eine Praxis oder Erweiterung.

Philosophie und Prinzipien

Die überprüfbare Philosophie lässt sich so zusammenfassen:

• Vom Gespräch zur Agenten-Engineering. Der Untertitel des Projekts beschreibt einen Wandel von der Improvisation hin zu einem reproduzierbaren Prozess.
• Die Primitiven lernen, bevor man Rezepte kopiert. Das README verlangt, Agenten, Befehle, Skills und Hooks zu verstehen, bevor man einen Workflow zusammensetzt.
• Wissen, Orchestrierung und Implementierung trennen. Die Praxisdokumente werden von den ausführbaren Dateien unter .claude/ und einem Orchestrierungsbeispiel unterschieden.
• Planen, ausführen, überprüfen und liefern. Die Methodentabelle organisiert ihre Optionen um Recherche, Planung, Ausführung, Review und Veröffentlichung.
• Kontext bewahren und verifizieren. Zu den Tipps gehören neue Sitzungen für neue Aufgaben, Zusammenfassungen vor dem Zurückgehen, Subagenten zur Isolierung von Zwischenausgaben und Review vor dem Zusammenführen von Änderungen.

Das sind weder Gesetze noch experimentelle Ergebnisse des Repositorys. Es ist eine Kuration von Empfehlungen, deren Ursprung in jeder Zeile verlinkt ist. Das README selbst hält offene Fragen zu Speicher, Anweisungen, Konflikten zwischen Skills und veralteter Dokumentation fest; das verhindert, die Agentendisziplin als gelöstes Problem darzustellen.

Wie es funktioniert

Der Inhalt ist in Verzeichnisse für Praxis, Implementierung, Entwicklungsworkflows, Berichte, Tutorials, Videos und eine Beispielkonfiguration gegliedert. Das Demonstrationsmuster lautet:

1. Claude Code mit claude starten.
2. /weather-orchestrator aufrufen.
3. Den Befehl einen Agenten aufrufen lassen, der wiederum einen Skill nutzt.

Dieses Beispiel drückt die vom Repository vorgeschlagene Zusammensetzung aus: Befehle sind wiederverwendbare Einstiegspunkte, Agenten liefern Kontext oder Spezialisierung, und Skills kapseln Anweisungen und Ressourcen. Das README verortet die Formate unter .claude/commands/<name>.md, .claude/agents/<name>.md und .claude/skills/<name>/SKILL.md.

Der Katalog dokumentiert auch Arbeitsweisen, die kein Code des Repositorys sind: --worktree oder -w für Isolation, /code-review ultra und claude ultrareview [ziel] für Reviews, /ultraplan für Planung sowie /loop oder /schedule für wiederkehrende Aufgaben. Es enthält eine modellübergreifende Methodik: in Claude Code planen und ein Qualitäts-Review in Codex über zwei Terminals durchführen, oder je nach Fall ein Plugin, MCP oder einen Router verwenden.

Die konkreteste praktische Empfehlung ist, einen sich wiederholenden Prozess in einen versionierten Befehl oder Skill umzuwandeln. Gleichzeitig weist das Repository auf operative Risiken hin: gefährliche globale Berechtigungen vermeiden, Berechtigungslisten und Isolation bevorzugen und automatische Workflows nicht Tests, Review oder Observability ersetzen lassen.

Offizieller und halboffizieller Status

Das Projekt ist community-getragen, kein Anthropic-Repository. Das README dokumentiert keine Veröffentlichung im offiziellen Claude-Code-Plugin-Marktplatz. Sein Autor ist Shayan Rais, und die GitHub-API ordnet es nicht Anthropic zu.

Seine Beziehung zu Anthropic ist eine Referenz- und Kompatibilitätsbeziehung: Es verlinkt wiederholt die offizielle Claude-Code-Dokumentation für Funktionen wie Subagenten, Skills, Hooks, MCP, Konfiguration, Speicher, Reviews und Worktrees. Es enthält auch Links zu offiziellen anthropics/skills-Ressourcen und der Claude-Code-Dokumentation. Das bietet Nachvollziehbarkeit für einen Teil seiner Aussagen, entspricht aber keiner Billigung, Zertifizierung oder Unterstützung durch den Anbieter.

In der Praxis kann man es nur im informellen Sinn als halboffiziellen Leitfaden betrachten, dass er offizielle Funktionen katalogisiert und seine Quellen zitiert. Es gibt keine gefundenen Belege für eine Aufnahme in einen offiziellen Marktplatz, ein Sponsoring durch Anthropic oder eine Bezeichnung als Standard. Das README zeigt kommerzielle Unterstützung von disrupt.com und ClaudeKit, was ebenfalls nicht mit einer Unterstützung durch Anthropic verwechselt werden sollte.

Das Ökosystem

Repositories desselben Autors

Das Konto von Shayan Rais zeigt eine kleine Sammlung von Repositories, die denselben Ansatz erweitern. Die folgenden Zahlen stammen aus der am 1. August 2026 abgefragten GitHub-API:

• shanraisshan/claude-code-hooks: Beispiele für Claude-Code-Hooks mit Sound; 491 Sterne und 48 Forks.
• shanraisshan/codex-cli-best-practice: entsprechender Leitfaden für Codex CLI; 949 Sterne und 64 Forks.
• shanraisshan/codex-cli-hooks: Hooks für Codex CLI; 65 Sterne und 7 Forks.
• shanraisshan/gemini-cli-best-practice: entsprechender Leitfaden für Gemini CLI; 70 Sterne und 6 Forks.
• shanraisshan/gemini-cli-hooks: Hooks für Gemini CLI; 9 Sterne und 2 Forks.
• shanraisshan/ralph-wiggum-self-evolving-loop: Schleife, die Fragen erzeugt, um Modelle unter Druck zu setzen; 41 Sterne und 4 Forks.
• shanraisshan/claude-code-status-line: Statuszeile mit Kontextnutzung, Git-Status und Modell; 60 Sterne und 7 Forks.
• shanraisshan/draw-json-architecture-skill: Skill zum Erklären einer Architektur in einem JSON-basierten HTML-Viewer; 7 Sterne und 1 Fork.

Das README verlinkt direkt die ersten fünf als Schwester-Repositories. Zusammengenommen deuten sie auf eine Strategie hin, Dokumentation und Workflow-Beispiele an verschiedene Agenten-Schnittstellen anzupassen, statt ein einziges Framework zu schaffen, das sie abstrahiert.

Ableger, Portierungen und Community-Übersetzungen

Die GitHub-API zählt 6.360 Forks des Leitfadens. Zu den sichtbaren gefundenen Ablegern gehören:

• quizD/claude-code-best-practice, ein Fork mit 14 Sternen. Sein Autor eröffnete den Pull Request #40, um das README ins vereinfachte Chinesisch zu übersetzen.
• lhfer/claude-code-best-practice-zh, ein Fork und eine Anpassung für chinesischsprachige Entwickler mit 3 Sternen und 1 Fork.
• clxzl/claude-code-best-practice-cn, ein Community-Repository, das im Suchergebnis nicht als Fork markiert ist und als chinesische Ausgabe der Best Practices beschrieben wird; 125 Sterne und 37 Forks.
• moekyawaung-graduate/claude-code-best-practice, ein Fork mit 11 Sternen.
• paullarionov/claude-code-best-practice, ein Fork mit 10 Sternen.

Es gibt auch Lokalisierungsversuche innerhalb des Hauptrepositorys. Das Issue #48 fordert eine mehrsprachige Strategie; sein Autor, minsang-alt, bat ausdrücklich um eine koreanische Version. In den Kommentaren bot yiyou-eyo eine chinesische Übersetzung an und JuanCalderon-17 eine spanische Version. Es handelt sich um Community-Vorschläge, keine offiziell genehmigten Übersetzungen.

Verwandte Projekte und verifizierte Alternativen

Das README selbst vergleicht oder verlinkt benachbarte Methodiken und Sammlungen. Um keine unbewiesene Kompatibilität zuzuschreiben, fasst diese Tabelle nur die Position zusammen, die das README ihnen zuweist:

Projekt	Überprüfbare Beziehung zu diesem Leitfaden
obra/superpowers	Skill-basierte Methodik mit Brainstorming, Worktrees, Planung, testgetriebener Entwicklung, Review und Abschluss.
affaan-m/everything-claude-code	Bibliothek von Agenten, Befehlen und Skills mit Schritten für Planen, Testen, Implementieren, Überprüfen, Verifizieren, Erinnern und Verbessern.
github/spec-kit	Spezifikationsgeleiteter Workflow, von Konstitution und Spezifikation bis zu Implementierung, Analyse und Checklisten.
Fission-AI/OpenSpec	Workflow aus Erkunden, Vorschlagen, Anwenden, Verifizieren, Fortsetzen und Archivieren.
open-gsd/gsd-core	Fortsetzung, die in einem Pull Request des Leitfadens für das frühere Repository Get Shit Done vermerkt ist, das archiviert worden war.
openai/codex-plugin-cc	Offizielles OpenAI-Plugin, das das README für Codex-Reviews aus Claude Code heraus listet.

Nicht alle sind direkte Ersatzprodukte. Claude Code Best Practice ist in erster Linie ein Referenzleitfaden mit Beispielen; Superpowers, Spec Kit und OpenSpec sind Prozessvorschläge, während codex-plugin-cc eine Integration zwischen Werkzeugen ist.

Repo-Zahlen

Messung: 1. August 2026, GitHub-API.

Metrik	Wert
Sterne	63.854
Forks	6.360
Echte Abonnenten	471
Commits	1.671
Von der API gemeldete offene Issues	14
Hauptsprache	HTML
Lizenz	MIT
Erstellung	31. Oktober 2025
Letzter Push	1. August 2026
Neueste Veröffentlichung	Keine GitHub-Releases

Die wichtigsten von der API zurückgegebenen Mitwirkenden waren shanraisshan mit 847 Beiträgen, claude mit 818, claude[bot] mit 4 sowie shayangd und neutmute mit jeweils 1. Die Zahl von 1.671 Commits stammt von der letzten Seite, die im Paginierungslink der API angegeben ist. Das Feld watchers_count von GitHub spiegelt die Sterne; deshalb wird subscribers_count hier als Zahl der echten Abonnenten angegeben. Ebenso kann open_issues_count offene Pull Requests einschließen, sodass 14 nicht notwendigerweise 14 Issues ohne Pull Requests entspricht.

Wie die Community es aufnahm

Die direkt gefundenen Belege stammen vor allem von GitHub; es wurde keine eigene Hacker-News-Diskussion zu shanraisshan/claude-code-best-practice gefunden. Hacker-News-Suchen lieferten Threads über Anthropics offiziellen Leitfaden mit ähnlichem Namen, nicht über dieses Repository, und diese werden hier nicht als Rezeption dieses Projekts verwendet.

• Im Issue #48 bezeichnet minsang-alt die Ressource bei der Bitte um mehrsprachige Unterstützung als „großartige Ressource”. Der Thread hat 5 Kommentare. yiyou-eyo und JuanCalderon-17 boten jeweils chinesische und spanische Übersetzungen an; das ist ein konkretes Signal für Interesse an einer Erweiterung der Reichweite, bestätigt aber nicht, dass sie akzeptiert wurden.
• Der Pull Request #33 von frdzy zeigt eine Usability-Kritik: Das README sei so umfangreich, dass er nicht wusste, wo er anfangen sollte. Er schlug /_learn und einen personalisierten Rundgang-Skill vor; der Pull Request hat 2 Kommentare. Der Autor antwortete, er warte lieber ab, weil er das Repository nicht mit noch mehr Agenten, Befehlen und Skills aufblähen wolle und weil es bereits Hunderte von Repositories und Tausende von Skills gebe. Das ist ein echter Einwand dagegen, einen umfangreichen Leitfaden in eine weitere unbegrenzte Sammlung zu verwandeln.
• Der Pull Request #40 von quizD schlägt ein chinesisches README vor und hat 2 Kommentare. Der Maintainer fragte, womit übersetzt worden sei; danach bat DaiOwen um eine Verbesserung. Das ist ein konkreter Vorbehalt gegenüber der Qualität einer automatisierten oder unzureichend überprüften Übersetzung, keine Disqualifikation des Originalinhalts.
• Im Pull Request #46 schlug dotandlinejp einen japanischen Leitfaden für Design und Nicht-Programmierer vor. shayangd fragte, wie er erstellt worden sei und ob er qualitätsgeprüft wurde. Der Thread hat 1 Kommentar; er spiegelt die Notwendigkeit wider, abgeleitete Leitfäden vor der Integration zu validieren.

Die vernünftige Schlussfolgerung ist eine starke Verbreitung auf GitHub und aktive Lokalisierungsarbeit, aber es gibt keine gefundenen Belege für eine einheitliche externe Anerkennung. Sterne messen Interesse, nicht die Wirksamkeit der Ratschläge oder die Qualität jedes Ablegers.

Claude Code Best Practice im Vergleich zu anderen Vorschlägen

Vorschlag	Überprüfbare Überschneidung	Überprüfbarer Unterschied
obra/superpowers	Beide organisieren die Arbeit eines Agenten um Planung, Ausführung und Verifizierung.	Superpowers verpackt eine skill-basierte Methode; dieses Repository definiert sich als Referenz und Kurs und fügt Links und Claude-Code-Beispiele hinzu.
affaan-m/everything-claude-code	Beide decken Claude-Code-Agenten, -Befehle und -Skills ab.	Die Tabelle dieses Leitfadens präsentiert Everything Claude Code als umfangreiche Artefaktbibliothek; Claude Code Best Practice priorisiert Dokumentation, Berichte und erklärte Muster.
github/spec-kit	Beide verbinden Spezifikation, Planung und Implementierung.	Spec Kit ist als spezifikationsgeleiteter Workflow strukturiert; dieser Leitfaden erzwingt keine eigene Abfolge und erzeugt keine Konstitution.
Fission-AI/OpenSpec	Beide beinhalten Erkundung und Verifizierung als Phasen.	OpenSpec hat definierte Lebenszyklus-Befehle; dieses Repository katalogisiert native Mechanismen und Praktiken aus mehreren Quellen.
shanraisshan/codex-cli-best-practice	Sie teilen einen Autor und den Ansatz des Übergangs zur Agenten-Engineering.	Das zweite richtet sich an Codex CLI; das dokumentierte Repository konzentriert sich auf Claude Code und seine .claude/-Pfade.

Anwendungsfälle und wem dieses Repository helfen kann

Teams, die Claude Code standardisieren, können es als Entscheidungskarte nutzen, bevor sie einem Repository Automatisierung hinzufügen: prüfen, welche Primitiven Befehle, Subagenten, Skills, Hooks, MCP, Speicher und Berechtigungen abdecken, und dann ein wiederholtes Verfahren in .claude/commands/, .claude/agents/ oder .claude/skills/ überführen. Das Beispiel /weather-orchestrator erlaubt es, den Weg Befehl → Agent → Skill zu studieren, bevor man eine eigene Zusammensetzung entwirft; die Verweise auf Worktrees, Wiederherstellungspunkte und Reviews helfen, es in einen bestehenden Änderungszyklus einzupassen.

Technische Leiter, Trainer und Autoren interner Leitfäden können die Kuration nutzen, um einen Einführungspfad vorzubereiten: von den verlinkten offiziellen Quellen ausgehen, Methodiken wie Superpowers, Spec Kit oder OpenSpec vergleichen und lokale Entscheidungen dokumentieren, statt ein geschlossenes Rezept zu kopieren. Es ist auch nützlich, um ein wiederkehrendes Muster in einen versionierten Skill oder Befehl zu verwandeln, während man die Berechtigungslisten, Tests und menschliche Reviews beibehält, die das Repository selbst empfiehlt.

Ressourcen

• Repository: https://github.com/shanraisshan/claude-code-best-practice
• Dokumentation und Einstieg: https://github.com/shanraisshan/claude-code-best-practice#how-to-use
• Orchestrierungsbeispiel: https://github.com/shanraisshan/claude-code-best-practice/blob/main/orchestration-workflow/orchestration-workflow.md
• Offizielle Claude-Code-Quellen: https://code.claude.com/docs/en/features-overview
• Verlinkte offizielle Skills: https://github.com/anthropics/skills/tree/main/skills
• Schwester-Repositories: https://github.com/shanraisshan?tab=repositories
• Community-Diskussionen: https://github.com/shanraisshan/claude-code-best-practice/issues/48, https://github.com/shanraisshan/claude-code-best-practice/pull/33, https://github.com/shanraisshan/claude-code-best-practice/pull/40, https://github.com/shanraisshan/claude-code-best-practice/pull/46
• Community und vom README vorgeschlagene Kanäle: https://www.reddit.com/r/ClaudeCode/, https://www.youtube.com/@anthropic-ai, https://chat.whatsapp.com/BDUV2stIS0c7X5uY7RY6nS

---

Hinweis: Dieser Artikel kombiniert das README und die Commit-Historie von shanraisshan/claude-code-best-practice, die GitHub-API, Pull Requests und Issues des Repositorys sowie Hacker-News-Recherchen vom 1. August 2026. Die Zahlen ändern sich mit der Zeit.