Jean Pierre Kolb

Meine Fachgebiete sind Design & Entwicklung, TYPO3, Drupal & WordPress, Marketing, SEO & SEA, OSX & iOS, Linux, Server, Netzwerke, Sicherheit und Datenschutz.

[Nainsi Dwivedi @NainsiDwiv50980]

Most people think using Claude Code is about writing better prompts.

It’s not.

The real unlock is structuring your repository so Claude can think like an engineer.

If your repo is messy, Claude behaves like a chatbot.

If your repo is structured, Claude behaves like a developer living inside your codebase.

Your project only needs 4 things:

• the why → what the system does
• the map → where things live
• the rules → what’s allowed / forbidden
• the workflows → how work gets done

I call this:

The Anatomy of a Claude Code Project 👇

━━━━━━━━━━━━━━━

1️⃣ CLAUDE.md = Repo Memory (Keep it Short)

This file is the north star for Claude.

Not a massive document.

Just three things:

• Purpose → why the system exists
• Repo map → how the project is structured
• Rules + commands → how Claude should operate

If CLAUDE.md becomes too long, the model starts missing critical signals.

Clarity beats size.

━━━━━━━━━━━━━━━

2️⃣ .claude/skills/ = Reusable Expert Modes

Stop repeating instructions in prompts.

Turn common workflows into reusable skills.

Examples:

• code review checklist
• refactoring playbook
• debugging workflow
• release procedures

Now Claude can switch into specialized modes instantly.

Result:

More consistent outputs across sessions and teammates.

━━━━━━━━━━━━━━━

3️⃣ .claude/hooks/ = Guardrails

Models forget.

Hooks don’t.

Use hooks for things that must always happen automatically.

Examples:

• run formatters after edits
• trigger tests after core changes
• block sensitive directories (auth, billing, migrations)

Hooks turn AI workflows into reliable engineering systems.

━━━━━━━━━━━━━━━

4️⃣ docs/ = Progressive Context

Don’t overload prompts with information.

Instead, let Claude navigate your documentation.

Examples:

• architecture overview
• ADRs (engineering decisions)
• operational runbooks

Claude doesn’t need everything in memory.

It just needs to know where truth lives.

━━━━━━━━━━━━━━━

5️⃣ Local CLAUDE.md for Critical Modules

Some areas of your system have hidden complexity.

Add local context files there.

Example:

src/auth/CLAUDE.md
src/persistence/CLAUDE.md
infra/CLAUDE.md

Now Claude understands the danger zones exactly when it works in them.

This dramatically reduces mistakes.

━━━━━━━━━━━━━━━

Here’s the shift most people miss:

Prompting is temporary.

Structure is permanent.

Once your repository is designed for AI:

Claude stops acting like a chatbot...

…and starts behaving like a project-native engineer. 🚀

[ifun.de Schlagzeilen @ifun_news]

eufyMake E1: Der kompakte UV-Drucker startet auf Kickstarter https://t.co/u5idnz0veQ

[Troy Hunt @troyhunt]

I'm in the process of verifying a data breach attributed to "Hopamedia" and thought I'd tweet out and ask for help as I've *no* idea what that service is. Tried to find a sample record to send, and... dammit!

[heise online @heiseonline]

Superkondensator: MIT speichert Energie in Zement, Wasser und Industrieruß https://t.co/nhnhNJ85vH #Energie #MIT

[heise online @heiseonline]

Open-Source-Firewall OPNsense in neuer Version erschienen https://t.co/bmmpMBfgAK #Firewall #Security #Updates

[ifun.de Schlagzeilen @ifun_news]

Amazon Fire TV: Ambient TV erhält „Dynamische Kunst“ https://t.co/8mOWdRuEZE

[WinFuture.de @WinFuture]

Der #Windows11-Zug verliert an Fahrt. Ein Großteil der Nutzer bleibt bei Windows 10, wahrscheinlich bis zum bitteren Ende 2025. https://t.co/8AqucFlqHb

[heise online @heiseonline]

CAOS: BSI prüft Open-Source-Projekte, findet Lücken bei Videokonferenz-Tools​ https://t.co/2qVEK8LEH8 #BSI #Security #LinuxundOpenSource #Sicherheitslücken

[Golem.de @golem]

Bimi: Google wechselt Authentifizierung nach E-Mail-Spoofing #GMail https://t.co/udqLm8hofT

[heise Developer @heisedc]

Nur 512 Byte: Dieser #C-Compiler passt in einen Bootsektor

Ein Entwickler hat einen C-Compiler geschrieben, der in den #Bootsektor eines x86-Computers passt. Was der kleine #Compiler alles kann. @maltekir @heiseonline @iXmagazin #Developer #programmieren

https://t.co/QdJrvJEdM8

[WinFuture.de @WinFuture]

Elon #Musk spielt sich gern als Verfecheter der Redefreiheit auf. In der Praxis bei #Twitter zeigt sich nun aber, dass er beim kleinsten Gegenwind einknickt und das Geld dann doch sehr viel wichtiger ist. https://t.co/Z2rMVkuLvT

[Golem.de @golem]

Wayland: Asahi-Linux warnt vor Nutzung von X11 #AsahiLinux https://t.co/fcTaPxW8Ok

[WinFuture.de @WinFuture]

Der Bundesgerichtshof #BGH hat eine Klausel in den Allgemeinen Geschäftsbedingungen des Mobilfunkanbieters #O2 gekippt: https://t.co/J7EI5yuKCB

[Golem.de @golem]

Text- und Bilderstellung: #Meta führt generative #KI-Funktionen für Werbetreibende ein #Werbung https://t.co/LaAieNQKyD

[heise Security @heisec]

Kritische Lücken in Canon-Druckern ermöglichen Codeschmuggel https://t.co/FeB25amcDZ #CanonDrucker #Sicherheitsupdates

[Appgefahren @appgefahren]

appNews: Twitter: Elon Musk hat einen neuen CEO gefunden https://t.co/ttZU9Mgzxl

[heise online @heiseonline]

Mini-AKW: Westinghouse strebt Zulassung für Small Modular Reactor an https://t.co/WRjssxjBgG #Atomkraft #Energie

[heise online @heiseonline]

Die EU will es einheitlich und Apple will angeblich (wieder) einen eigenen Weg gehen. 🤷‍♂️🤷‍♀️

Nun hat die EU-Kommission aber Apple gewarnt, dass Einschränkungen im Zusammenspiel mit Ladegeräten nicht erlaubt sind❗ Zum Artikel: https://t.co/WbtWzLoYD7

[TYPO3 Project @typo3]

New updates for #TYPO3 v11.5.27 and v12.4.1 LTS have been released!
These versions contain bug fixes only.
Find the details in the Release Notes 👇👇
https://t.co/QZ3IdoFn37

#CMS #WeLoveTYPO3 #OpenSource