--- title: "Die Agent Files — die komplette Übersicht darüber, was zu tun ist, bevor du deinen ersten Agenten baust." description: "Der komplette Ordner vor dem ersten Agenten: der Dateibaum, alle 20 Prompts zum Copy-Pasten, und drei Regeln, damit es kein Junk-Drawer wird." category: guides date: 2026-08-26 canonical: https://thanisch.co/wissen/guides/agent-files url: https://thanisch.co/wissen/guides/agent-files --- # Die Agent Files — die komplette Übersicht darüber, was zu tun ist, bevor du deinen ersten Agenten baust. - Warum die Struktur vor dem ersten Agenten kommt - Den kompletten Dateibaum, wie er auf der Platte sitzt - Einen Copy-Paste-Prompt für jedes der 20 Teile - Drei Regeln, die den Ordner sechs Monate später noch nützlich halten > **Kurz gesagt** > Ein Agent ohne Ordner hat kein Gedächtnis. Ohne Gedächtnis startet jede Session bei null — und jede Antwort kommt generisch zurück. *Dateien, nicht Chats.* Die meisten bauen einen Agenten, indem sie ihn etwas tun lassen. Deshalb bleibt nichts hängen. Der Ordner ist nicht die Admin-Arbeit vor dem spannenden Teil. Der Ordner ist der Grund, warum der Agent sich lohnt. Der Aufbau folgt dem Agent-Files-Guide von Actionable AI: zwanzig Teile, ein Prompt nach dem anderen. Die Dateinamen bleiben Englisch — `CLAUDE.md`, `my-brain`, `business.md` — weil Claude, Obsidian und GitHub so damit arbeiten. ### 1. Dateien, nicht Chats Einmal aufschreiben, für immer nutzen. Der Agent liest denselben Ordner, bevor er für dich arbeitet. ### 2. Ein Prompt, ein Teil Jedes Stück unten ist ein Prompt. Nacheinander, nicht als Paket. ### 3. Unter zwei Minuten Die meisten Teile dauern kürzer als ein Kaffee. Das Interview ist die Ausnahme — und der größte Hebel. - Alle zwanzig Prompts auf einmal pasten - Die fünf Kontextdateien überspringen, weil sie sich nach Admin anfühlen - Projektstatus in die Wissensdateien schreiben - Secrets pushen, bevor die .gitignore sitzt > **Merke** > Nicht alle zwanzig auf einmal. Von oben nach unten, ein Prompt nach dem anderen. Jeder baut auf dem letzten auf. ## Der ganze Baum auf einer Seite Das baust du. Wenn du es im Dateibaum siehst, verstehst du es. ``` AI Projects/ └─ my-brain/ (auch als Obsidian-Vault öffnen) ├─ CLAUDE.md Hausregeln + Vorlieben ├─ business.md ├─ offers.md ├─ customers.md ├─ voice.md ├─ goals.md ├─ now.md Kurzzeitgedächtnis, diese Woche ├─ rules.md wie Arbeit organisiert wird ├─ tools.md alles, was schon verbunden ist ├─ .env Passwörter und Keys, sonst nichts ├─ .gitignore ├─ memory/ │ └─ MEMORY.md der Index: eine Zeile pro Memory ├─ projects/ │ └─ / │ └─ context.md wo dieses Projekt steht ├─ skills/ jeder Skill an einem Ort └─ workflows/ └─ scripts/ Repeat-Tasks, die nie denken ...alles in einem privaten GitHub-Repo. ``` ## Teile 1 bis 3: die Wurzel und die Hausregeln Ein Ordner, der jedes Projekt hält. Ein Brain-Ordner darin. Eine Regeln-Datei oben, die am Anfang jeder Session gelesen wird. Das ist das Fundament — und es ist ein Prompt. ``` Richte meinen Workspace ein. Erstelle auf dem Desktop einen Ordner „AI Projects“, und darin einen Ordner „my-brain“. Lege dann in my-brain eine CLAUDE.md an für meine Hausregeln und Vorlieben, und setze die Regel, dass ab jetzt jede Datei, jedes Projekt und jedes Dokument, das wir zusammen anlegen, in my-brain landet — außer ich sage etwas anderes. Lies CLAUDE.md am Anfang jeder Session. Bestätige, was du angelegt und welche Regeln du ergänzt hast. ``` > **So sieht Erfolg aus** > Beide Ordner existieren, `CLAUDE.md` liegt in `my-brain`, und der Agent sagt die Alles-speichern-Regel zurück. ## Teil 4: Model-Routing, damit du keine Tokens verbrennst Nicht jeder Schritt braucht das klügste, teuerste Modell. Lesen, Sammeln, Zusammenfassen gehen auf ein günstiges, schnelles. Urteil, Geschmack und finale Prüfung bleiben oben. Das senkt die Kosten jedes Laufs — und macht den Output besser, weil das starke Modell frisch bleibt für den Teil, der es wirklich braucht. ``` Ergänze eine Model-Routing-Regel in meinem Brain. Schreib das in CLAUDE.md: Bevor teure Arbeit startet, prüfe, ob sie echtes Urteil braucht oder nur Lesen, Sammeln oder Tippen ist. Gib Lesen, Sammeln und Massentext an einen Subagenten auf einem günstigeren, schnelleren Modell und hol nur die kurze Zusammenfassung zurück. Planung, Geschmack, Urteil und finale Prüfung bleiben auf dem klügsten Modell. Bewerte das Ergebnis, nicht den Preis: Wenn die günstige Arbeit die Latte reißt, mach sie eine Stufe höher neu — ohne dass ich danach fragen muss. ``` > **Warum das zählt** > Das ist der größte Hebel darauf, was dein Setup kostet — und es ist ein Paste. ## Teile 5 bis 7: was es wirklich über dich weiß Fünf Kontextdateien über dein Business, ein Memory-Ordner über Sessions hinweg, und ein Index, damit der Agent Dinge findet, statt den ganzen Ordner zu lesen. Die fünf Dateien skippt jeder. Und genau die entscheiden, ob Antworten generisch zurückkommen. Tippe die Antworten nicht. Sprich sie. Sprechen geht etwa viermal schneller, und du gehst tiefer, bevor es langweilig wird. ``` Interview mich, um meinen Business-Kontext aufzubauen. Stell eine Frage nach der anderen und warte auf meine Antwort. Geh fünf Bereiche durch und sag mir, wann jeder beginnt. 1. Mein Business: was es ist, was ich verkaufe und zu welchen Preisen, wie Kunden mich finden, was es anders macht. 2. Meine Angebote: für jedes, das ich verkaufe, Name, Preis, was drin ist, für wen, und die Transformation. 3. Meine Kunden: meine liebste Kundengeschichte, die drei Schmerzen, die sie am häufigsten nennen, die Einwände vor dem Kauf, und die genauen Worte, die sie benutzen. 4. Meine Stimme: lass mich zwei oder drei Dinge einfügen, die ich wirklich geschrieben habe, und studier, wie ich schreibe. 5. Meine Ziele: mein wichtigstes Ziel diesen Monat, wie Gewinn in 90 Tagen aussieht, mein größtes Constraint, und das eine, woran ich nicht rüttle. Stell mindestens zehn Fragen pro Bereich und mach weiter, solange Antworten neue Details freilegen. Schreib danach business.md, offers.md, customers.md, voice.md und goals.md in my-brain. ``` ``` Richte mein Memory ein. Erstelle in my-brain einen Ordner memory mit einem MEMORY.md-Index. Ergänze diese Regeln in CLAUDE.md: Was über Sessions hinweg passiert, landet im Memory-Ordner; jede Memory-Datei hält einen Fakt und bekommt genau eine Zeile in MEMORY.md, die darauf zeigt; das Detail steht in der Datei, nie im Index; lies MEMORY.md am Anfang jeder Session, damit du weißt, wo alles liegt. ``` > **Achtung** > Wenn die Fragen flach sind oder ein Bereich durchgehetzt wird, sag es. Ein dünnes Brain gibt dünne Antworten — und das ist die Stunde mit dem höchsten Hebel im ganzen Aufbau. ## Teil 8: eine tools.md, damit es aufhört, Dinge vorzuschlagen, die du schon hast Ohne diese Datei diskutiert jede Session neu, welches Tool dran ist. Der Agent schlägt etwas Neues vor, statt das zu nutzen, was schon verdrahtet ist. ``` Erstelle tools.md in my-brain. Geh alles durch, was auf diesem Rechner schon mit dir verbunden ist, und schreib für jedes: was es ist, wie es verbunden ist, was es dir erlaubt, was es nicht kann, und den genauen Satz, den ich sagen soll, damit du es benutzt. Ergänze dann in CLAUDE.md: lies tools.md, bevor du entscheidest, wie eine Aufgabe läuft; nutz, was schon verbunden ist, statt etwas Neues vorzuschlagen; und wenn wir etwas Neues anbinden, kommt es sofort in tools.md. ``` ## Teile 9 und 10: ein Projekt, ein Ordner Jedes aktive Projekt bekommt einen eigenen Ordner und darin eine `context.md`, wo das Projekt steht. Alles in einen Ordner kippen, und die Kontexte fangen an, sich zu bekämpfen. So hört ein Setup leise auf zu funktionieren. ``` Erstelle in my-brain einen Ordner projects. Für jedes aktive Projekt, das du in goals.md und now.md findest, leg einen Unterordner mit dem Namen an, und darin eine context.md mit: was es ist, für wen, wo es steht, welche Entscheidungen schon fallen, und was als Nächstes passiert. Dieses Detail bleibt raus aus MEMORY.md; setz stattdessen eine Zeile pro Projekt, die auf die context.md zeigt. Ergänze in CLAUDE.md: jedes neue Projekt bekommt einen eigenen Ordner mit context.md, und wenn ich ein Projekt nenne, lies seine context.md, bevor du daran arbeitest. ``` ## Teile 11 und 12: Obsidian und GitHub Zwei Dinge, die aus einem Ordner ein System machen, in dem du leben kannst. Obsidian gibt dir eine lesbare, verlinkbare Sicht auf dieselben Dateien, die der Agent nutzt — du sitzt nie vor deinem eigenen Brain ausgesperrt. GitHub gibt dir die Geschichte: jede Änderung gespeichert, und du kannst zurück, wenn etwas zerschossen wird. ``` Richte mein Brain so ein, dass es in Obsidian aufgeht. Erklär in klaren Schritten, wie ich my-brain als Obsidian-Vault öffne, damit ich dieselben Dateien lesen und bearbeiten kann, die du nutzt — und sag mir, was ich dort NICHT ändern soll, damit ich nichts kaputtmache, worauf du dich verlässt. ``` ``` Schütz mein Brain mit Versionskontrolle. Erstelle zuerst eine .gitignore in my-brain, die .env-Dateien ausschließt, alles was auf .key oder .pem endet, Credential-Dateien und .DS_Store. Richte dann Git in my-brain ein, erstelle ein PRIVATES GitHub-Repository namens my-brain, und push alles dorthin. Wenn ich keinen GitHub-Account habe, führ mich Schritt für Schritt durch. Ergänze in CLAUDE.md: Wenn ich sage „update my brain“, committe die Änderungen mit einer kurzen Message, was sich geändert hat, und push. ``` > **Die Reihenfolge** > Die Ignore-Datei kommt vor dem ersten Push. Ein Secret, das ein Repository erreicht, ist ein schlechter Nachmittag — auch wenn das Repo privat ist. ## Teile 13 und 14: diese Woche, und was in Arbeit ist `now.md` hält das Kurzzeitgedächtnis: was diese Woche live ist. Notion hält Status über Sessions: in Arbeit, blockiert, fertig, pro Projekt. Das bleibt raus aus den Kontextdateien, und nichts wird alt. Mischst du beides, füllen sich die Wissensdateien langsam mit der Realität vom letzten Monat. ``` Erstelle now.md in my-brain für mein Kurzzeitgedächtnis: woran ich diese Woche arbeite und was gerade vorn im Kopf ist. Ergänze in CLAUDE.md die Regel, sie am Anfang jeder Session zu lesen und neu zu schreiben, wenn ich sage „update my brain“. ``` ``` Verbinde Notion, damit du offene Tasks pro Projekt über Sessions hinweg tracken kannst. Erstelle eine Datenbank namens My Brain mit Name als Titel, Status als Select mit To Do, In Progress und Done, Priority als Select mit High, Medium und Low, und einem Due Date. Ergänze in CLAUDE.md: Meine Dateien halten Wissen, das stimmt bleibt; Notion hält Status, der sich ändert. Wenn ich sage „update my brain“, aktualisier das Board für alles, woran wir gearbeitet haben — und kopier Projektstatus nie in meine Memory-Dateien. ``` ## Teil 15: eine rules.md, damit Projekte sich nicht ineinander schieben Wie Arbeit organisiert wird, einmal aufgeschrieben. Eine Korrektur, die du zweimal geben musst, ist ein Systemfehler. ``` Erstelle rules.md in my-brain mit der Überschrift My standing rules. Darin: wie meine Arbeit organisiert sein soll — zu welchem Projekt Dinge gehören, wohin neue Dateien kommen, und wie Tasks getrackt werden, damit getrennte Projekte sich nicht ineinander schieben. Ergänze in CLAUDE.md: Jedes Mal, wenn ich dich korrigiere oder sage, das ist nicht das, was ich wollte, schreib die Korrektur sofort in rules.md als eine kurze, prüfbare Zeile, und lies rules.md am Anfang jeder Session. Schau dann zurück auf alles, was wir zusammen gemacht haben, find jede Korrektur, die ich dir schon gegeben habe, und schreib die jetzt rein. ``` ## Teile 16 bis 18: Skills, Workflows und Scripts Drei verschiedene Dinge, und den Unterschied lernst du einmal. Ein Skill ist ein gespeicherter Prozess, den du startest. Ein Workflow verkettet Skills und Tools zu einem ganzen Job, von dem du weggehen kannst. Ein Script ist ein Schritt, der sich nie ändert — und deshalb nie denken muss. Gehirne denken. Skills wiederholen. Scripts denken nie. Jede Stufe nach unten wird schneller und günstiger. ``` Richte meine Skills und Workflows ein. Leg jeden Skill in einen Ordner, damit sie über alle Projekte hinweg wiederverwendbar sind, und erstelle einen eigenen Ordner workflows für ganze Jobs, die diese Skills verketten. Ergänze in CLAUDE.md den Unterschied: Ein Skill ist ein gespeicherter Prozess, den ich starte; ein Workflow ist ein ganzer Job mit Checkpoints, an denen er stoppt und mir zeigt, bevor etwas Wichtiges passiert. ``` ``` Erstelle einen Ordner scripts in meinem workflows-Ordner. Schau dir dann an, was ich wiederholt tue und das jedes Mal identisch ist, ohne Urteil — Formatieren, Umbenennen, Skalieren, Daten zwischen Dateien schieben. Schreib dafür ein kleines Script, test es, und häng es in den Workflow, damit es sofort läuft statt jedes Mal Tokens zu kosten. Sag mir in einem Satz, was jedes Script tut und woran ich merke, wenn es kaputt ist. ``` > **Die 1-2-3-Regel** > Einmal von Hand. Beim zweiten Mal Notizen. Beim dritten Mal in einer Woche den Skill bauen. Wenn es nur einmal im Quartal passiert, verdient es keinen. ## Teile 19 und 20: absichern Passwörter und Keys liegen in genau einer Datei. Eine zweite Datei stellt sicher, dass die erste den Rechner nie verlässt. ``` Ergänze Sicherheitsregeln in meinem Brain. Schreib in CLAUDE.md: Nie ein Passwort, einen API-Key oder ein Token irgendwo außer in der .env, und nie eins im Chat an mich zurückpasten. Stell sicher, dass meine .gitignore .env ausschließt, alles auf .key oder .pem, Credential-Dateien und .DS_Store. Prüfe dann meinen ganzen Brain-Ordner jetzt auf Secrets, die nicht dort liegen sollten, sag mir, was du gefunden hast, und verschieb es. ``` > **So sieht Erfolg aus** > Eine `.env` und eine `.gitignore` liegen in `my-brain`, und github.com zeigt ein Repository namens `my-brain`, markiert als Private, ohne `.env` darin. ## Drei Regeln, die es schlank halten Die Struktur ist leicht zu bauen und leicht verrotten zu lassen. Diese drei halten sie in sechs Monaten noch nützlich. ### 1. Klauen, nicht übernehmen Audit alles, was du runterlädst. Behalt nur, was zu deinem Business passt, und bau es als deins neu. ### 2. Fertig heißt geprüft, nie beschrieben Wenn der Agent das echte Ergebnis nicht prüfen kann, soll er das klar sagen — statt Erfolg zu behaupten. ### 3. Housekeeping jedes Quartal Lass den Agenten das eigene Setup auditieren und vorschlagen, was gemerged oder archiviert wird. Nichts wird gelöscht, nur archiviert — und du gibst jeden Schnitt frei. ``` Mach einen Housekeeping-Durchgang über mein Setup. Lies meine rules.md, meine Memory-Dateien und meine Skills. Sag mir, was aufgebläht, veraltet, doppelt oder widersprüchlich ist, und was du schneiden oder mergen würdest. Ändere noch nichts. Zeig mir die Liste, lass mich freigeben, und mach dann nur die freigegebenen Schnitte. ``` ### Welchen einen Teil setzt du heute ein — nicht alle zwanzig? Der erste Prompt dauert unter zwei Minuten. Der Rest wartet. Fang mit der Wurzel an, nicht mit dem Interview. ## Dein Aktionsplan Hak ab, was du erledigt hast: - [ ] Teil 1 pasten: AI Projects, my-brain und CLAUDE.md existieren - [ ] Den Dateibaum gegen den Ordner auf der Platte prüfen - [ ] Die Routing-Regel in CLAUDE.md setzen - [ ] Das Interview nicht skippen — fünf Dateien, mündlich - [ ] Memory-Index, tools.md und das erste Projekt-context.md anlegen - [ ] .gitignore setzen, bevor der erste Push nach GitHub geht - [ ] now.md und Notion trennen: Wissen bleibt in Dateien, Status auf dem Board - [ ] Die nächste Korrektur sofort in rules.md schreiben - [ ] Housekeeping erst nach Freigabe — nichts löschen, nur archivieren Der Agent liest den Ordner. Der Ordner ist das Gedächtnis. Ohne ihn startet jede Session bei null.