Was macht build-with-claude-code?
Wie Fivetran SEs ODI-Demos mit Claude Code erstellen – interaktiver Prompt-Builder + Vorlagen + CLAUDE.md Skill
Übersicht
Dieses Repository enthält die notwendigen Komponenten, um Fivetran ODI (Orchestrated Data Integration)-Demos effizient mit Claude Code zu erstellen. Es bietet:
- Interaktiven Prompt-Builder: Ein Hilfsmittel, um maßgeschneiderte Prompts für Claude Code zu generieren, basierend auf dem gewünschten Demo-Szenario.
- Vorlagen (Scaffolds): Vorgefertigte Code-Grundstrukturen für typische ODI-Demos, z. B. API-Integrationen, Datenpipelines oder Dashboard-Erstellung.
- CLAUDE.md Skill: Eine optimierte Konfigurationsdatei, die Claude Code projektbezogen anleitet.
Installation
- Klone das Repository:
git clone https://github.com/fivetran-jasonchletsos/build-with-claude-code.git
cd build-with-claude-code
- Lege eine
CLAUDE.md-Datei im Stammverzeichnis deines Projekts an (oder ergänze die bestehende) mit folgendem Inhalt:
# Claude Code Anweisungen für Fivetran ODI-Demos
## Projektkontext
- Dieses Projekt erstellt Demos für Fivetran Orchestrated Data Integration (ODI).
- Zielgruppe: Solution Engineers und Solution Architects.
- Die Demos werden live vorgeführt und müssen zuverlässig und reproduzierbar sein.
## Codierungsstil
- Verwende Python 3.10+ und TypeScript für Frontends.
- Nutze Fivetran REST API v2 für Verbindungen.
- Verwende `dotenv` für Umgebungsvariablen.
- Dokumentiere jede Funktion mit Docstrings.
## Häufige Fehler vermeiden
- Keine hartcodierten API-Keys – immer Umgebungsvariablen verwenden.
- Keine Annahmen über Datenbank-Schemata – immer explicit abfragen.
- Bei Fehlern immer aussagekräftige Log-Meldungen ausgeben.
## Testen
- Führe Tests mit `pytest` aus.
- Stelle sicher, dass alle Tests in einer isolierten Umgebung laufen.
Verwendung
Prompt-Builder starten
Führe den interaktiven Builder aus:
python prompt_builder.py
Er wird dich durch eine Reihe von Fragen führen (z. B. welche API, welche Datenquelle, welche Ziel-Destination). Am Ende erhältst du einen maßgeschneiderten Prompt, den du direkt in Claude Code einfügen kannst.
Vorlagen verwenden
Navigiere zum Ordner scaffolds/ und wähle eine passende Vorlage:
scaffolds/
├── api_connector/
├── data_pipeline/
└── dashboard/
Kopiere die Vorlage in dein Projektverzeichnis und passe sie an.
CLAUDE.md aktivieren
Deine CLAUDE.md-Datei sollte wie oben beschrieben aussehen. Claude Code erkennt die Datei automatisch und beachtet die darin definierten Regeln bei der Code-Generierung.
Vorteile
- Zeitersparnis: Kein manuelles Schreiben von Grund auf.
- Konsistenz: Einheitlicher Code-Stil und Best Practices über alle Demos hinweg.
- Reproduzierbarkeit: Jede Demo folgt den gleichen Konventionen.
Unterstützte Plattformen
- Claude Code (CLI)
- Claude Code in VS Code (Cursor)
Beitragen
Pull Requests sind willkommen! Stelle sicher, dass neue Vorlagen die bestehenden Konventionen einhalten.