Unbekannte Codebasis verstehen: Architekturkarte und Onboarding-Leitfaden

Aus Verzeichnisbaum und Schlüsseldateien eines Repos eine klare Karte machen: Architektur, Ablauf eines Requests, Glossar, Risikozonen und der beste Einstieg für deine konkrete Aufgabe. Entwickelt für ChatGPT, Claude, Gemini und Microsoft Copilot. Er enthält 4 anpassbare Variablen und lässt sich kostenlos mit einem Klick kopieren.

Fortgeschritten · Text · Redaktionelle Prüfung ausstehend

Prompt

Du bist Senior-Engineer und hilfst einer neuen Person, ein ihr unbekanntes Repository zu verstehen.

Kontext:
- Projekt und Stack: {{projekt}}
- Verzeichnisbaum und Schlüsseldateien (README, Konfiguration, Einstiegspunkt, Routen, Modelle): {{dateien}}
- Meine konkrete Aufgabe in diesem Code: {{aufgabe}}
- Meine Erfahrung mit diesem Stack: {{erfahrung}}

Liefere:
1. Zusammenfassung in 5 Zeilen: Was macht das System, für wen, und was sind die Hauptbausteine?
2. Architekturkarte: Schichten oder Module, Verantwortung jedes wichtigen Ordners und wie sie kommunizieren, inklusive Mermaid-Diagramm.
3. Durchlauf eines typischen Requests oder Ablaufs von Anfang bis Ende, mit echten Dateien und Funktionen aus meinem Material.
4. Glossar der Fach- und Projektbegriffe, die im Code vorkommen.
5. Für meine Aufgabe: welche Dateien ich vermutlich ändern muss, in welcher Reihenfolge ich sie lese und welche Tests ich ausführe.
6. Risikozonen: starke Kopplung, Framework-Magie, umgebungsabhängige Konfiguration, versteckte Seiteneffekte.
7. Zehn konkrete Fragen an das Team.

Einschränkungen:
- Stütze dich nur auf mein Material. Leitest du etwas ab, ohne es zu sehen, markiere es mit [PRÜFEN]; fehlt eine Schlüsseldatei, sag mir welche und warum.
- Erfinde keine Dateinamen, Funktionen oder Befehle.
- Passe die Detailtiefe an meine Erfahrung an: {{erfahrung}}.
- Reichen die Informationen nicht, frag zuerst nach den fehlenden Dateien.

Format: nummerierte Abschnitte, Mermaid-Diagramm und kurze Listen.

So verwenden Sie ihn

Erzeuge den Baum mit tree -L 3 -I node_modules oder git ls-files und füge zusätzlich README, Hauptkonfiguration und Einstiegspunkt ein. Bei viel Kontext teilst du das Repo in mehreren Nachrichten und forderst die Karte am Ende an.

Anwendungsbeispiel

Projekt: Buchungs-API mit NestJS und PostgreSQL · Aufgabe: Teilerstattungen im Zahlungsmodul ergänzen · Erfahrung: Node.js ja, NestJS nein.

Beispielergebnis

Angenommen, der eingefügte Verzeichnisbaum folgt der Standardstruktur von Symfony 6…

1. Zusammenfassung

B2C-Onlineshop: Katalog, Warenkorb, Checkout und Bestellungen. Controller in src/Controller, Logik in src/Service, Persistenz über Doctrine auf MySQL und Twig-Views.

2. Architekturkarte

flowchart LR
  R[config/routes] --> C[src/Controller]
  C --> S[src/Service]
  S --> E[src/Entity + Repository]
  E --> DB[(MySQL)]
  C --> T[templates/ Twig]

5. Für Ihre Aufgabe: Versand nach Gewicht

Empfohlene Lesereihenfolge:

  1. src/Entity/ShippingMethod.php [PRÜFEN] — wie die bestehenden Versandarten modelliert sind.
  2. Der Service, der die Versandkosten berechnet, vermutlich unter src/Service/Shipping/ [PRÜFEN].
  3. src/Entity/Product.php — gibt es schon ein Gewichtsfeld? Falls nicht, braucht es eine Doctrine-Migration.
  4. Das Checkout-Template in templates/checkout/ [PRÜFEN].

Auszuführende Tests: mindestens php bin/phpunit tests/Service.

6. Risikobereiche

  • Doctrine- oder Kernel-Event-Listener, die die Bestellung verändern, ohne im Controller aufzutauchen.
  • Umgebungsspezifische Konfiguration in config/packages/{dev,prod}.

7. Fragen an das Team

  1. Wird das Gewicht in Gramm oder Kilogramm gespeichert?
  2. Ändern sich die Gewichtstarife je nach Zielland?…

Wichtige Fakten

Kategorie
Programmierung & Entwicklung · Dokumentation
Ausgabetyp
Text
Niveau
Fortgeschritten
Entwickelt für
ChatGPT, Claude, Gemini und Microsoft Copilot
Verifiziert in
Redaktionelle Prüfung ausstehend
Variablen
Projekt und Stack, Baum und Schlüsseldateien, Meine Aufgabe und Erfahrung mit dem Stack
Sprache
Deutsch
Preis
Kostenlos, ohne Anmeldung
Aktualisiert
07.11.2026

Häufig gestellte Fragen

Wie viel Code muss ich einfügen?

Beginne mit Verzeichnisbaum, README, Konfiguration und Einstiegspunkt. Dann kann das Modell gezielt nach den Dateien fragen, die es braucht, statt das ganze Repository zu verarbeiten.

Kann ich dem Diagramm vertrauen?

Es ist ein Ausgangspunkt. Gleiche alles, was mit [PRÜFEN] markiert ist, mit dem Code oder dem Team ab, bevor du Designentscheidungen triffst.

Wofür ist dieser Prompt gedacht?

Aus Verzeichnisbaum und Schlüsseldateien eines Repos eine klare Karte machen: Architektur, Ablauf eines Requests, Glossar, Risikozonen und der beste Einstieg für deine konkrete Aufgabe.

Mit welchen KI-Tools funktioniert er?

Er ist für ChatGPT, Claude, Gemini und Microsoft Copilot entwickelt. Wir haben ihn in diesen Tools noch nicht überprüft, daher können die Ergebnisse variieren.

Wie passe ich den Prompt an?

Klicken Sie auf „Anpassen“ und füllen Sie die Variablen aus (Projekt und Stack, Baum und Schlüsseldateien, Meine Aufgabe und Erfahrung mit dem Stack). Der Text wird sofort aktualisiert und lässt sich anschließend mit einem Klick kopieren. Die Werte werden nur in Ihrem Browser gespeichert.

Brauche ich Erfahrung, um ihn zu verwenden?

Er ist für Fortgeschrittene: Es hilft, das Thema zu kennen, um guten Kontext zu liefern und das Ergebnis kritisch zu prüfen.

Ist dieser Prompt kostenlos?

Ja. Jeder Prompt von HomeCasa Prompts ist kostenlos, ohne Anmeldung und ohne Abonnement. Sie können ihn auch in beruflichen Projekten verwenden.

Kann ich der KI-Ausgabe vertrauen?

Betrachten Sie sie als hochwertigen Entwurf: Prüfen Sie Daten, Zahlen und wichtige Aussagen immer, bevor Sie etwas veröffentlichen oder Entscheidungen treffen.

Ähnliche Prompts