Letzte Woche las ich über eine KI, die einen Impfstoff gegen Coronaviren entwickelt hat, denen wir noch nicht einmal begegnet sind (ScienceDaily). Cambridge führte die erste Humanstudie durch, und 39 Freiwillige erhielten das Antigen.
Es ist verrückt zu denken, dass ein Algorithmus die gesamte genetische Familie eines Virus analysiert und einen Schutz gegen Mitglieder entwickelt hat, die noch in Tieren zirkulieren und darauf warten, auf den Menschen überzuspringen. Aber wenn ich ihn bitte, mein aktuelles Briefing aus einer Liste von Dokumenten zu holen, kann er fast zwei Minuten damit verbringen, die falschen Dateien in meiner Ablage zu öffnen, nur um mir ein Briefing von vor drei Monaten zu zeigen.
Und ich weiß, dass Cambridge eine maßgeschneiderte KI verwendet, aber was ich Ihnen zeigen möchte, ist, dass die Lücke zwischen dem, was KI kann, und dem, was ein Setup ihr ermöglicht, der entscheidende Faktor für Ihren Workflow und Ihre Produktivität ist.
Ich habe bis vor kurzem nie absichtlich ein Gerüst gebaut. Es hat sich nach und nach um den Agenten herum angesammelt, Ordner für Ordner, bis der Agent sich in einem Chaos verirrt hat, das ich selbst geschaffen hatte.
Also habe ich einen Tag damit verbracht, jeden Fehler zu timen, und ein Muster zeigte sich. In dieser Ausgabe zeige ich Ihnen, warum Ihr Agent immer wieder an den einfachen Dingen scheitert, während die Welt ihn als Genie bezeichnet, und die Lösung, die ihn wieder auf Ihre Seite bringt.
In diesem Beitrag:
- Die Ordnerstruktur hat meinen Agenten im Stich gelassen, weil meine Ordner so organisiert waren, wie ich denke, und nicht so, wie ein Agent navigiert
- Eine Indexdatei im Stammverzeichnis jedes Hauptordners verwandelte langsame Suchvorgänge in dreißig-Sekunden-Lesevorgänge
- Das unsichtbare Gerüst um Ihren Agenten herum ist wichtiger als die Fähigkeit des Agenten selbst, und hier erfahren Sie, wie Sie es aufbauen
- Ein Diagnosetest, den Sie in fünf Minuten durchführen können, um zu sehen, ob Ihre Ordnerstruktur das eigentliche Problem ist
Die Struktur, die Ihr Agent nicht sehen kann
Ich habe meine Ablage so organisiert, wie die meisten Leute es tun. Artikel, Recherchen, Assets, Strategiedokumente – jedes bekam seinen eigenen Ordner. Diese Struktur fühlte sich sauber an, weil ich in Inhaltstypen denke. Ordner entsprechen meinen Kategorien, und ich muss nie darüber nachdenken, wo ich suchen muss. Entwürfe sind Artikel, Notizen sind Recherchen, das Ablagesystem läuft auf Autopilot.
Aber ein Agent denkt nicht in Kategorien. Wenn ich Hermes bitte, einen Produktlaunch zu planen, zieht die Aufgabe Strategienotizen, Markenrichtlinien und frühere Launches aus verschiedenen Ordnern heran.
Diese Kontextteile befinden sich in meiner Inhaltstyp-Struktur an verschiedenen Orten. Mein Agent muss jedes Mal überall suchen, ohne zu wissen, welcher Entwurf aktuell und welcher archiviert ist oder welche Recherchenotiz von diesem Monat und welche von vor sechs Monaten stammt.
Die Organisation nach Inhaltstyp funktioniert perfekt für Menschen. Sie haben Ihr ganzes Leben lang Dinge unter Kategorien abgelegt, und Ihr Gehirn erledigt die Querverweise automatisch. Es ist nur natürlich zu erwarten, dass KI genauso funktioniert, obwohl ein Agent diese Querverweise tatsächlich manuell durchführen muss, und genau hier bricht die Struktur zusammen.
Die Struktur um Ihren Agenten herum leistet mehr Arbeit als die Fähigkeit des Agenten selbst.
Sobald ich das Muster sah, war die Ursache offensichtlich: Ich hatte meine Ablage für ein menschliches Gehirn gebaut, das sich merkt, wo Dinge sind, und sie dann einem Agenten übergeben, der jedes Mal von Grund auf neu suchen muss, und das legte das eigentliche Problem unter dem Ordnerchaos offen.
Ein Suchender braucht eine Karte, denn ohne sie tappt der Agent im Dunkeln und behandelt jede Datei so, als könnte sie die Antwort sein.
Wofür die Fähigkeit verschwendet wird
Hermes öffnete ständig einen Haufen Dateien, bevor er auf die richtige stieß, oder griff auf eine archivierte Version zu, während die aktuelle Datei woanders lag. Schlimmer noch, er fragte, welche Datei er verwenden solle, obwohl die Antwort aus dem Kontext hätte klar sein müssen. Dies geschah mit jedem Modell, das ich verwendete, einschließlich Opus, GPT 5.5, Qwen und GLM.
Das Muster wiederholte sich, und ich musste zusehen, wie sich dieselben langsamen Suchvorgänge bei Aufgabe um Aufgabe abspielten.
Obwohl mein Agent fähig genug war, Dinge zu finden, war die Ordnerstruktur zum Hauptengpass geworden, bevor er überhaupt zur eigentlichen Arbeit kam.
Ich erreichte den Bruchpunkt an dem Tag, als ich die Fehler timte. Ich verfolgte, wie viele Dateien Hermes öffnete, bevor er die richtige erreichte, und wie lange er brauchte, um dorthin zu gelangen. Fünf häufige Aufgaben sahen so aus, bevor ich etwas änderte.
Bevor ich etwas änderte:
- Das aktuelle Artikel-Briefing finden: 7 Dateien geöffnet, 2:00 bis zur richtigen Datei;
- Markenfarbdefinitionen finden: 5 Dateien geöffnet, es dauerte 1:12;
- Die Artikelwarteschlange für die Planung nachschlagen: 4 Dateien geöffnet, es dauerte 0:48;
- Frühere Artikel zum gleichen Thema finden: 6 Dateien geöffnet, es dauerte 1:36;
- Die Werbestrategie für einen Launch abrufen: 3 Dateien geöffnet, es dauerte 0:34.
Ein grober Versuch, also behandeln Sie die genauen Zahlen als Richtwerte.
Jede Aufgabe durchquerte mehrere Ordner. Die meisten öffneten archivierte Versionen, bevor sie die aktiven fanden. Mein Agent verschwendete seine Fähigkeiten mit der Navigation, anstatt seine Arbeit zu erledigen. Ein Launch-Plan benötigte drei Dateien, die in drei verschiedenen Ordnern lagen, und ich sah zu, wie er drei falsche Versuche unternahm, bevor er die richtigen fand.
Ein Agent, der Artikel schreibt, codiert und plant, sollte nicht die meiste Zeit damit verbringen, Dinge zu suchen.
Der kleinste Käfig, der funktioniert
Ein Ordner pro Bereich, nummeriert für die Reihenfolge, mit einer INDEX.md im Stammverzeichnis, die alles abbildet. Das ist die ganze Lösung, und die Details stecken in drei Regeln, die zusammenwirken.
INDEX.md im Stammverzeichnis jedes Hauptordners ist eine Karte. Sie listet jeden Unterordner und jede kanonische Datei auf, plus wo mein Agent beginnen soll. Mein Agent liest dies zuerst und weiß, was drin ist, bevor er etwas anderes anfasst. Betrachten Sie es als eine weiche Genehmigungspforte, bei der der Agent nicht mit der Arbeit beginnen darf, bis er weiß, womit er arbeitet.
Meine Markenordnerstruktur sieht nach der Reorganisation so aus.
105.Brand/2├── INDEX.md3├── 01.Brand System/4├── 02.Editorial Strategy/5├── 03.Promotion/6├── 04.Public Deliverables/7├── 05.Operating Plan/8└── 06.Archived/
Diese Struktur organisiert nach Bereichen statt nach Inhaltstyp. Jeder Bereich bekommt seinen eigenen Ordner, sodass Markenarbeit bei der Markenarbeit bleibt und Strategie bei der Strategie. Mein Agent überschreitet keine Grenzen auf der Suche nach etwas, das nicht dorthin gehört.
Nummern auf Ordnern machen die Lesereihenfolge explizit, anstatt sich auf die alphabetische Sortierung zu verlassen. 01. Brand System wird vor 02. Editorial Strategy gelesen. Mein Agent rät nicht. Nummern innerhalb von Ordnern machen dasselbe für Dateien, sodass mein Agent weiß, dass 01. Articles der Ausgangspunkt vor 02. Previous Articles ist.
Ich führe Ordnernamen mit einer Zahl an, weil es für mich auch einfacher zu merken ist.
So bleibt mein gesamter $30 Hermes-Stack einfach zu handhaben und bewegt sich durch Dutzende von Ordnern, ohne dass mein Agent jemals die Orientierung verliert.
Archiviertes Zeug lebt in 06.Archived, wo alte Briefings und ausgemusterte Pläne darauf warten. Mein Agent weiß, dass er dort nicht suchen muss, es sei denn, ich frage explizit nach historischem Kontext. Diese Trennung hält die aktiven Ordner sauber und die Suchvorgänge schnell.
Sobald meinem Agenten gesagt wurde, diese Grenze standardmäßig nicht zu überschreiten, lief jede Aufgabe innerhalb der aktiven Ordner schneller.
Meine INDEX.md sieht so aus.
1# Markenindex23Dieser Ordner enthält das aktuelle Markensystem.45## Ordnerübersicht67| Ordner | Zweck | Aktualisiert |8|---|---|---:|9| `01.Brand System/` | Visuelle Identität, Themenspektrum, Stimme | 2026-06-11 |10| `02.Editorial Strategy/` | Artikelausrichtung, Titelregeln, Warteschlange | 2026-06-11 |11| `03.Promotion/` | Launch-, Vertriebs-, Tool-Strategie | 2026-06-11 |1213## Kanonische Dateien1415| Datei | Zweck |16|---|---|17| `01.Brand System/01. Brand System.md` | Visuelle Identität, Farben, Typografie |18| `02.Editorial Strategy/01. Articles.md` | Artikelwarteschlange, Titelregeln |1920## Wohin gehen2122- Beginnen Sie mit `01.Brand System/04. Direction.md` für die Mission23- Verwenden Sie `02.Editorial Strategy/01. Articles.md` für die Artikelauswahl
INDEX.md durchlief drei Versionen. Meine erste Version listete jede einzelne Datei im Markenordner auf und umfasste vierzig Zeilen. Sie war technisch vollständig, aber mein Agent musste sie jedes Mal parsen, und die Länge war ein eigener Overhead. Meine zweite Version war zu kurz, etwa fünfzehn Zeilen, und mein Agent stellte immer noch Fragen, die ich nicht beantwortet hatte. Diese dritte Version listet nur Unterordner und kanonische Dateien auf, mit einem kurzen Abschnitt „Wohin gehen“, der meinem Agenten seine Startpunkte mitteilt.
Wenn ich meinen Agenten bitte, die Werbestrategie für einen Launch abzurufen, liest er 05.Brand/INDEX.md, öffnet 03.Promotion/01. Promotion Strategy.md und macht sich an die Arbeit. Die Zeiten nach der Reorganisation sehen so aus.
Nach der Reorganisation:
- Das aktuelle Artikel-Briefing finden: 1 Datei geöffnet, 0:10
- Markenfarbdefinitionen finden: 3 Dateien geöffnet, 0:22
- Die Artikelwarteschlange für die Planung nachschlagen: 1 Datei geöffnet, 0:10
- Frühere Artikel zum gleichen Thema finden: 2 Dateien geöffnet, 0:18
- Die Werbestrategie für einen Launch abrufen: 1 Datei geöffnet, 0:12
Die langsamste Aufgabe sank von 2 Minuten auf 26 Sekunden, und die schnellsten Durchläufe landeten bei etwa 10 Sekunden. Mein Agent öffnet die INDEX.md, folgt dem benötigten Startpunkt und macht sich ohne Umwege an die Arbeit. Auf der Seite meines Agenten hat sich keine Fähigkeit geändert. Die Ordnerstruktur hörte auf, den Großteil davon zu verschwenden, bevor die Aufgabe überhaupt begann.
Die Ordnerstruktur ist ein Käfig, den ich gebaut habe und der die Bewegung meines Agenten einschränkt, ohne einzuschränken, was mein Agent tun kann. Innerhalb des Käfigs läuft mein Agent frei. Ohne ihn neigt Hermes dazu, abzuschweifen, und ich muss meine Zeit damit verschwenden, ihn auf die richtige Datei hinzuweisen.
Der Wechsel zu Hermes ermöglichte es mir, diese Art von System für Dateien, Anbieter und Speicher gleichzeitig aufzubauen, und das INDEX.md-Muster ist das kleinste Stück, das im täglichen Gebrauch den größten Unterschied gemacht hat.
Jeder Käfig hat ein Schloss
Mein erster Fehler war, INDEX.md in jeden Unterordner einzufügen. Zu viele Karten bedeuten, dass mein Agent seine Zeit damit verbringt, Indizes zu lesen, anstatt zu arbeiten. Ich behalte INDEX.md nur im Stammverzeichnis der Hauptordner wie Brand und Editorial Strategy, wo es genug Unterordner gibt, die eine Karte benötigen. Innerhalb eines kleinen Unterordners mit vier oder fünf Dateien navigiert Hermes direkt, ohne jede Karte.
Bedenken Sie, dass die Nummerierung mühsam wird, wenn Sie neue Ordner hinzufügen. Ich muss entscheiden, wo ein neuer Ordner in die Reihenfolge passt, und manchmal hänge ich ihn am Ende an, anstatt alles neu zu nummerieren. Das ist in Ordnung. Nummern müssen nicht perfekt sein, solange sie richtungsweisend sind. Perfekt geordnete Ordner sind nicht das Ziel, und sie als solches zu behandeln, verwandelt eine praktische Lösung in ein kosmetisches Projekt.
Ein größerer Fehler ist es, eine Struktur aufzubauen, bevor Ihr Agent Verwirrung zeigt. Die meisten Leute überengagieren ihr Agenten-Setup, weil sie denken, es brauche eine ordentliche Infrastruktur.
Meine aktuelle Regel folgt dem gleichen Prinzip wie die Wahl zwischen MCPs, CLIs oder Ihrem eigenen Tool. Sie verwendet die kleinste Schnittstelle, die die Arbeit erledigt. Fügen Sie Struktur nur hinzu, wenn Ihr Agent sich verirrt, und fügen Sie nur genug Struktur hinzu, um genau dieses Problem zu beheben.
Ein weiterer Fehler, den ich gemacht habe, war das Verschachteln von Struktur in Struktur. Ich fügte Unterordner in Unterordnern hinzu, um alles perfekt zu kategorisieren, was eine zweistufige Hierarchie in eine fünfstufige verwandelte. Mein Agent musste dann mehrere INDEX-Dateien lesen und mehrere Nummerierungssequenzen parsen, um eine einzige Datei zu erreichen. Ich habe diese zusätzlichen Ebenen wieder in flache Unterordner aufgelöst, und die Navigation wurde wieder schneller.
Tiefe ist der Feind des schnellen Dateizugriffs, und die meisten Reorganisationen fügen Tiefe hinzu, weil sie denken, es sei Präzision.
Messen Sie, bevor Sie reorganisieren
Bevor Sie auch nur einen Ordner anfassen, führen Sie diesen Test mit drei realen Aufgaben durch, die Ihr Agent am häufigsten erledigt. Timen Sie jede und notieren Sie, wie viele Dateien er öffnet, bevor er die richtige findet. Verfolgen Sie, wie oft er die falsche Datei auswählt oder anhält, um Sie zu fragen, welche er verwenden soll.
Jede Aufgabe, die Ihren Agenten länger als dreißig Sekunden kostet oder drei oder mehr falsche Dateien öffnet, deutet auf einen Ordner hinter dieser Aufgabe hin, der kaputt ist.
Wählen Sie den einen Fehler aus, der am häufigsten auftritt. Öffnen Sie diesen Ordner und schreiben Sie eine INDEX.md, die jeden Unterordner und jede wichtige Datei auflistet, plus wo Ihr Agent beginnen soll. Speichern Sie sie. Führen Sie dieselbe Aufgabe erneut aus.
Wenn Ihr Agent die richtige Datei in unter dreißig Sekunden findet, hat die Lösung funktioniert, und Sie kennen jetzt das Muster. Wenden Sie es auf den nächsten defekten Ordner an. Wenn es immer noch fehlschlägt, liegt das Problem wahrscheinlich an der Nummerierung oder am Prinzip „ein Bereich pro Ordner“, und das sind die nächsten beiden Dinge, die zu beheben sind.
Beginnen Sie mit dem einen Ordner, der die meiste Zeit verschwendet, beheben Sie ihn und gehen Sie erst zum nächsten über, wenn Sie bereit sind.
Wo die Gitterstäbe sich noch biegen
Archivierte Inhalte werden manchmal noch referenziert, wenn ich ein altes Briefing für den Kontext brauche. Mein Agent muss wissen, dass er in 06.Archived statt in den aktiven Ordnern suchen muss, und ich erwähne dies in der INDEX.md, damit er weiß, wo historisches Material lebt. Ohne diesen Hinweis nimmt mein Agent an, dass archivierte Inhalte nicht existieren.
Außerdem verursacht Obsidian Sync gelegentlich Probleme, wenn es nicht sauber zwischen den Geräten abgleicht. Wenn ich eine Datei auf meinem Laptop aktualisiere, die ältere Version aber noch auf meinem VPS liegt, lädt Hermes die VPS-Kopie und behandelt sie als aktuelle Quelle der Wahrheit. Das ist eher ein Sync-Problem als ein Ordnerstruktur-Problem, aber es zeigt sich innerhalb des Ordnersystems, weil der Agent nur die Dateien sieht, die vor ihm liegen.
Die Nummerierung bricht zusammen, wenn Sie so viele Ordner haben, dass die Reihenfolge bedeutungslos wird. Ab mehr als zehn oder zwölf nummerierten Elementen auf einer Ebene werden die Nummern willkürlich.
Ich versuche, die Hauptkategorien unter dieser Schwelle zu halten und tiefere Strukturen stattdessen darin zu verschachteln, anstatt die oberste Ebene zu erweitern.
Umbenennungen sind eine weitere Reibungsquelle. Wenn ich reorganisiere, benenne ich manchmal Ordner um, um sie besser an ihren Zweck anzupassen, und jeder INDEX.md-Verweis auf den alten Namen ist kaputt, bis ich ihn aktualisiere. Ich versuche jetzt, Ordnernamen einmal festzulegen und sie in Ruhe zu lassen, denn ein leicht ungeschickter Name ist billiger als ein kaputter Verweis.
Diese Struktur funktioniert am besten für inhaltsintensive Workflows und planungsintensive Workflows. Reine Code- oder datenintensive Setups benötigen möglicherweise völlig andere Organisationsprinzipien, und das INDEX.md-Muster löst nicht jedes Navigationsproblem.
Alles, worüber ich in diesem Artikel geschrieben habe, führt auf einen Instinkt zurück. Besitzen Sie die Ebene, die zählt. Ich habe meinen Stack so gebaut, dass kein Unternehmen meine Tools kontrolliert. Ich habe meine Ablage so gebaut, dass kein Chaos meinen Agenten kontrolliert. Gleiches Prinzip von Anbietern über Ordner bis hin zu dem, was als Nächstes kommt.
Fähigkeit ist billig, wenn das Gerüst darum herum kaputt ist. Bauen Sie das Gerüst, und die Fähigkeit regelt sich von selbst. Eine Indexdatei und ein paar Zahlen vor Ihren Ordnernamen sind der Unterschied zwischen einem Agenten, der umherirrt, und einem Agenten, der funktioniert.
Wenn das nützlich war – folgen Sie @wandermist für weitere Inhalte wie diesen!
