{"id":987523634,"date":"2026-04-17T14:50:47","date_gmt":"2026-04-17T12:50:47","guid":{"rendered":"https:\/\/www.obviousworks.ch\/?p=987523634"},"modified":"2026-04-17T14:52:40","modified_gmt":"2026-04-17T12:52:40","slug":"designing-claude-md-right-the-2026-architecture-that-finally-makes-claude-code-work","status":"publish","type":"post","link":"https:\/\/www.obviousworks.ch\/en\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\/","title":{"rendered":"Designing CLAUDE.md correctly: The 2026 architecture that finally makes Claude code work"},"content":{"rendered":"\n[et_pb_section fb_built=&#187;1&#8243; _builder_version=&#187;4.27.6&#8243; _module_preset=&#187;default&#187; custom_padding=&#187;0px|||||&#187; global_colors_info=&#187;{}&#187;][et_pb_row _builder_version=&#187;4.27.6&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187;][et_pb_column type=&#187;4_4&#8243; _builder_version=&#187;4.27.6&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187;][et_pb_text _builder_version=&#187;4.27.6&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187;]<h2>Warum f\u00fchlt sich Claude Code bei den meisten Entwicklern nutzlos an?<\/h2>\n<p><strong>Weil die meisten nur 1 von 4 Layern konfigurieren.<\/strong> Sie laufen <code>\/init<\/code>, bekommen eine generische CLAUDE.md und wundern sich, warum Claude Datei-Strukturen halluziniert, falsche Libraries empfiehlt und den Coding-Stil verfehlt.<\/p>\n<p>Die Wahrheit: CLAUDE.md ist nur die erste von vier S\u00e4ulen. Das vollst\u00e4ndige Setup 2026 umfasst <strong>5 Scopes, das WHAT\/WHY\/HOW Framework, 7 Kern-Regeln und Advanced Patterns mit Hooks, Skills und Multi-Session-Workflows<\/strong>. Wer das orchestriert, arbeitet mit einem AI-Teammate, der mit der Zeit besser wird. Wer es ignoriert, prompted sich im Kreis.<\/p>\n<p>Dieser Guide spiegelt exakt den Architecture Guide 2026, den ich als Cheat Sheet f\u00fcr Entwickler-Teams zusammengestellt habe. Konkret. Umsetzbar. In einem Nachmittag. Aber wirklich in kurzer Zeit!<!-- Schema erzeugt, diesen Block entfernen        --><!-- ============================================ --><\/p>\n<p>\n<script type=\"application\/ld+json\">\n{\n  \"@context\": \"https:\/\/schema.org\",\n  \"@type\": \"FAQPage\",\n  \"mainEntity\": [\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Brauche ich CLAUDE.md in jedem Projekt?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Ja, wenn du Claude Code ernsthaft nutzt. Die 2026 Community-Meinung ist eindeutig: CLAUDE.md ist so wichtig wie .gitignore. Essential Infrastructure, nicht optionale Doku.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Was ist der Unterschied zwischen CLAUDE.md und einer README?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Die README ist f\u00fcr Menschen, die das Projekt starten wollen. CLAUDE.md ist Onboarding-Doku f\u00fcr deinen AI-Teammate. Unterschiedliche Audience, unterschiedliche Struktur, unterschiedliche L\u00e4nge.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Sollte CLAUDE.md in Git committed werden?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Ja \u2013 die projektspezifische .\/CLAUDE.md geh\u00f6rt in Git f\u00fcr Team-Konsistenz. Pers\u00f6nliche Notizen und Secrets geh\u00f6ren in .\/CLAUDE.local.md, die in .gitignore steht.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Wie oft sollte ich CLAUDE.md updaten?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Mindestens monatlich, idealerweise sofort nach jedem wiederkehrenden Fehler. Boris Chernys Faustregel: Jedes Mal, wenn Claude etwas falsch macht, wird eine Regel hinzugef\u00fcgt, damit es nicht wiederholt passiert. Das ist Compound Engineering.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Wie viele Tokens verbraucht eine CLAUDE.md?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Boris Chernys CLAUDE.md bei Anthropic hat rund 2500 Tokens, etwa 100 Zeilen. Mehr als 5000 Tokens ist fast immer zu viel \u2013 dann verdr\u00e4ngt die Datei den eigentlichen Arbeitskontext.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Was sind die 5 Scopes von CLAUDE.md?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Die 4 Haupt-Scopes 2026 sind: Global (~\/.claude\/CLAUDE.md) f\u00fcr pers\u00f6nliche Defaults, Project (.\/CLAUDE.md) f\u00fcr projektspezifische Regeln, Local Secret (.\/CLAUDE.local.md) f\u00fcr Notizen und Secrets, und Folder (.\/src\/CLAUDE.md) f\u00fcr Modul-Overrides. Last scope wins on conflicts.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Wie viele Zeilen sollte eine CLAUDE.md haben?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Unter 200 Zeilen, maximal 150 Instructions. Das ist Anthropic's offizielle Empfehlung und Community-Konsens 2026. L\u00e4ngere Dateien f\u00fchren dazu, dass Claude die eigentlichen Instruktionen ignoriert.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Was ist der Unterschied zwischen CLAUDE.md und AGENTS.md?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"CLAUDE.md ist f\u00fcr Single-Agent-Workflows in Claude Code. AGENTS.md ist der neue 2026 Standard f\u00fcr Multi-Agent-Workflows und Interoperabilit\u00e4t zwischen Claude, Cursor, Cline und anderen AI-Coding-Tools.\"\n      }\n    }\n  ]\n}\n<\/script>\n<\/p>[\/et_pb_text][dsm_card title=&#187;Claude Code Architektur Cheat Sheet&#187; subtitle=&#187;Jetzt kostenlos runterladen &#8211; lesen, verteilen und innerhalb kurzer Zeit agentisch Software entwickeln &#8211; Viel Spa\u00df&#187; image=&#187;https:\/\/www.obviousworks.ch\/wp-content\/uploads\/2026\/04\/ClaudeCodeCheatSheet2026.jpg&#187; badge_text=&#187;Claude Code Cheat Sheet 2026&#8243; badge_url=&#187;https:\/\/www.obviousworks.ch\/download\/CLAUDE.md_Architecture_Guide_2026_ObviousWorks.pdf&#187; button_text=&#187;Hier klicken &#038; kostenlos downloaden&#187; button_url=&#187;https:\/\/www.obviousworks.ch\/download\/CLAUDE.md_Architecture_Guide_2026_ObviousWorks.pdf&#187; button_url_new_window=&#187;on&#187; _builder_version=&#187;4.27.6&#8243; _module_preset=&#187;default&#187; background_color=&#187;#0a0001&#8243; custom_button=&#187;on&#187; button_text_size=&#187;21px&#187; button_text_color=&#187;#F67E28&#8243; button_alignment=&#187;center&#187; background_layout=&#187;dark&#187; link_option_url=&#187;https:\/\/www.obviousworks.ch\/download\/CLAUDE.md_Architecture_Guide_2026_ObviousWorks.pdf&#187; global_colors_info=&#187;{}&#187;][\/dsm_card][et_pb_text _builder_version=&#187;4.27.6&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187;]<h2>Was ist CLAUDE.md eigentlich \u2013 und warum ist es keine README?<\/h2>\n<p>CLAUDE.md ist das persistente Ged\u00e4chtnis deines AI-Teammates. Sie wird bei jedem <code>claude<\/code>-Start geladen und definiert, wie Claude dein Projekt versteht. Eine README dokumentiert f\u00fcr Menschen. CLAUDE.md onboarded deinen AI-Kollegen.<\/p>\n<p>Der Unterschied ist fundamental, und Boris Cherny, Creator von Claude Code und Staff Engineer bei Anthropic, bringt es auf den Punkt:<\/p>\n<blockquote>\n<p>&#171;CLAUDE.md is not a README for humans. It&#8217;s onboarding docs for your AI teammate \u2013 and every correction you add is a bug that never happens again.&#187;<\/p>\n<p><cite>\u2013 Boris Cherny, Creator of Claude Code \u00b7 Staff Engineer @ Anthropic<\/cite><\/p>\n<\/blockquote>\n<p>Die Konsequenz: Jede Zeile muss sich ihren Platz verdienen. Boris&#8216; eigene CLAUDE.md hat laut InfoQ-Interview im Januar 2026 gerade mal <strong>2&#8217;500 Tokens (rund 100 Zeilen)<\/strong> \u2013 und sein Team shipt damit Claude Code selbst (Quelle: <a href=\"https:\/\/www.infoq.com\/news\/2026\/01\/claude-code-creator-workflow\/\" target=\"_blank\" rel=\"noopener\">InfoQ, Januar 2026<\/a>).<\/p>\n<h2>Was sind die 5 Scopes von CLAUDE.md?<\/h2>\n<p>Claude Code l\u00e4dt CLAUDE.md-Dateien aus <strong>mehreren Pfaden mit klarer Kaskade<\/strong>. Die Regel: <em>Last scope wins on conflicts.<\/em> Der spezifischste Scope setzt sich durch.<\/p>\n<figure>\n<table>\n<thead>\n<tr>\n<th>Scope<\/th>\n<th>Pfad<\/th>\n<th>Zweck<\/th>\n<th>Team-geteilt?<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Global<\/strong><\/td>\n<td><code>~\/.claude\/CLAUDE.md<\/code><\/td>\n<td>Pers\u00f6nliche Defaults \u00fcber alle Projekte \u2013 Coding-Style, universelle Regeln. Immer geladen.<\/td>\n<td>Nein<\/td>\n<\/tr>\n<tr>\n<td><strong>Project<\/strong><\/td>\n<td><code>.\/CLAUDE.md<\/code><\/td>\n<td>Projektspezifische Regeln. Build Commands, Konventionen. Geh\u00f6rt in Git.<\/td>\n<td>Ja<\/td>\n<\/tr>\n<tr>\n<td><strong>Local Secret<\/strong> <em>NEW 2026<\/em><\/td>\n<td><code>.\/CLAUDE.local.md<\/code><\/td>\n<td>Pers\u00f6nliche Notizen und Secrets. Geh\u00f6rt in <code>.gitignore<\/code>. Nie geteilt.<\/td>\n<td>Nein<\/td>\n<\/tr>\n<tr>\n<td><strong>Folder<\/strong><\/td>\n<td><code>.\/src\/CLAUDE.md<\/code><\/td>\n<td>Modul-Level-Overrides f\u00fcr APIs, Components. On-demand geladen.<\/td>\n<td>Ja<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<p>Die Kaskade ist strategisch wichtig. <strong>Universelle Regeln geh\u00f6ren in die Root. Modul-spezifisches Wissen in Subverzeichnisse.<\/strong> So werden sie nur geladen, wenn Claude in dem Ordner arbeitet \u2013 und sparen Context-Tokens.<\/p>\n<h3>Tipp zum Local Secret Scope<\/h3>\n<p>Der <code>CLAUDE.local.md<\/code>-Scope ist 2026 neu und gold wert: Hier kommen deine pers\u00f6nlichen Shortcuts, WIP-Notizen und sensitive Pfade hin, ohne dass sie je in Git landen. Die Datei geh\u00f6rt sofort in <code>.gitignore<\/code>, sobald du sie anlegst.<\/p>\n<h2>Was ist das WHAT\/WHY\/HOW Framework f\u00fcr CLAUDE.md?<\/h2>\n<p>Das WHAT\/WHY\/HOW Framework zwingt dich zur Vollst\u00e4ndigkeit. <strong>Wenn du eines der drei wegl\u00e4sst, r\u00e4t Claude. Und Claude r\u00e4t falsch.<\/strong> Hier ist die exakte Struktur:<\/p>\n<h3>WHAT \u2013 Gib Kontext<\/h3>\n<p>Ohne diese Basis arbeitet Claude im Blindflug:<\/p>\n<ul>\n<li>Projektname und Purpose<\/li>\n<li>Tech Stack mit <strong>Versionen<\/strong> (nicht &#171;React&#187;, sondern &#171;React 18.3 + TypeScript 5.4 + Vite 5&#187;)<\/li>\n<li>Repository-Struktur-Map (wo liegen Utils, Types, API-Endpoints?)<\/li>\n<li>Kritische Dependencies<\/li>\n<li>Bei Monorepos: was macht jede einzelne App?<\/li>\n<\/ul>\n<h3>WHY \u2013 Setze Prinzipien<\/h3>\n<p>Die Regeln, die dein Team \u00fcber Monate etabliert hat:<\/p>\n<ul>\n<li>Architektur-Entscheidungen mit Begr\u00fcndung<\/li>\n<li>Code-Style und Lint-Rules<\/li>\n<li>Naming Conventions<\/li>\n<li>Anti-Patterns, die du vermeiden willst<\/li>\n<li>Security-Constraints<\/li>\n<\/ul>\n<h3>HOW \u2013 Definiere Workflows<\/h3>\n<p>Die operationalen Commands, die bei jeder Session z\u00e4hlen:<\/p>\n<ul>\n<li><code>npm run build<\/code> \u2013 Build-Command<\/li>\n<li><code>npm test<\/code> \u2013 nach jeder \u00c4nderung ausf\u00fchren<\/li>\n<li><code>eslint . --fix<\/code> \u2013 bei jedem Save<\/li>\n<li>Branch- und Commit-Strategie<\/li>\n<li>Deploy- und CI\/CD-Steps<\/li>\n<\/ul>\n<h3>Konkretes HOW-Beispiel, das sofort funktioniert<\/h3>\n<pre><code>## Workflow\n- Run `npm test` after every code change\n- Always create a new branch per task. NEVER commit to main directly\n- Use Conventional Commits (feat:, fix:, refactor:, docs:)\n- Run `eslint . --fix` before every commit\n- Open a PR via `gh pr create` when work is complete\n<\/code><\/pre>\n<h2>Wie sieht eine gute CLAUDE.md in der Praxis aus?<\/h2>\n<p>Du hast zwei Wege, CLAUDE.md zu erstellen: <strong>manuell schreiben oder <code>\/init<\/code> in Claude Code laufen lassen.<\/strong> Keiner von beiden liefert ein produktionsreifes Resultat. <code>\/init<\/code> generiert ein Bare-Bones-Scaffold. Manuell geschrieben fehlt meist die konsistente Struktur.<\/p>\n<p>Die bessere Variante: Starte mit einem Template, das das WHAT\/WHY\/HOW Framework, die Hooks-Konfiguration und SKILL.md-Templates bereits abbildet. Mein Team hat ein Agentic Coding Meta-Prompt Repository auf GitHub ver\u00f6ffentlicht, das genau das liefert \u2013 <a href=\"https:\/\/github.com\/obviousworks\/agentic-coding-meta-prompt\" target=\"_blank\" rel=\"noopener\">github.com\/obviousworks\/agentic-coding-meta-prompt<\/a>.<\/p>\n<p>Das Repository enth\u00e4lt:<\/p>\n<ul>\n<li>CLAUDE.md Template (\u2264200 Zeilen)<\/li>\n<li>AGENTS.md f\u00fcr Multi-Agent-Workflows<\/li>\n<li>Hooks-Config in <code>.claude\/settings.json<\/code><\/li>\n<li>SKILL.md Templates und Beispiele<\/li>\n<\/ul>\n<h2>Wie schreibst du pr\u00e4zise Instruktionen statt vager Regeln?<\/h2>\n<p>Der einzige Unterschied zwischen einer CLAUDE.md, die ignoriert wird, und einer, die funktioniert: <strong>Pr\u00e4zision.<\/strong> Vage Instruktionen sind f\u00fcr Claude wie vage Tickets f\u00fcr einen Junior-Entwickler \u2013 beide halluzinieren eine Interpretation.<\/p>\n<figure>\n<table>\n<thead>\n<tr>\n<th>\u2717 Vage (wird ignoriert)<\/th>\n<th>\u2713 Pr\u00e4zise (wird befolgt)<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Write clean code<\/td>\n<td>Use camelCase for variables, PascalCase for React components<\/td>\n<\/tr>\n<tr>\n<td>Test everything<\/td>\n<td><code>npm test<\/code> after every change, min 80% coverage for <code>utils\/<\/code><\/td>\n<\/tr>\n<tr>\n<td>Prefer TypeScript<\/td>\n<td>MUST use TypeScript strict mode. MUST NOT use <code>any<\/code> type<\/td>\n<\/tr>\n<tr>\n<td>Be careful with git<\/td>\n<td>Always create a new branch per task. NEVER commit to main directly<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<p>Pr\u00e4zision zwingt dich, deine impliziten Team-Standards zu artikulieren. Das ist wertvoll, <em>auch wenn du Claude nie wieder nutzen w\u00fcrdest<\/em>.<\/p>\n<h2>Was sind die 7 Regeln, die dein CLAUDE.md Setup wirklich funktionieren lassen?<\/h2>\n<p>Diese sieben Regeln stammen direkt aus den Claude Code Docs und aus Boris Chernys \u00f6ffentlich geteiltem Workflow. Sie sind das Fundament:<\/p>\n<ol>\n<li><strong>Run <code>\/init<\/code> first.<\/strong> Lass Claude das Baseline aus deiner Codebase scaffolden. Dann kuratieren. Starte nie bei null \u2013 du vergisst zu viel.<\/li>\n<li><strong>Stay under 200 lines.<\/strong> Zu lang = ignoriert. Claude attendet ~150 Instruktionen zuverl\u00e4ssig. Jede Zeile muss sich verdienen.<\/li>\n<li><strong>Hooks for 100% enforcement.<\/strong> CLAUDE.md ist advisory (~70% befolgt). Hooks sind deterministisch. Nutze sie f\u00fcr Lint, Test, Security.<\/li>\n<li><strong>Use <code>@imports<\/code> for modularity.<\/strong> Neu in 2026: Splitte Configs via <code>@docs\/git.md<\/code>. Sauberer, scoped, wiederverwendbar \u00fcber Projekte.<\/li>\n<li><strong><code>\/compact<\/code> &amp; Plan Mode.<\/strong> Neu in 2026: <code>\/compact<\/code> bei 50% Context-Fill. Plan Mode f\u00fcr jede Task mit 3+ Steps.<\/li>\n<li><strong>Update it monthly.<\/strong> CLAUDE.md ist ein Living Document. Jedes Mal, wenn Claude irrt: Regel hinzuf\u00fcgen. Boris nennt das <em>Compound Engineering<\/em>.<\/li>\n<li><strong>Reference, don&#8217;t duplicate.<\/strong> Verweise auf <code>package.json<\/code> und <code>tsconfig<\/code>. Nicht kopieren. Nutze die <code>@path\/to\/file<\/code> Syntax.<\/li>\n<\/ol>\n<h2>Wie funktioniert Compound Engineering mit CLAUDE.md?<\/h2>\n<p><strong>Compound Engineering ist der Game Changer.<\/strong> Das Prinzip, das Boris Cherny bei Anthropic etabliert hat: Jede Code-Review, jede Korrektur, jeder Fehler wird zu einer neuen Regel in CLAUDE.md. Die Datei w\u00e4chst mit der Erfahrung des Teams.<\/p>\n<p>In Anthropic&#8217;s Workflow nutzt Boris den <code>@.claude<\/code>-Tag auf PRs von Kollegen \u2013 Claude f\u00fcgt das Learning automatisch in CLAUDE.md ein (Quelle: <a href=\"https:\/\/www.vibesparking.com\/en\/blog\/ai\/claude-code\/2026-01-04-boris-cheny-claude-code-workflow-revealed\/\" target=\"_blank\" rel=\"noopener\">Vibe Sparking AI, Januar 2026<\/a>). Das Resultat nach drei Monaten:<\/p>\n<ul>\n<li>Claude macht denselben Fehler <strong>nie wieder<\/strong><\/li>\n<li>Das Team-Know-how wird systematisch kodifiziert<\/li>\n<li>Neue Team-Mitglieder haben ab Tag 1 Zugriff auf alle Learnings<\/li>\n<\/ul>\n<p>Das ist kein Hype. Das ist der eigentliche ROI.<\/p>\n<h2>Welche Advanced Patterns machen 2026 den Unterschied?<\/h2>\n<p>Jenseits der Basics gibt es drei Systeme, die erfahrene Teams trennen von Hobby-Nutzern: <strong>Hooks, Skills und Multi-Session<\/strong>. Alle drei sind Teil des Cheat Sheets und sollten bis Ende Q2 2026 in jedem professionellen Setup stehen.<\/p>\n<h3>\u26a1 Das Hooks System<\/h3>\n<p>Hooks sind deterministische Callbacks in <code>.claude\/settings.json<\/code>. Wo CLAUDE.md advisory ist (Claude kann sie &#171;vergessen&#187;), sind Hooks zwingend. Exit Code 0 = erlaubt, Exit Code 2 = blockiert. Keine Diskussion.<\/p>\n<p>Die vier wichtigsten Patterns:<\/p>\n<ul>\n<li><strong>PreToolUse:<\/strong> Route risky Operations zu Opus f\u00fcr Approval \u2013 z.B. <code>git push --force<\/code><\/li>\n<li><strong>PostToolUse:<\/strong> Auto-Format Code nach jedem File-Edit (Boris nutzt <code>bun run format<\/code>)<\/li>\n<li><strong>Stop Hook:<\/strong> Verifiziert die Arbeit, bevor Claude &#171;done&#187; markiert<\/li>\n<li><strong><code>\/careful<\/code>:<\/strong> Blockiert destruktive Commands wie <code>rm -rf<\/code><\/li>\n<\/ul>\n<p>Browse die konfigurierten Hooks jederzeit via <code>\/hooks<\/code> im laufenden Claude Code.<\/p>\n<h3>\ud83e\udde0 Das Skills System<\/h3>\n<p>Skills sind markdown-basierte Guides in <code>.claude\/skills\/SKILL.md<\/code>, die <strong>on-demand geladen werden, nicht bei jeder Session<\/strong>. Das ist der entscheidende Unterschied zu CLAUDE.md: Skills schonen deinen Context.<\/p>\n<p>Die Kern-Features:<\/p>\n<ul>\n<li>Invocation via <code>\/skill-name<\/code> oder automatisch, wenn die Description matcht<\/li>\n<li>Embed <code>!`command`<\/code> f\u00fcr Live-Shell-Output in den Prompt<\/li>\n<li>Transparenter als MCPs \u2013 auditable, keine Black Box<\/li>\n<li>Inklusive Libs, damit Claude komponiert statt from scratch baut<\/li>\n<\/ul>\n<p>Typische Skills in produktiven Teams: Code-Review-Patterns, Testing-Konventionen, Migration-Guides, BigQuery-Analytics. Boris&#8216; Team hat einen BigQuery-Skill im Repo und nutzt ihn t\u00e4glich f\u00fcr Analytics direkt in Claude Code.<\/p>\n<h3>\ud83d\udd00 Multi-Session Workflow (Boris&#8217;s Method)<\/h3>\n<p>Boris Cherny f\u00fchrt bei Anthropic <strong>10 bis 15 Claude-Sessions parallel<\/strong>: 5 lokal in Terminal-Tabs, 5-10 auf claude.ai\/code. Plus Sessions, die er morgens vom iPhone startet. Klingt verr\u00fcckt, ist aber systematisch:<\/p>\n<ul>\n<li>Jede Session bekommt einen eigenen <strong>Git Worktree<\/strong> \u2013 \u00c4nderungen kollidieren nicht<\/li>\n<li><code>\/compact<\/code> bei 50% Context, <code>\/clear<\/code> beim Task-Wechsel<\/li>\n<li>Plan \u2192 Execute \u2192 Verify (Tests + Linter + Build, immer)<\/li>\n<li>Nach jedem Fehler: Fix in <code>tasks\/lessons.md<\/code> kodieren<\/li>\n<\/ul>\n<p>Der Self-Improvement-Loop ist der wahre Hebel. Jede Korrektur wird zu einer Regel. Nach drei Monaten ersetzt dein CLAUDE.md Monate an Onboarding-Doku.<\/p>\n<h2>Was ist der Unterschied zwischen CLAUDE.md und AGENTS.md?<\/h2>\n<p>CLAUDE.md ist f\u00fcr Single-Agent-Workflows im prim\u00e4ren Claude-Kontext. <strong>AGENTS.md ist der neue Standard f\u00fcr Multi-Agent-Workflows<\/strong> und Interoperabilit\u00e4t zwischen Claude, Cursor, Cline und anderen AI-Coding-Tools.<\/p>\n<p>Wenn du Subagents orchestrierst \u2013 z.B. einen &#171;Code Simplifier&#187; Subagent nach jedem Feature oder einen &#171;Verify App&#187; Subagent f\u00fcr End-to-End-Tests \u2013 geh\u00f6rt die Konfiguration in AGENTS.md. Das macht dein Setup Tool-agnostisch und Team-\u00fcbergreifend portabel.<\/p>\n<h2>Wie viele Zeilen sollte deine CLAUDE.md haben?<\/h2>\n<p><strong>Unter 200 Zeilen. Maximal 150 Instructions.<\/strong> Das ist Anthropic&#8217;s offizielle Empfehlung und Community-Konsens 2026.<\/p>\n<p>Die Begr\u00fcndung steht in den offiziellen Docs: Bloated CLAUDE.md-Files f\u00fchren dazu, dass Claude die <em>eigentlichen<\/em> Instruktionen ignoriert (Quelle: <a href=\"https:\/\/code.claude.com\/docs\/en\/best-practices\" target=\"_blank\" rel=\"noopener\">Claude Code Docs, 2026<\/a>). Wenn Claude eine Regel trotz <code>YOU MUST<\/code> wiederholt bricht, ist deine Datei zu lang geworden und die Regel geht unter.<\/p>\n<p>Der Test f\u00fcr jede einzelne Zeile: <em>&#171;W\u00fcrde das Entfernen dieser Zeile Claude Fehler machen lassen?&#187;<\/em> Wenn nein: l\u00f6schen. Diese Disziplin ist unangenehm, aber essentiell.<\/p>\n<p>Bei l\u00e4ngerem Content nutzt du <code>@imports<\/code> f\u00fcr Modularit\u00e4t:<\/p>\n<pre><code># CLAUDE.md (Root)\n@docs\/architecture.md\n@.claude\/git-conventions.md\n@.claude\/security-rules.md\n<\/code><\/pre>\n<h2>FAQ: Die h\u00e4ufigsten Fragen zu CLAUDE.md<\/h2>\n<h3>Brauche ich CLAUDE.md in jedem Projekt?<\/h3>\n<p>Ja, wenn du Claude Code ernsthaft nutzt. Die 2026 Community-Meinung ist eindeutig: <strong>CLAUDE.md ist so wichtig wie <code>.gitignore<\/code><\/strong>. Essential Infrastructure, nicht optionale Doku.<\/p>\n<h3>Was ist der Unterschied zwischen CLAUDE.md und einer README?<\/h3>\n<p>Die README ist f\u00fcr Menschen, die das Projekt starten wollen. CLAUDE.md ist Onboarding-Doku f\u00fcr deinen AI-Teammate. Unterschiedliche Audience, unterschiedliche Struktur, unterschiedliche L\u00e4nge.<\/p>\n<h3>Sollte CLAUDE.md in Git committed werden?<\/h3>\n<p>Ja \u2013 die projektspezifische <code>.\/CLAUDE.md<\/code> geh\u00f6rt in Git f\u00fcr Team-Konsistenz. Pers\u00f6nliche Notizen und Secrets geh\u00f6ren in <code>.\/CLAUDE.local.md<\/code>, die in <code>.gitignore<\/code> steht. Die Global-Scope-Datei <code>~\/.claude\/CLAUDE.md<\/code> bleibt sowieso lokal.<\/p>\n<h3>Wie oft sollte ich CLAUDE.md updaten?<\/h3>\n<p>Mindestens monatlich, idealerweise <strong>sofort nach jedem wiederkehrenden Fehler<\/strong>. Boris&#8216; Faustregel: &#171;Anytime we see Claude do something incorrectly, we add it to CLAUDE.md so it doesn&#8217;t repeat next time.&#187; Das ist Compound Engineering in Reinform.<\/p>\n<h3>Wie viele Tokens verbraucht eine CLAUDE.md?<\/h3>\n<p>Boris Chernys CLAUDE.md bei Anthropic hat rund <strong>2&#8217;500 Tokens (~100 Zeilen)<\/strong>. Mehr als 5&#8217;000 Tokens ist fast immer zu viel \u2013 dann f\u00e4ngst du an, Claude&#8217;s echten Arbeitskontext zu verdr\u00e4ngen.<\/p>\n<h3>Funktioniert CLAUDE.md auch mit Cursor oder Windsurf?<\/h3>\n<p>Nicht direkt. Cursor nutzt <code>.cursorrules<\/code>, Windsurf hat eigenes Format. <strong>AGENTS.md ist der aufkommende offene Standard<\/strong> f\u00fcr Tool-\u00fcbergreifende Konfiguration. F\u00fcr reinen Claude Code Einsatz bleibt CLAUDE.md die kanonische Datei.<\/p>\n<h3>Muss ich Skills manuell bef\u00fcllen?<\/h3>\n<p>Nein. Du kannst Skills explizit via <code>\/skill-name<\/code> aufrufen oder Claude l\u00e4sst sie automatisch triggern, wenn die Description zum aktuellen Task passt. Community-Skills gibt es auf GitHub f\u00fcr fast jeden Anwendungsfall \u2013 von Code-Review bis BigQuery-Analytics.<\/p>\n<h3>Was tun, wenn Claude die CLAUDE.md-Regeln trotzdem ignoriert?<\/h3>\n<p>Drei m\u00f6gliche Ursachen in dieser Reihenfolge: (1) Die Datei ist \u00fcber 200 Zeilen, Claude verliert wichtige Regeln im Noise. K\u00fcrzen. (2) Die Regel ist vage formuliert. Pr\u00e4zise machen mit &#171;MUST&#187; oder &#171;NEVER&#187;. (3) Die Regel ist <em>wirklich<\/em> deterministisch kritisch \u2013 dann erzwinge sie via Hook in <code>.claude\/settings.json<\/code>.<\/p>\n<h2>Dein 48-Stunden Action Plan<\/h2>\n<p>Setup-Zeit: ein Nachmittag. Wirkung: Monate.<\/p>\n<p><strong>Tag 1 \u2013 Fundament (90 Minuten):<\/strong><\/p>\n<ol>\n<li>F\u00fchre <code>\/init<\/code> in deinem Hauptprojekt aus<\/li>\n<li>K\u00fcrze die generierte CLAUDE.md auf unter 200 Zeilen<\/li>\n<li>Strukturiere nach WHAT\/WHY\/HOW<\/li>\n<li>Lege <code>CLAUDE.local.md<\/code> f\u00fcr pers\u00f6nliche Notizen an, erg\u00e4nze <code>.gitignore<\/code><\/li>\n<li>Committe <code>CLAUDE.md<\/code> in Git<\/li>\n<\/ol>\n<p><strong>Tag 2 \u2013 Advanced Patterns (60 Minuten):<\/strong><\/p>\n<ol>\n<li>Identifiziere 3 wiederkehrende Korrekturen aus der letzten Woche<\/li>\n<li>Kodiere sie als pr\u00e4zise Regeln in CLAUDE.md<\/li>\n<li>Setup einen ersten PostToolUse-Hook f\u00fcr Auto-Lint<\/li>\n<li>Lege einen ersten Skill in <code>.claude\/skills\/<\/code> an (z.B. <code>code-review.md<\/code>)<\/li>\n<li>Teste mit einer echten Task und verifiziere das Verhalten<\/li>\n<\/ol>\n<p><strong>Nach 30 Tagen \u2013 Review:<\/strong> Welche Regeln haben gez\u00fcndet? Welche werden ignoriert (dann: zu lang, zu vage oder Hook fehlt)? Welche neuen Korrekturen geh\u00f6ren rein?<\/p>\n<h2>Das eigentliche Versprechen<\/h2>\n<p>Claude Code ist kein Tool. <strong>Es ist ein Teammate, der exakt so gut wird, wie du sein Onboarding gestaltest.<\/strong> Die 4 Layer \u2013 CLAUDE.md, Skills, Hooks, Subagents \u2013 sind dein Hebel. Die 5 Scopes, das WHAT\/WHY\/HOW Framework und Compound Engineering sind dein Betriebssystem.<\/p>\n<p>Ein Nachmittag Setup. Dann verstehst du, warum Teams, die 2026 bereits umgestellt haben, nicht mehr zur\u00fcckwollen \u2013 und warum die anderen t\u00e4glich Kontext verlieren, den sie l\u00e4ngst h\u00e4tten kodifizieren k\u00f6nnen.<\/p>\n<p>Die Frage ist nicht <em>ob<\/em> du diese Architektur brauchst. Die Frage ist, wie viele Monate du noch ohne sie arbeiten willst.<br \/><!-- Schema erzeugt, diesen Block entfernen        --><br \/><!-- ============================================ --><\/p>\n<p>\n<script type=\"application\/ld+json\">\n{\n  \"@context\": \"https:\/\/schema.org\",\n  \"@type\": \"FAQPage\",\n  \"mainEntity\": [\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Brauche ich CLAUDE.md in jedem Projekt?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Ja, wenn du Claude Code ernsthaft nutzt. Die 2026 Community-Meinung ist eindeutig: CLAUDE.md ist so wichtig wie .gitignore. Essential Infrastructure, nicht optionale Doku.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Was ist der Unterschied zwischen CLAUDE.md und einer README?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Die README ist f\u00fcr Menschen, die das Projekt starten wollen. CLAUDE.md ist Onboarding-Doku f\u00fcr deinen AI-Teammate. Unterschiedliche Audience, unterschiedliche Struktur, unterschiedliche L\u00e4nge.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Sollte CLAUDE.md in Git committed werden?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Ja \u2013 die projektspezifische .\/CLAUDE.md geh\u00f6rt in Git f\u00fcr Team-Konsistenz. Pers\u00f6nliche Notizen und Secrets geh\u00f6ren in .\/CLAUDE.local.md, die in .gitignore steht.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Wie oft sollte ich CLAUDE.md updaten?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Mindestens monatlich, idealerweise sofort nach jedem wiederkehrenden Fehler. Boris Chernys Faustregel: Jedes Mal, wenn Claude etwas falsch macht, wird eine Regel hinzugef\u00fcgt, damit es nicht wiederholt passiert. Das ist Compound Engineering.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Wie viele Tokens verbraucht eine CLAUDE.md?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Boris Chernys CLAUDE.md bei Anthropic hat rund 2500 Tokens, etwa 100 Zeilen. Mehr als 5000 Tokens ist fast immer zu viel \u2013 dann verdr\u00e4ngt die Datei den eigentlichen Arbeitskontext.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Was sind die 5 Scopes von CLAUDE.md?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Die 4 Haupt-Scopes 2026 sind: Global (~\/.claude\/CLAUDE.md) f\u00fcr pers\u00f6nliche Defaults, Project (.\/CLAUDE.md) f\u00fcr projektspezifische Regeln, Local Secret (.\/CLAUDE.local.md) f\u00fcr Notizen und Secrets, und Folder (.\/src\/CLAUDE.md) f\u00fcr Modul-Overrides. Last scope wins on conflicts.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Wie viele Zeilen sollte eine CLAUDE.md haben?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"Unter 200 Zeilen, maximal 150 Instructions. Das ist Anthropic's offizielle Empfehlung und Community-Konsens 2026. L\u00e4ngere Dateien f\u00fchren dazu, dass Claude die eigentlichen Instruktionen ignoriert.\"\n      }\n    },\n    {\n      \"@type\": \"Question\",\n      \"name\": \"Was ist der Unterschied zwischen CLAUDE.md und AGENTS.md?\",\n      \"acceptedAnswer\": {\n        \"@type\": \"Answer\",\n        \"text\": \"CLAUDE.md ist f\u00fcr Single-Agent-Workflows in Claude Code. AGENTS.md ist der neue 2026 Standard f\u00fcr Multi-Agent-Workflows und Interoperabilit\u00e4t zwischen Claude, Cursor, Cline und anderen AI-Coding-Tools.\"\n      }\n    }\n  ]\n}\n<\/script>\n<\/p>[\/et_pb_text][dsm_card title=&#187;Claude Code Architektur Cheat Sheet&#187; subtitle=&#187;Jetzt kostenlos runterladen &#8211; lesen, verteilen und innerhalb kurzer Zeit agentisch Software entwickeln &#8211; Viel Spa\u00df&#187; image=&#187;https:\/\/www.obviousworks.ch\/wp-content\/uploads\/2026\/04\/ClaudeCodeCheatSheet2026.jpg&#187; badge_text=&#187;Claude Code Cheat Sheet 2026&#8243; badge_url=&#187;https:\/\/www.obviousworks.ch\/download\/CLAUDE.md_Architecture_Guide_2026_ObviousWorks.pdf&#187; button_text=&#187;Hier klicken &#038; kostenlos downloaden&#187; button_url=&#187;https:\/\/www.obviousworks.ch\/download\/CLAUDE.md_Architecture_Guide_2026_ObviousWorks.pdf&#187; button_url_new_window=&#187;on&#187; _builder_version=&#187;4.27.6&#8243; _module_preset=&#187;default&#187; background_color=&#187;#0a0001&#8243; custom_button=&#187;on&#187; button_text_size=&#187;21px&#187; button_text_color=&#187;#F67E28&#8243; button_alignment=&#187;center&#187; background_layout=&#187;dark&#187; link_option_url=&#187;https:\/\/www.obviousworks.ch\/download\/CLAUDE.md_Architecture_Guide_2026_ObviousWorks.pdf&#187; global_colors_info=&#187;{}&#187;][\/dsm_card][et_pb_pricing_tables _builder_version=&#187;4.27.5&#8243; _module_preset=&#187;default&#187; global_module=&#187;4722&#8243; global_colors_info=&#187;{}&#187;][et_pb_pricing_table featured=&#187;on&#187; title=&#187;AI Developer Bootcamp&#187; subtitle=&#187;KI-First Ansatz etablieren&#187; button_text=&#187;Zum Hackathon&#187; _builder_version=&#187;4.27.5&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187; sticky_transition=&#187;on&#187;]<p><strong>Ihr startet jetzt mit KI in der Software Entwicklung? Dann ist das AI Developer Bootcamp das Richtige f\u00fcr euch.<\/strong><strong><\/strong><\/p>\n<p id=\"devaihackathonhandsonagentharnesstraining\">In 12 Wochen etablieren wir mit Hands-on Aufgaben und w\u00f6chentlichen Retros in einem blenden-Learning Ansatz neue und stabile KI-Gewohnheiten.<\/p>\n<p>\ud83d\udc49 <strong>Infos &amp; Anmeldung zum AI Developer Bootcamp<\/strong>: <a href=\"https:\/\/www.obviousworks.ch\/schulungen\/ai-developer-bootcamp\/\">obviousworks.ch\/schulungen\/ai-developer-bootcamp<\/a><\/p>[\/et_pb_pricing_table][et_pb_pricing_table title=&#187;Agentic Coding Hackathon&#187; subtitle=&#187;In 3-5 Tagen auf Kurs sein!&#187; button_text=&#187;Zum Hackathon&#187; _builder_version=&#187;4.27.5&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187; sticky_transition=&#187;on&#187;]<p><strong>Du und dein Team seid schon richtig gut mit KI unterwegs? Dann ist der Agentic Coding Hackathon das Richtige f\u00fcr euch.<\/strong><strong><\/strong><\/p>\n<p id=\"devaihackathonhandsonagentharnesstraining\">In 3-5 Tagen euren neuen KI-basierten Software Development Prozess lernen und etablieren?<br \/>\ud83d\udc49 <strong>Infos &amp; Anmeldung zum Hackathon<\/strong>: <a href=\"https:\/\/www.obviousworks.ch\/schulungen\/agentic-coding-hackathon\" target=\"_blank\" rel=\"noopener\">https:\/\/www.obviousworks.ch\/schulungen\/agentic-coding-hackathon<\/a><\/p>[\/et_pb_pricing_table][\/et_pb_pricing_tables][\/et_pb_column][\/et_pb_row][et_pb_row column_structure=&#187;1_3,2_3&#8243; admin_label=&#187;Author Matthias&#187; _builder_version=&#187;4.27.4&#8243; _module_preset=&#187;default&#187; saved_tabs=&#187;all&#187; global_colors_info=&#187;{}&#187;][et_pb_column type=&#187;1_3&#8243; _builder_version=&#187;4.27.4&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187;][dsm_tilt_image src=&#187;https:\/\/www.obviousworks.ch\/wp-content\/uploads\/2024\/09\/MH_Trainer_BW_T.png&#187; title_text=&#187;MH_Trainer_BW_T&#187; dsm_tilt_scale=&#187;1.1&#8243; _builder_version=&#187;4.27.4&#8243; _module_preset=&#187;default&#187; transform_rotate=&#187;0deg|0deg|349deg&#187; border_radii=&#187;on|50%|50%|50%|50%&#187; border_width_all=&#187;4px&#187; border_color_all=&#187;#F5FAFE&#187; border_style_all=&#187;double&#187; box_shadow_style=&#187;preset1&#8243; global_colors_info=&#187;{}&#187;][\/dsm_tilt_image][\/et_pb_column][et_pb_column type=&#187;2_3&#8243; _builder_version=&#187;4.27.4&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187;][dsm_dual_heading before_text=&#187;Matthias &#187; middle_text=&#187;(AI Ninja) &#187; _builder_version=&#187;4.27.4&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187;][\/dsm_dual_heading][et_pb_text _builder_version=&#187;4.27.4&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187;]<p><span>Matthias ist mit Herz, Seele und Verstand dabei. Er macht dich, dein Team und deine Firma fit f\u00fcr die Zukunft mit KI!<\/span><\/p>\n<p>Zu Matthias <a href=\"https:\/\/www.obviousworks.ch\/ueber-uns\/trainer-matthias-herbert\/\">Trainerprofil<\/a><br \/>Zu seinem <a href=\"https:\/\/www.linkedin.com\/in\/matthiasherbert\/\" target=\"_blank\" rel=\"noopener\">LinkedIn Profil<\/a><\/p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row _builder_version=&#187;4.27.6&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187;][et_pb_column type=&#187;4_4&#8243; _builder_version=&#187;4.27.6&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187;][et_pb_text _builder_version=&#187;4.27.6&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187;]<p><!-- CTA BOX                                       --><br \/><!-- ============================================ --><\/p>\n<div style=\"background-color: #f5f5f5; padding: 24px; border-left: 4px solid #333; margin: 32px 0;\">\n<h3 style=\"margin-top: 0;\">Brauchst du Unterst\u00fctzung beim Aufbau deiner Claude Code Architektur?<\/h3>\n<p>Wir bei <strong>Obvious Works<\/strong> bieten hands-on Training und tiefe Begleitung bei der Integration von Agentic Coding in Entwickler-Teams. Kein generisches AI-Gerede, sondern erprobte Setups, die in Produktion funktionieren \u2013 vom CLAUDE.md-Architecture-Review bis zur Multi-Session-Orchestrierung mit Hooks, Skills und Subagents.<a href=\"https:\/\/obviousworks.ch\" target=\"_blank\" rel=\"noopener\"><\/a><\/p>\n<\/div>\n<hr \/>\n<p><!-- ============================================ --><br \/><!-- QUELLENVERZEICHNIS                            --><br \/><!-- ============================================ --><\/p>\n<h3>Quellen<\/h3>\n<ol>\n<li>Anthropic \u2013 <a href=\"https:\/\/code.claude.com\/docs\/en\/best-practices\" target=\"_blank\" rel=\"noopener\">Best Practices for Claude Code (Official Docs)<\/a>, 2026<\/li>\n<li>InfoQ \u2013 <a href=\"https:\/\/www.infoq.com\/news\/2026\/01\/claude-code-creator-workflow\/\" target=\"_blank\" rel=\"noopener\">Inside the Development Workflow of Claude Code&#8217;s Creator<\/a>, Januar 2026<\/li>\n<li>Vibe Sparking AI \u2013 <a href=\"https:\/\/www.vibesparking.com\/en\/blog\/ai\/claude-code\/2026-01-04-boris-cheny-claude-code-workflow-revealed\/\" target=\"_blank\" rel=\"noopener\">Boris Cherny&#8217;s Claude Code Workflow Revealed<\/a>, Januar 2026<\/li>\n<li>Pragmatic Engineer \u2013 <a href=\"https:\/\/newsletter.pragmaticengineer.com\/p\/building-claude-code-with-boris-cherny\" target=\"_blank\" rel=\"noopener\">Building Claude Code with Boris Cherny<\/a>, M\u00e4rz 2026<\/li>\n<li>Push to Prod \u2013 <a href=\"https:\/\/getpushtoprod.substack.com\/p\/how-the-creator-of-claude-code-actually\" target=\"_blank\" rel=\"noopener\">How the Creator of Claude Code Actually Uses Claude Code<\/a>, Februar 2026<\/li>\n<li>Morph Labs \u2013 <a href=\"https:\/\/www.morphllm.com\/claude-code-best-practices\" target=\"_blank\" rel=\"noopener\">Claude Code Best Practices: The 2026 Guide to 10x Productivity<\/a>, Februar 2026<\/li>\n<\/ol>[\/et_pb_text][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=&#187;1&#8243; _builder_version=&#187;4.17.4&#8243; _module_preset=&#187;default&#187; background_color=&#187;#F5FAFE&#187; global_colors_info=&#187;{}&#187;][et_pb_row column_structure=&#187;1_2,1_2&#8243; _builder_version=&#187;4.17.4&#8243; global_colors_info=&#187;{}&#187;][et_pb_column type=&#187;1_2&#8243; _builder_version=&#187;4.17.4&#8243; custom_padding=&#187;|||&#187; global_colors_info=&#187;{}&#187; custom_padding__hover=&#187;|||&#187;][et_pb_image src=&#187;https:\/\/www.obviousworks.ch\/wp-content\/uploads\/2024\/01\/ObviousWorks_Logo_DA-1.webp&#187; alt=&#187;Obvious Works Logo&#187; title_text=&#187;ObviousWorks_Logo_DA&#187; _builder_version=&#187;4.17.4&#8243; module_alignment=&#187;left&#187; max_height=&#187;100px&#187; custom_margin=&#187;||15px|&#187; always_center_on_mobile=&#187;off&#187; global_colors_info=&#187;{}&#187;][\/et_pb_image][et_pb_text _builder_version=&#187;4.27.4&#8243; _module_preset=&#187;default&#187; text_font=&#187;Poppins||||||||&#187; text_text_color=&#187;#13658A&#187; global_colors_info=&#187;{}&#187;]<p style=\"text-align: left;\">Dein Partner f\u00fcr<br \/>Agilit\u00e4t &amp; Requirements &amp; K\u00fcnstliche Intelligenz<br \/>Wir trainieren Product Owner, Projektmanager, Software Entwickler, CTOs, HR-Professionals und Manager.<\/p>[\/et_pb_text][\/et_pb_column][et_pb_column type=&#187;1_2&#8243; _builder_version=&#187;4.16&#8243; custom_padding=&#187;|||&#187; global_colors_info=&#187;{}&#187; custom_padding__hover=&#187;|||&#187;][et_pb_social_media_follow _builder_version=&#187;4.27.5&#8243; text_orientation=&#187;right&#187; border_radii=&#187;on|50px|50px|50px|50px&#187; border_width_all=&#187;5px&#187; global_colors_info=&#187;{}&#187;][et_pb_social_media_follow_network social_network=&#187;youtube&#187; url=&#187;https:\/\/www.youtube.com\/@obviousworks&#187; icon_color=&#187;#FFFFFF&#187; _builder_version=&#187;4.24.0&#8243; background_color=&#187;#13658A&#187; background_enable_color=&#187;on&#187; border_width_all=&#187;12px&#187; border_color_all=&#187;rgba(0,0,0,0)&#187; global_colors_info=&#187;{}&#187; follow_button=&#187;off&#187; url_new_window=&#187;on&#187;]youtube[\/et_pb_social_media_follow_network][et_pb_social_media_follow_network social_network=&#187;linkedin&#187; url=&#187;https:\/\/www.linkedin.com\/company\/obviousworks\/&#187; icon_color=&#187;#FFFFFF&#187; _builder_version=&#187;4.17.4&#8243; background_color=&#187;#52B4DB&#187; background_enable_color=&#187;on&#187; border_width_all=&#187;12px&#187; border_color_all=&#187;rgba(0,0,0,0)&#187; global_colors_info=&#187;{}&#187; follow_button=&#187;off&#187; url_new_window=&#187;on&#187;]linkedin[\/et_pb_social_media_follow_network][et_pb_social_media_follow_network social_network=&#187;github&#187; url=&#187;https:\/\/github.com\/obviousworks\/&#187; icon_color=&#187;#FFFFFF&#187; _builder_version=&#187;4.27.5&#8243; _module_preset=&#187;default&#187; background_color=&#187;#54595F&#187; background_enable_color=&#187;on&#187; border_width_all=&#187;12px&#187; border_color_all=&#187;rgba(0,0,0,0)&#187; global_colors_info=&#187;{}&#187; follow_button=&#187;off&#187; url_new_window=&#187;on&#187;]github[\/et_pb_social_media_follow_network][\/et_pb_social_media_follow][\/et_pb_column][\/et_pb_row][et_pb_row column_structure=&#187;1_4,1_4,1_2&#8243; _builder_version=&#187;4.16&#8243; global_colors_info=&#187;{}&#187;][et_pb_column type=&#187;1_4&#8243; _builder_version=&#187;4.16&#8243; custom_padding=&#187;|||&#187; global_colors_info=&#187;{}&#187; custom_padding__hover=&#187;|||&#187;][et_pb_text _builder_version=&#187;4.27.4&#8243; text_font=&#187;Poppins||||||||&#187; header_font=&#187;Poppins||||||||&#187; header_4_font=&#187;Raleway|700|||||||&#187; header_4_font_size=&#187;22px&#187; header_4_line_height=&#187;1.4em&#187; custom_margin=&#187;||10px|&#187; global_colors_info=&#187;{}&#187;]<h4>Adresse<\/h4>[\/et_pb_text][et_pb_text _builder_version=&#187;4.27.4&#8243; text_font=&#187;Poppins||||||||&#187; text_line_height=&#187;1.6em&#187; global_colors_info=&#187;{}&#187;]<p>Obvious Works GmbH<br \/>Dammstrasse 16<br \/>CH-6300 Zug<br \/>Schweiz<\/p>\n<p>&nbsp;<\/p>[\/et_pb_text][\/et_pb_column][et_pb_column type=&#187;1_4&#8243; _builder_version=&#187;4.16&#8243; custom_padding=&#187;|||&#187; global_colors_info=&#187;{}&#187; custom_padding__hover=&#187;|||&#187;][et_pb_text _builder_version=&#187;4.27.4&#8243; header_font=&#187;||||||||&#187; header_4_font=&#187;Raleway|700|||||||&#187; header_4_font_size=&#187;22px&#187; header_4_line_height=&#187;1.4em&#187; custom_margin=&#187;||10px|&#187; global_colors_info=&#187;{}&#187;]<h4>Kontakt<\/h4>[\/et_pb_text][et_pb_text ul_type=&#187;none&#187; ul_item_indent=&#187;1px&#187; _builder_version=&#187;4.17.4&#8243; text_font=&#187;||||||||&#187; ul_font=&#187;Poppins||||||||&#187; ul_font_size=&#187;16px&#187; ul_line_height=&#187;2em&#187; global_colors_info=&#187;{}&#187;]<ul>\n<li><a href=\"https:\/\/www.obviousworks.ch\/kontakt\/\"><span>info[at]obviousworks.ch<\/span><\/a><br \/>(+41) 76 292 03 68<\/li>\n<\/ul>[\/et_pb_text][\/et_pb_column][et_pb_column type=&#187;1_2&#8243; _builder_version=&#187;4.16&#8243; custom_padding=&#187;|||&#187; global_colors_info=&#187;{}&#187; custom_padding__hover=&#187;|||&#187;][et_pb_signup provider=&#187;aweber&#187; aweber_list=&#187;My AWeber|6476098&#8243; use_custom_fields=&#187;on&#187; success_action=&#187;redirect&#187; success_redirect_url=&#187;https:\/\/www.obviousworks.ch\/typ-ush&#187; success_redirect_query=&#187;on|off|on|off|off&#187; title=&#187;User Story Hacks&#187; button_text=&#187;Anmelden&#187; description=&#187;<p>Melde dich jetzt f\u00fcr unseren Newsletter an und erhalte <span class=%22S1PPyQ%22>das Booklet mit den ultimativen Tipps &#038; Tricks f\u00fcr <\/span>erfolgreiche User Stories kostenlos.<\/p>&#187; module_id=&#187;newsletter_optin&#187; _builder_version=&#187;4.27.4&#8243; header_level=&#187;h3&#8243; header_font=&#187;Raleway|700|||||||&#187; header_font_size=&#187;22px&#187; header_line_height=&#187;1.4em&#187; body_font=&#187;Poppins||||||||&#187; body_line_height=&#187;1.8em&#187; result_message_font=&#187;Poppins||||||||&#187; result_message_text_color=&#187;#F67E28&#8243; use_background_color=&#187;off&#187; custom_button=&#187;on&#187; button_text_size=&#187;14px&#187; button_text_color=&#187;#F5FAFE&#187; button_bg_color=&#187;#F67E28&#8243; button_border_width=&#187;12px&#187; button_border_color=&#187;#F67E28&#8243; button_letter_spacing=&#187;2px&#187; button_font=&#187;Poppins|600||on|||||&#187; button_icon=&#187;&#x24;||divi||400&#8243; background_layout=&#187;light&#187; border_width_all_fields=&#187;1px&#187; border_color_all_fields=&#187;rgba(51,51,51,0.12)&#187; global_colors_info=&#187;{}&#187; button_text_size__hover_enabled=&#187;off&#187; button_one_text_size__hover_enabled=&#187;off&#187; button_two_text_size__hover_enabled=&#187;off&#187; button_text_color__hover_enabled=&#187;off&#187; button_one_text_color__hover_enabled=&#187;off&#187; button_two_text_color__hover_enabled=&#187;off&#187; button_border_width__hover_enabled=&#187;off&#187; button_one_border_width__hover_enabled=&#187;off&#187; button_two_border_width__hover_enabled=&#187;off&#187; button_border_color__hover_enabled=&#187;off&#187; button_one_border_color__hover_enabled=&#187;off&#187; button_two_border_color__hover_enabled=&#187;off&#187; button_border_radius__hover_enabled=&#187;off&#187; button_one_border_radius__hover_enabled=&#187;off&#187; button_two_border_radius__hover_enabled=&#187;off&#187; button_letter_spacing__hover_enabled=&#187;off&#187; button_one_letter_spacing__hover_enabled=&#187;off&#187; button_two_letter_spacing__hover_enabled=&#187;off&#187; button_bg_color__hover_enabled=&#187;off&#187; button_one_bg_color__hover_enabled=&#187;off&#187; button_two_bg_color__hover_enabled=&#187;off&#187;][et_pb_signup_custom_field field_id=&#187;1&#8243; field_title=&#187;utm_source&#187; field_type=&#187;input&#187; required_mark=&#187;off&#187; _builder_version=&#187;4.17.4&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187; predefined_field=&#187;1&#8243; hidden=&#187;on&#187;][\/et_pb_signup_custom_field][et_pb_signup_custom_field field_id=&#187;5&#8243; field_title=&#187;utm_campaign&#187; field_type=&#187;input&#187; required_mark=&#187;off&#187; _builder_version=&#187;4.17.4&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187; predefined_field=&#187;5&#8243; hidden=&#187;on&#187;][\/et_pb_signup_custom_field][et_pb_signup_custom_field field_id=&#187;4&#8243; field_title=&#187;utm_content&#187; field_type=&#187;input&#187; required_mark=&#187;off&#187; _builder_version=&#187;4.17.4&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187; predefined_field=&#187;4&#8243; hidden=&#187;on&#187;][\/et_pb_signup_custom_field][et_pb_signup_custom_field field_id=&#187;3&#8243; field_title=&#187;utm_term&#187; field_type=&#187;input&#187; required_mark=&#187;off&#187; _builder_version=&#187;4.17.4&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187; predefined_field=&#187;3&#8243; hidden=&#187;on&#187;][\/et_pb_signup_custom_field][et_pb_signup_custom_field field_id=&#187;2&#8243; field_title=&#187;utm_medium&#187; field_type=&#187;input&#187; required_mark=&#187;off&#187; _builder_version=&#187;4.27.0&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187; predefined_field=&#187;2&#8243; hidden=&#187;on&#187;][\/et_pb_signup_custom_field][et_pb_signup_custom_field field_id=&#187;6&#8243; field_title=&#187;utm_id&#187; field_type=&#187;input&#187; required_mark=&#187;off&#187; _builder_version=&#187;4.27.0&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187; predefined_field=&#187;6&#8243; hidden=&#187;on&#187;][\/et_pb_signup_custom_field][\/et_pb_signup][\/et_pb_column][\/et_pb_row][\/et_pb_section][et_pb_section fb_built=&#187;1&#8243; fullwidth=&#187;on&#187; _builder_version=&#187;4.17.4&#8243; _module_preset=&#187;default&#187; global_colors_info=&#187;{}&#187;][et_pb_fullwidth_menu menu_id=&#187;4&#8243; active_link_color=&#187;#52B4DB&#187; _builder_version=&#187;4.17.4&#8243; _module_preset=&#187;default&#187; menu_font=&#187;Poppins|600||on|||||&#187; menu_text_color=&#187;#FFFFFF&#187; background_color=&#187;#13658A&#187; text_orientation=&#187;center&#187; global_colors_info=&#187;{}&#187;][\/et_pb_fullwidth_menu][\/et_pb_section]\n","protected":false},"excerpt":{"rendered":"<p>Warum f\u00fchlt sich Claude Code bei den meisten Entwicklern nutzlos an? Weil die meisten nur 1 von 4 Layern konfigurieren. Sie laufen \/init, bekommen eine generische CLAUDE.md und wundern sich, warum Claude Datei-Strukturen halluziniert, falsche Libraries empfiehlt und den Coding-Stil verfehlt. Die Wahrheit: CLAUDE.md ist nur die erste von vier S\u00e4ulen. Das vollst\u00e4ndige Setup 2026 umfasst 5 Scopes, das WHAT\/WHY\/HOW Framework, 7 Kern-Regeln und Advanced Patterns mit Hooks, Skills und Multi-Session-Workflows. Wer das orchestriert, arbeitet mit einem AI-Teammate, der mit der Zeit besser wird. Wer es ignoriert, prompted sich im Kreis. Dieser Guide spiegelt exakt den Architecture Guide 2026, den ich als Cheat Sheet f\u00fcr Entwickler-Teams zusammengestellt habe. Konkret. Umsetzbar. In einem Nachmittag. Aber wirklich in kurzer Zeit! <div class=\"et_pb_module dsm_card dsm_card_0 et_clickable et_pb_bg_layout_dark  dsm_card_layout_stacked\">\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t<div class=\"et_pb_module_inner\">\n\t\t\t\t\t\n\t\t\t\n\t\t\t<figure class=\"dsm_card_image_wrapper dsm_card_badge_top_right\"><div class=\"dsm_card_image_background dsm_card_img\"><\/div><a href=\"https:\/\/www.obviousworks.ch\/download\/CLAUDE.md_Architecture_Guide_2026_ObviousWorks.pdf\" class=\"dsm_card_badge_text\">Claude Code Cheat Sheet 2026<\/a><\/figure>\n\t\t\t<div class=\"et_pb_module dsm_card_wrapper et_pb_text_align_left\">\n\t\t\t\t\t\n\t\t\t\t\t<h4 class=\"dsm_card_title et_pb_module_header\">Claude Code Architektur Cheat Sheet<\/h4>\n\t\t\t\t\t<div class=\"dsm_card_subtitle\">Jetzt kostenlos runterladen - lesen, verteilen und innerhalb kurzer Zeit agentisch Software entwickeln - Viel Spa\u00df<\/div>\n\t\t\t\t\t\n\t\t\t\t\t<div class=\"et_pb_button_wrapper\"><a class=\"et_pb_button et_pb_more_button \" href=\"https:\/\/www.obviousworks.ch\/download\/CLAUDE.md_Architecture_Guide_2026_ObviousWorks.pdf\" target=\"_blank\">Hier klicken &#038; kostenlos downloaden<\/a><\/div>\n\t\t\t\t<\/div>\n\t\t\t\n\t\t\t\t<\/div>\n\t\t\t<\/div>Was ist CLAUDE.md eigentlich \u2013 und warum ist es keine README? CLAUDE.md ist das persistente Ged\u00e4chtnis deines AI-Teammates. Sie wird bei jedem claude-Start geladen und definiert, wie Claude dein Projekt versteht. Eine README dokumentiert f\u00fcr Menschen. CLAUDE.md [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":987523647,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"on","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"categories":[32],"tags":[97,137,180,139,125,177,179,176,178,109,175],"class_list":["post-987523634","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ai","tag-agentic-coding","tag-ai-development","tag-anthropic","tag-boris-cherny","tag-claude-code","tag-claude-md","tag-compound-engineering","tag-hooks","tag-multi-session","tag-skills","tag-what-why-how-framework"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.4 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>CLAUDE.md richtig designen: Die 2026 Architektur, die Claude Code endlich funktionieren l\u00e4sst<\/title>\n<meta name=\"description\" content=\"Der komplette 2026 Guide f\u00fcr CLAUDE.md: 5 Scopes, WHAT\/WHY\/HOW Framework, 7 Regeln und Advanced Patterns mit Hooks, Skills und Multi-Session. Architektur statt Chaos.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.obviousworks.ch\/en\/designing-claude-md-right-the-2026-architecture-that-finally-makes-claude-code-work\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"CLAUDE.md richtig designen: Die 2026 Architektur, die Claude Code endlich funktionieren l\u00e4sst\" \/>\n<meta property=\"og:description\" content=\"Der komplette 2026 Guide f\u00fcr CLAUDE.md: 5 Scopes, WHAT\/WHY\/HOW Framework, 7 Regeln und Advanced Patterns mit Hooks, Skills und Multi-Session. Architektur statt Chaos.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.obviousworks.ch\/en\/designing-claude-md-right-the-2026-architecture-that-finally-makes-claude-code-work\/\" \/>\n<meta property=\"og:site_name\" content=\"Obvious Works\" \/>\n<meta property=\"article:published_time\" content=\"2026-04-17T12:50:47+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-04-17T12:52:40+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.obviousworks.ch\/wp-content\/uploads\/2026\/04\/ClaudeCodeCheatSheet2026-s2.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1226\" \/>\n\t<meta property=\"og:image:height\" content=\"462\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"obviousworks_boss\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"obviousworks_boss\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"14 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\\\/\"},\"author\":{\"name\":\"obviousworks_boss\",\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/#\\\/schema\\\/person\\\/c2c4552bf4b637b0762c2b518b63636b\"},\"headline\":\"CLAUDE.md richtig designen: Die 2026 Architektur, die Claude Code endlich funktionieren l\u00e4sst\",\"datePublished\":\"2026-04-17T12:50:47+00:00\",\"dateModified\":\"2026-04-17T12:52:40+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\\\/\"},\"wordCount\":3952,\"publisher\":{\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.obviousworks.ch\\\/wp-content\\\/uploads\\\/2026\\\/04\\\/ClaudeCodeCheatSheet2026-s2.jpg\",\"keywords\":[\"agentic coding\",\"AI Development\",\"Anthropic\",\"boris cherny\",\"Claude Code\",\"CLAUDE.md\",\"Compound Engineering\",\"Hooks\",\"Multi-Session\",\"skills\",\"WHAT WHY HOW Framework\"],\"articleSection\":[\"AI\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\\\/\",\"url\":\"https:\\\/\\\/www.obviousworks.ch\\\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\\\/\",\"name\":\"CLAUDE.md richtig designen: Die 2026 Architektur, die Claude Code endlich funktionieren l\u00e4sst\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.obviousworks.ch\\\/wp-content\\\/uploads\\\/2026\\\/04\\\/ClaudeCodeCheatSheet2026-s2.jpg\",\"datePublished\":\"2026-04-17T12:50:47+00:00\",\"dateModified\":\"2026-04-17T12:52:40+00:00\",\"description\":\"Der komplette 2026 Guide f\u00fcr CLAUDE.md: 5 Scopes, WHAT\\\/WHY\\\/HOW Framework, 7 Regeln und Advanced Patterns mit Hooks, Skills und Multi-Session. Architektur statt Chaos.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.obviousworks.ch\\\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.obviousworks.ch\\\/wp-content\\\/uploads\\\/2026\\\/04\\\/ClaudeCodeCheatSheet2026-s2.jpg\",\"contentUrl\":\"https:\\\/\\\/www.obviousworks.ch\\\/wp-content\\\/uploads\\\/2026\\\/04\\\/ClaudeCodeCheatSheet2026-s2.jpg\",\"width\":1226,\"height\":462,\"caption\":\"ClaudeCodeCheatSheet and all you need\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.obviousworks.ch\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"CLAUDE.md richtig designen: Die 2026 Architektur, die Claude Code endlich funktionieren l\u00e4sst\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/#website\",\"url\":\"https:\\\/\\\/www.obviousworks.ch\\\/\",\"name\":\"Obvious Works\",\"description\":\"Dein Partner f\u00fcr KI, Requirements &amp; Agilit\u00e4t\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.obviousworks.ch\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/#organization\",\"name\":\"Obvious Works\",\"url\":\"https:\\\/\\\/www.obviousworks.ch\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.obviousworks.ch\\\/wp-content\\\/uploads\\\/2023\\\/01\\\/cropped-9952_ObviousWorks_Logo_DA_01.png\",\"contentUrl\":\"https:\\\/\\\/www.obviousworks.ch\\\/wp-content\\\/uploads\\\/2023\\\/01\\\/cropped-9952_ObviousWorks_Logo_DA_01.png\",\"width\":2980,\"height\":1164,\"caption\":\"Obvious Works\"},\"image\":{\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/linkedin.com\\\/company\\\/obviousworks\"]},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/www.obviousworks.ch\\\/#\\\/schema\\\/person\\\/c2c4552bf4b637b0762c2b518b63636b\",\"name\":\"obviousworks_boss\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/87c044a8ef70725f45cd4b2c9c8a3978a0d195f587d69a8af9fe63cb57728c37?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/87c044a8ef70725f45cd4b2c9c8a3978a0d195f587d69a8af9fe63cb57728c37?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/87c044a8ef70725f45cd4b2c9c8a3978a0d195f587d69a8af9fe63cb57728c37?s=96&d=mm&r=g\",\"caption\":\"obviousworks_boss\"},\"sameAs\":[\"https:\\\/\\\/www.obviousworks.ch\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Designing CLAUDE.md correctly: The 2026 architecture that finally makes Claude code work","description":"The complete 2026 guide for CLAUDE.md: 5 scopes, WHAT\/WHY\/HOW framework, 7 rules and advanced patterns with hooks, skills and multi-session. Architecture instead of chaos.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.obviousworks.ch\/en\/designing-claude-md-right-the-2026-architecture-that-finally-makes-claude-code-work\/","og_locale":"en_US","og_type":"article","og_title":"CLAUDE.md richtig designen: Die 2026 Architektur, die Claude Code endlich funktionieren l\u00e4sst","og_description":"Der komplette 2026 Guide f\u00fcr CLAUDE.md: 5 Scopes, WHAT\/WHY\/HOW Framework, 7 Regeln und Advanced Patterns mit Hooks, Skills und Multi-Session. Architektur statt Chaos.","og_url":"https:\/\/www.obviousworks.ch\/en\/designing-claude-md-right-the-2026-architecture-that-finally-makes-claude-code-work\/","og_site_name":"Obvious Works","article_published_time":"2026-04-17T12:50:47+00:00","article_modified_time":"2026-04-17T12:52:40+00:00","og_image":[{"width":1226,"height":462,"url":"https:\/\/www.obviousworks.ch\/wp-content\/uploads\/2026\/04\/ClaudeCodeCheatSheet2026-s2.jpg","type":"image\/jpeg"}],"author":"obviousworks_boss","twitter_card":"summary_large_image","twitter_misc":{"Written by":"obviousworks_boss","Est. reading time":"14 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.obviousworks.ch\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\/#article","isPartOf":{"@id":"https:\/\/www.obviousworks.ch\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\/"},"author":{"name":"obviousworks_boss","@id":"https:\/\/www.obviousworks.ch\/#\/schema\/person\/c2c4552bf4b637b0762c2b518b63636b"},"headline":"CLAUDE.md richtig designen: Die 2026 Architektur, die Claude Code endlich funktionieren l\u00e4sst","datePublished":"2026-04-17T12:50:47+00:00","dateModified":"2026-04-17T12:52:40+00:00","mainEntityOfPage":{"@id":"https:\/\/www.obviousworks.ch\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\/"},"wordCount":3952,"publisher":{"@id":"https:\/\/www.obviousworks.ch\/#organization"},"image":{"@id":"https:\/\/www.obviousworks.ch\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\/#primaryimage"},"thumbnailUrl":"https:\/\/www.obviousworks.ch\/wp-content\/uploads\/2026\/04\/ClaudeCodeCheatSheet2026-s2.jpg","keywords":["agentic coding","AI Development","Anthropic","boris cherny","Claude Code","CLAUDE.md","Compound Engineering","Hooks","Multi-Session","skills","WHAT WHY HOW Framework"],"articleSection":["AI"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.obviousworks.ch\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\/","url":"https:\/\/www.obviousworks.ch\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\/","name":"Designing CLAUDE.md correctly: The 2026 architecture that finally makes Claude code work","isPartOf":{"@id":"https:\/\/www.obviousworks.ch\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.obviousworks.ch\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\/#primaryimage"},"image":{"@id":"https:\/\/www.obviousworks.ch\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\/#primaryimage"},"thumbnailUrl":"https:\/\/www.obviousworks.ch\/wp-content\/uploads\/2026\/04\/ClaudeCodeCheatSheet2026-s2.jpg","datePublished":"2026-04-17T12:50:47+00:00","dateModified":"2026-04-17T12:52:40+00:00","description":"The complete 2026 guide for CLAUDE.md: 5 scopes, WHAT\/WHY\/HOW framework, 7 rules and advanced patterns with hooks, skills and multi-session. Architecture instead of chaos.","breadcrumb":{"@id":"https:\/\/www.obviousworks.ch\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.obviousworks.ch\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.obviousworks.ch\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\/#primaryimage","url":"https:\/\/www.obviousworks.ch\/wp-content\/uploads\/2026\/04\/ClaudeCodeCheatSheet2026-s2.jpg","contentUrl":"https:\/\/www.obviousworks.ch\/wp-content\/uploads\/2026\/04\/ClaudeCodeCheatSheet2026-s2.jpg","width":1226,"height":462,"caption":"ClaudeCodeCheatSheet and all you need"},{"@type":"BreadcrumbList","@id":"https:\/\/www.obviousworks.ch\/claude-md-richtig-designen-die-2026-architektur-die-claude-code-endlich-funktionieren-laesst\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.obviousworks.ch\/"},{"@type":"ListItem","position":2,"name":"CLAUDE.md richtig designen: Die 2026 Architektur, die Claude Code endlich funktionieren l\u00e4sst"}]},{"@type":"WebSite","@id":"https:\/\/www.obviousworks.ch\/#website","url":"https:\/\/www.obviousworks.ch\/","name":"Obvious Works","description":"Your partner for AI, requirements &amp; agility","publisher":{"@id":"https:\/\/www.obviousworks.ch\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.obviousworks.ch\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.obviousworks.ch\/#organization","name":"Obvious Works","url":"https:\/\/www.obviousworks.ch\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.obviousworks.ch\/#\/schema\/logo\/image\/","url":"https:\/\/www.obviousworks.ch\/wp-content\/uploads\/2023\/01\/cropped-9952_ObviousWorks_Logo_DA_01.png","contentUrl":"https:\/\/www.obviousworks.ch\/wp-content\/uploads\/2023\/01\/cropped-9952_ObviousWorks_Logo_DA_01.png","width":2980,"height":1164,"caption":"Obvious Works"},"image":{"@id":"https:\/\/www.obviousworks.ch\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/linkedin.com\/company\/obviousworks"]},{"@type":"Person","@id":"https:\/\/www.obviousworks.ch\/#\/schema\/person\/c2c4552bf4b637b0762c2b518b63636b","name":"obviousworks_boss","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/87c044a8ef70725f45cd4b2c9c8a3978a0d195f587d69a8af9fe63cb57728c37?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/87c044a8ef70725f45cd4b2c9c8a3978a0d195f587d69a8af9fe63cb57728c37?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/87c044a8ef70725f45cd4b2c9c8a3978a0d195f587d69a8af9fe63cb57728c37?s=96&d=mm&r=g","caption":"obviousworks_boss"},"sameAs":["https:\/\/www.obviousworks.ch"]}]}},"_links":{"self":[{"href":"https:\/\/www.obviousworks.ch\/en\/wp-json\/wp\/v2\/posts\/987523634","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.obviousworks.ch\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.obviousworks.ch\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.obviousworks.ch\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.obviousworks.ch\/en\/wp-json\/wp\/v2\/comments?post=987523634"}],"version-history":[{"count":5,"href":"https:\/\/www.obviousworks.ch\/en\/wp-json\/wp\/v2\/posts\/987523634\/revisions"}],"predecessor-version":[{"id":987523646,"href":"https:\/\/www.obviousworks.ch\/en\/wp-json\/wp\/v2\/posts\/987523634\/revisions\/987523646"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.obviousworks.ch\/en\/wp-json\/wp\/v2\/media\/987523647"}],"wp:attachment":[{"href":"https:\/\/www.obviousworks.ch\/en\/wp-json\/wp\/v2\/media?parent=987523634"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.obviousworks.ch\/en\/wp-json\/wp\/v2\/categories?post=987523634"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.obviousworks.ch\/en\/wp-json\/wp\/v2\/tags?post=987523634"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}