VIBE CODING█
GUIDE3 min read

Claude als KI-Agent: Eine innovative Projektstruktur für intelligente Workflows

Verwandeln Sie Claude von einem Chatbot in einen voll funktionsfähigen KI-Agenten. Entdecken Sie eine modulare Projektstruktur für Commands, Rules und Skills.

KI-AgentClaudeProjektstrukturEntwicklungAutomatisierungWorkflow

Die Transformation von Claude von einem reinen Chatbot zu einem vollwertigen, proaktiven Agenten ist möglich, wenn man das Projekt richtig strukturiert. Der Schlüssel liegt in einer durchdachten Ordnerstruktur, die es ermöglicht, modulare Anweisungen, benutzerdefinierte Befehle und autonome Fähigkeiten zu definieren. Im Grunde bauen Sie ein Mini-Agenten-System direkt in Ihrem Repository auf.

Die Magie der Ordnerstruktur

Die folgende Struktur zeigt, wie Sie Ihr Projekt organisieren können, um Claude als intelligenten Agenten zu nutzen:

your-project/
├── CLAUDE.md              → Anweisungen für das Team (im Repository gespeichert)
├── CLAUDE.local.md        → Persönliche Einstellungen (von Git ignoriert)

├── .claude/               → Das Kontrollzentrum des Agenten
│   ├── settings.json          → Zugriffsrechte und Konfiguration (im Repository)
│   ├── settings.local.json    → Lokale Einstellungen (von Git ignoriert)

│   ├── commands/              → Benutzerdefinierte Slash-Befehle
│   │   ├── review.md          → /project:review
│   │   ├── fix-issue.md       → /project:fix-issue
│   │   └── deploy.md          → /project:deploy

│   ├── rules/                 → Modulare Anweisungen und Richtlinien
│   │   ├── code-style.md
│   │   ├── testing.md
│   │   └── api-conventions.md

│   ├── skills/                → Automatisch ausführbare Workflows
│   │   ├── security-review/
│   │   │   └── SKILL.md
│   │   └── deploy/
│   │       └── SKILL.md

│   └── agents/                → Sub-Agenten (Rollen)
│       ├── code-reviewer.md
│       └── security-auditor.md

Erläuterung der Strukturkomponenten

  • CLAUDE.md / CLAUDE.local.md: Diese Dateien dienen als Hauptanweisungen. CLAUDE.md enthält allgemeine Projektrichtlinien und Teamanweisungen, während CLAUDE.local.md für individuelle, lokale Anpassungen vorgesehen ist, die nicht versioniert werden sollen.

  • .claude/: Dies ist das Herzstück der Agentenkonfiguration. Es beherbergt alle Dateien, die Claude in seiner Funktion als Agent steuern.

    • settings.json / settings.local.json: Hier werden globale Einstellungen, Zugriffsrechte und Konfigurationen für den Agenten gespeichert. Die lokale Version ist wiederum für persönliche Einstellungen gedacht.

    • commands/: Dieser Ordner enthält Definitionen für benutzerdefinierte Slash-Befehle. Diese ermöglichen es dem Agenten, spezifische Aktionen auf Anforderung auszuführen, wie z.B. /project:review für eine Codeüberprüfung oder /project:deploy für die Bereitstellung.

    • rules/: Hier sind modulare Anweisungen und Richtlinien hinterlegt. Dies können beispielsweise Code-Style-Guides, Testrichtlinien oder API-Konventionen sein, die der Agent bei der Bearbeitung von Aufgaben berücksichtigen soll.

    • skills/: Dieser Bereich definiert autonome, automatisch ausführbare Workflows oder Fähigkeiten. Ein security-review Skill könnte beispielsweise bei jeder Codeänderung eine Sicherheitsprüfung initiieren, während ein deploy Skill den gesamten Bereitstellungsprozess abwickelt.

    • agents/: Hier können Sie Sub-Agenten oder spezifische Rollen definieren. Ein code-reviewer.md könnte Anweisungen für einen Agenten enthalten, der sich ausschließlich auf Code-Reviews spezialisiert, während ein security-auditor.md die Rolle eines Sicherheitsprüfers übernimmt.

Fazit

Durch diese strukturierte Herangehensweise können Sie Claude von einem einfachen interaktiven Modell zu einem leistungsstarken, kontextbewussten und aufgabenorientierten Agenten erweitern. Sie schaffen ein System, das in der Lage ist, komplexe Workflows zu verstehen, zu verarbeiten und sogar autonom auszuführen, indem es auf vordefinierte Regeln, Befehle und Fähigkeiten zurückgreift. Dies ermöglicht eine tiefere Integration von KI in Ihre Entwicklungsprozesse und eröffnet neue Möglichkeiten für Automatisierung und intelligente Unterstützung.