Claude Code in 1 Tag: CLAUDE.md aus MDC Regeln anreichern: Erfahrungsbericht Teil 3

Geschrieben von Fachexperten: Timon Fiddike, CST®, Machine Learning seit 2005

Dieser Artikel ist Teil 3 einer Serie über den Start mit Claude Code, hier sind Teil 1 und Teil 2.

Agenten lassen sich deutlich aufwerten, indem man sie geschickt steuert. Im Kontext von AI-Coding mit Cursor haben sich dafür die sogenannten MDC Regeln (Multi Document Context) besonders bewährt, siehe auch “Schritt 6: Regeln für den Agenten”.

Die MDC Regeln kamen auch in Teil 2 dieses Artikels vor, dort allerdings mit Fokus auf automatische Überprüfung und Selbstkorrektur für den Agenten.

Zusätzlich kann man per MDC dem Agenten auch Orientierung geben, wie er grundsätzlich Code erstellen solle, welche Architektur zu beachten ist usw. Hier beschreibe ich, wie man solche Regeln selbst mit Hilfe von Agenten erstellen kann. Ich überprüfe darin auch die Wirksamkeit von Architekturregeln an einer 9 Jahre alten Codebase, die nachträglich umgebaut wurde. Nun sollte der Umbau weiter geführt werden und dabei die Best Practices zum Framework beachtet werden. Die Best Practice MDC Regeln bzgl. des Frameworks haben sich dafür tatsächlich als hilfreich erwiesen.

Claude Code hat ja in Teil 1 schon automatisch eine erste CLAUDE.md Datei erstellt. Zunächst habe ich mich gefreut, dass darin meine MDC Regeln berücksichtigt wurden. Ich war enttäuscht, als ich, bei genauerem Hinsehen, bemerkt hatte, dass dabei wichtige Regeln weggelassen wurden. Nun möchte ich systematisch prüfen und ggf. ergänzen.

Systematisches Vorgehen beschreiben

Ich prompte zunächst Claude Desktop, um das Vorgehen für Claude Code systematisch zu beschreiben:

"I want to extend the initially generated CLAUDE.md with more specific instructions that currently exist in the form of .mdc files in .cursor/rules, where some are not applicable (MDC file management) and others are applicable (e.g., conventions for shell scripts in this project). Suggest a prompt or a series of prompts that I could use for Claude Code to achieve this."

Claude Desktop stellt mir interaktiv eine Reihe von Fragen, hier als Beispiel die letzte Frage:

Als Zwischenergebnis erhalte ich die drei Prompts (weiter unten gezeigt) und diese Erklärung:

Die Erklärung deckt sich mit meinen vorherigen Erfahrungen, speziell mit Claude Modellen: Es lohnt sich sehr, zunächst interaktiv hohe Klarheit über Ergebnis und Weg zu schaffen. Die Zeit ist an dieser Stelle gut investiert, weil man hier viel leichter nachsteuern kann.

Im Folgenden zeige ich die Prompts und die Ergebnisse.

Schritt 1 - Unklarheiten finden

Hier das von Claude Desktop generierte Prompt 1/3 im englischen Original:

“Prompt 1 — Discovery & triage Run this first, as a single prompt. Claude Code will read all the MDC files and propose a triage before touching anything.”

Read every file in .cursor/rules/ and the current CLAUDE.md.

For each MDC file, output a triage table with these columns:
- Filename
- One-line summary of what it governs
- Recommendation: one of INTEGRATE | TRANSLATE | SKIP | ASK
  - INTEGRATE = project conventions that apply directly to Claude Code
  - TRANSLATE = Cursor-specific but has a Claude Code equivalent
  - SKIP = Cursor UI/MDC meta with no Claude Code equivalent
  - ASK = you're not sure

For TRANSLATE entries, briefly note what the Claude Code equivalent would be.
For ASK entries, write a one-sentence question for me to answer.

Do not edit any files yet. Wait for my confirmation.

In Claude Code liefert dies folgendes Ergebnis:

Schritt 2 - Fragen klären

Hier das von Claude Desktop generierte Prompt 2/3 im englischen Original:

“Prompt 2 — Handle the ASK items (per-file, iteratively) After Claude replies, you’ll see the table. For each ASK row, Claude should have posted a question. Answer them inline or just reply to each one. Then send:”

OK, here are my answers to your questions:
[your answers]
Now re-output the finalised triage table with all rows resolved to INTEGRATE, TRANSLATE, or SKIP. Still don't edit any files yet.

Bei [your answers] füge ich ein: “SKIP symfony-6.4-best-practices.mdc”, denn diese Regeln habe ich vor langer Zeit erstellt und in der Zwischenzeit sind die Modelle deutlich besser geworden. Diese Datei war damals hilfreich, es könnte aber sein, dass diese nun tatsächlich nicht mehr nötig ist. Ich entscheide, sie für den Augenblick erst einmal weg zu lassen. Besonders wichtig ist mir in diesem Schritt, die Lernerfahrung aus vorherigen Fehlern der Agenten mitzunehmen.

In Claude Code erhalte ich folgendes Ergebnis:

