Claude Code Agents lesen Projekt-Dokumentation nicht automatisch

Wie Claude-Code-Agenten mit Projektdokumentation umgehen

Bei der Arbeit mit dem Agentensystem von Claude Code sollten Entwickler eine spezifische Einschränkung beachten, wie Subagenten auf Projektdokumentation zugreifen. Laut einem Benutzerbericht von r/ClaudeAI arbeiten Agenten, die von Claude Code für Codierungsaufgaben eingesetzt werden, mit eingeschränktem Kontext.

Wichtige Details aus der Quelle

Das Problem wurde während einer Debugging-Sitzung entdeckt, in der ein Agent wiederholt auf dokumentierte Fallstricke stieß. Auf die Frage, warum er die dokumentierten Warnungen ignorierte, antwortete der Agent: "Ich habe CLAUDE.md nicht gelesen, bevor ich den Callback geschrieben habe. Ich hatte die Codebase-Muster aus der Explorationsphase in meinem Prompt-Kontext, aber als ich den Sonnet-Agenten beauftragte, die OAuth-Routen zu schreiben, beschrieb der Agenten-Prompt, was zu bauen ist, nicht welche Fallstricke zu prüfen sind."

Der Agent präzisierte weiter: "Die Sonnet-Subagenten sehen nur das, was ich in ihren Prompt einfüge. Sie lesen nicht automatisch CLAUDE.md, MEMORY.md oder irgendeinen Projektkontext, es sei denn, ich weise sie ausdrücklich dazu an."

Praktische Auswirkungen

• Subagenten wie Sonnet arbeiten nur mit dem Kontext, der in ihrem spezifischen Prompt bereitgestellt wird
• Projektdokumentationsdateien (CLAUDE.md, MEMORY.md) werden nicht automatisch geladen
• Agenten schreiben Code von Grund auf neu, ohne bestehende Fallstricke-Listen zu konsultieren, es sei denn, sie werden ausdrücklich dazu angewiesen
• Dies kann dazu führen, dass Agenten dokumentierte Probleme wiederholen, die hätten vermieden werden können

Dieses Verhalten bedeutet, dass Entwickler explizit darauf achten müssen, Dokumentationsreferenzen einzubeziehen, wenn sie Agenten für spezifische Codierungsaufgaben einsetzen. Die Agenten behalten die Codebase-Muster aus der Explorationsphase bei, verweisen aber nicht automatisch auf projektspezifische Dokumentationsdateien.