Kieran Klaassen hat auf Every geschrieben: “The Folder Is the Agent.” Ich habe den Text nicht gelesen. Der Titel hat gereicht. Das mache ich seit Monaten so.

Ein Projektordner mit den richtigen Kontextdateien ist der Agent. Kein Framework. Kein Orchestrierungslayer. Kein Swarm. Markdown-Files, Skills, Kontext. Fertig.

Wie das aussieht

Ich betreue mehrere Kunden mit unterschiedlichen Stacks. Rails, n8n, Supabase, Shopify. Pro Kunde gibt es einen Ops-Ordner. Darin liegt ein AGENTS.md: Welche Repos gehören zum Projekt? Welche Skills werden benutzt? Wo wird deployed? Wie komme ich an die Datenbank?

Jeder Ordner hängt an einem Telegram-Topic. Ich öffne ein Topic, schreibe los. Der Agent weiss, worum es geht. Bugs fixen, Features planen, Daten abfragen. Jedes Topic zeigt auf einen anderen Ordner. Jeder Ordner ist ein Spezialist.

Das Muster ist immer gleich. Genau das macht es stark.

Spaziergang als Ops-Workflow

Letzte Woche. Draussen mit dem Hund. Push-Notification: Production-Fehler. Ich öffne Telegram, gehe ins richtige Topic, schicke eine Voice-Message: “Neuer Issue. Schau dir das an.”

Der Agent holt den GitHub-Issue, checkt das Repo, durchsucht den n8n-Workflow, zieht Daten aus der Datenbank. Feedback: “Problem liegt an X.”

Ich sage: “Klingt gut, mach das so.” Gelöst. Vom Spaziergang. Per Sprachnachricht.

Das funktioniert, weil der Ordner den Kontext hat. Nicht weil das Model schlau ist. Das Model ist austauschbar.

Skills sind die Atome

Über 100 Skills. Jeder eine kleine Fähigkeit: Supabase abfragen, n8n-Workflows anpassen, Deployments triggern, Tickets verwalten. Fast alle mit einer CLI dahinter. Unter 60 Zeilen pro Skill-Datei. Schlank.

Progressive Disclosure: Das AGENTS.md bleibt high-level. Referenzen zeigen auf tiefere Files. “Wenn es um Thema X geht, lies dieses Dokument.” Der Agent lädt nur, was er braucht.

Mit guten Skills funktionieren auch günstige Models. Ich arbeite viel mit KIMI. Schneller als die grossen Models, stark im Tool-Calling. Der Skill sagt, was zu tun ist. Die CLI führt es aus. Das Model muss nicht brillant sein. Es muss zuhören und die richtigen Tools aufrufen.

Skills machen das Model zum Spezialisten. Nicht andersrum.

Warum Swarms Zeitverschwendung sind

Kieran hat drei Monate Agent-Swarms ausprobiert. Ich nie. Nicht weil ich schlauer bin. Ich fand es unnötig.

Swarms haben keine Sichtbarkeit. 10 Agents arbeiten parallel, du sitzt oben drauf. Klingt gut. Aber wenn die fertig sind, hast du 10 Ergebnisse ohne Kontext. Und wenn vorne irgendwas schiefgeht, wird der Garbage mit jedem Schritt grösser.

Kennt man von n8n. Alle haben ihre riesigen Workflow-Bilder gepostet. Zigtausend Nodes. Sieht beeindruckend aus. Verwalten kann das keiner.

Ich liefere die Arbeit aus. Nicht der Swarm. Ich brauche einen QA-Pass. Ich muss die Business-Logik verstehen. Implementierungen delegieren, klar. Aber ich muss wissen, was abgeht.

“Der Agent hat es falsch gemacht” ist keine Aussage. Das ist wie einen Praktikanten einstellen und nie draufgucken. Du musst sehen, was der macht. Du musst in the Loop sein. Sonst bist du der, der nicht mehr mitreden kann, weil er keinen Kontext mehr hat.

Ownership ist kein Nice-to-have. Ownership ist der Punkt.

Ich bin schnell genug. Sub-Agents, Compounding durch Skills, parallele Sessions. Alles kommt zurück zu: richtiger Prompt, richtige Skills, richtiges Model. Swarms lenken davon ab.

Was schiefgeht

Agents sind manchmal zu übereifrig. Ich baue Bias to Action in meine Prompts. Dann sagst du “Lass uns planen” und die bauen dir gleich was.

Einmal hat ein Agent über meinen Freshdesk-Skill eine Kundennachricht verschickt. Danach habe ich Write-Operationen auf CLI-Ebene verboten.

Einmal hat ein Agent behauptet, Google Maps Free Credits decken das ab. Einen Monat später: 300 Dollar Rechnung. Danach Limits eingebaut.

Du baust nicht alle Guardrails vorher. Du wartest auf die Failure Mode und sicherst danach ab. Wie Softwareentwicklung. Nichts Agent-Spezifisches.

Was hilft: Prinzipien. Klare Architektur für Skills. Konventionen für AGENTS.md-Files. Regelmässig aufräumen. Sonst wächst das unkontrolliert.

Wie du anfängst

Schau dir deinen Workflow an. Brich ihn runter. Wo würdest du jemanden einstellen?

Ein Marketing-Agent mit Kontext zu Blog, X-Profil, Roadmap. Gib dem einen Skill für Typefully und er kann Posts schedulen. Gib ihm einen Analytics-Skill und er sieht, was performed.

Fang mit einem Workflow an. Mach bewusst, was du manuell machst. Digitalisiere es. Standardisiere es als Skill. Pack es in einen Ordner mit Kontext.

Wenn der Agent Mist baut: Skill-Issue. Fehlender Kontext oder fehlender Skill. Beides lösbar. Wird mit der Zeit besser. Wie ein neuer Mitarbeiter.

Digitalisiere deinen Workflow, damit du ihn standardisieren kannst. Dafür musst du deinen Prozess erstmal kennen.

Der Ordner

OpenClaw ist ein Ordner. Claude Code mit CLAUDE.md ist ein Ordner. Jedes Agent-Framework: ein Workspace mit Personality-Files, Memory, Skills.

Mehr Struktur im Ordner heisst bessere Navigation für den Agent. Du brauchst kein Framework. Ein AGENTS.md, ein paar Skills, Disziplin beim Aufräumen.

Der Rest ist Compounding. Jeder Fehler verbessert einen Skill. Jedes Projekt macht den Ordner schlauer.

Aber nie komplett Hands-Off. Das ist der Punkt.