Schritt 3 - Ausführen

Hier das von Claude Desktop generierte Prompt 3/3 im englischen Original:

“Prompt 3 — Execute Once you’re happy with the triage: Go ahead and update CLAUDE.md based on the finalised triage:”

- For INTEGRATE and TRANSLATE entries: if CLAUDE.md already has a section covering that topic, extend it with the new information. Otherwise append a new section at the bottom.
- For TRANSLATE entries: rewrite the rule in Claude Code terms (e.g. Cursor's "auto-attached on file match" becomes a note on when the convention applies).
- For SKIP entries: do nothing.
- Preserve all existing CLAUDE.md content — only add or extend, never remove.
- After editing, print a summary of every change made (section extended vs. section added) so I can verify.

Da in meinem triage table kein TRANSLATE vorkam, entferne ich die Zeile und Hinweise, bevor ich den Prozess starte:

Ergebnisse im Detail

In der initialen CLAUDE.md Datei war zwar vieles schon berücksichtigt, aber mit Blick auf die Ergänzungen wird schnell klar, dass hier relevante Lücken geschlossen werden. Im Einzelnen:

Tatsächlich ist wichtig, dass die Docker Container per Skript gestartet werden, denn dadurch wird eine spezielle Konfigurationsdatei berücksichtigt, um Portkollisionen zwischen verschiedenen Sätzen von Containern zu vermeiden:

Die Verwendung von DB Migrationen ist in der Tat erforderlich, und die genaue Anweisung zum Workflow ist mir besonders wichtig:

Gut, dass die Registrierung von React Komponenten hier aufgenommen wurde, denn damit hatte der Agent in der Vergangenheit schon Schwierigkeiten und seit die MDC Regel besteht, hat dies problemlos funktioniert.

Auch die sorgfältige Fehlerbehandlung in Shell Skripten hat sich schon als hilfreich erwiesen:

Die Zusammenfassung ist hilfreich. Ich verstehe, dass manche Entwickler mittlerweile dazu neigen, nur noch die Zusammenfassung zu lesen.

Zusammenfassung und Ausblick

Beim Start mit Claude Code (siehe Teil 1) wurde eine CLAUDE.md Datei erstellt. Zunächst habe ich mich gefreut, dass darin meine MDC Regeln berücksichtigt wurden. Ich war enttäuscht, als ich bemerkt hatte, dass dabei wichtige Regeln weggelassen wurden.

In diesem Artikel habe ich eine Systematik zum Prüfen und Ergänzen gezeigt: Dabei habe ich nicht einfach geprompted, dass ergänzt werden soll. Stattdessen habe ich Anweisungen erstellt, damit der Agent Schritt für Schritt vorgeht: 1. Unklarheiten finden, 2. Fragen klären, 3. Ausführen. Die Klärung offener Punkte und Prüfung von Zwischenergebnissen geht dabei leichter, wenn sie früh im Prozess stattfindet.

Hier findest Du Teil 4 der Serie:

Claude Code in 1 Tag: Browser Integration mit Stolperstein: Erfahrungsbericht Teil 4

AI-Coding Hands-on Workshop

Du bist von Anfang an selbst an der Tastatur. Am Ende unseres AI-Coding Deep Dive Workshops hast Du einen prall gefüllten Werkzeugkoffer. Du arbeitest souverän mit aktuellen Werkzeugen und lieferst in kurzer Zeit Ergebnisse in unerwartet hoher Qualität.

Zum AI-Coding Deep Dive

Reflexion, Einladung und Angebot

• Hast Du als Entwickler konkrete Ideen für Deinen eigenen Weg bekommen?
• Hast Du als Führungskraft einen Eindruck gewonnen, welche Schritte Deine Mitarbeiter gehen könnten? Denkst Du darüber nach, ihnen andere Impulse und Unterstützung anzubieten als bisher?
• Hast Du einen ersten Eindruck von mir?

Nimm Kontakt mit mir auf, wenn Du Dich für einen Impulsvortrag oder Workshop interessierst! Lass uns gemeinsam überlegen, welche Art von Unterstützung für Euch hilfreich sein kann:

Unten auf der Seite über meinen Hands-on Workshop „AI-Coding Deep Dive" kannst Du Dir direkt per Calendly einen Termin für ein Gespräch aussuchen (unverbindlich und kostenlos).

Über den Autor

Dr. Timon Fiddike

• Seit 2010 auf dem Pfad der Agilität
• Seit 2005 KI, AI, Machine Learning, siehe Werdegang
• Erfahrung als Entwickler im Team, Product Owner, Scrum Master, Geschäftsführer und Coach
• Höchste Zertifizierung: Certified Scrum Trainer® (weltweit ca. 220 Personen) für die Scrum Alliance®
• Erfahrung in Startup, Mittelstand & Konzern
• Integraler Coach – Ausbildung nach ICF ACTH-Standard
• Unterstützt mit Begeisterung das menschliche Wachstum, das agile Arbeit ermöglicht
• Geschäftsführer Agile.Coach GmbH & Co. KG

Zu Timons Profil