Dokumente & Vorlagen
Wie lege ich eine wiederverwendbare Vorlage als Markdown-Dokument an?
Systeme als versionierte Markdown-Vorlagen sichern, projektübergreifend wiederverwenden und Schritt für Schritt erweitern.
Das brauchst du dafür
- Für das Anlegen und Erweitern per Chat: ein verbundener KI-Client über den MCP-Connector.
- Der Versionsverlauf für Vorlagen gehört zum Tarif Pro und darüber.
Was ein Dokument ist
Ein Dokument ist ein Eintrag vom Typ Markdown: ein strukturierter Text, der ein System, ein Vorgehen oder ein Grundgerüst beschreibt, oft samt Code. Genau das macht es zur Vorlage, auf der du in anderen Projekten aufbaust.
- Der Text liegt in der Datenbank (bis 20.000 Zeichen) und ist damit für Suche und KI zugänglich.
- Zusätzlich wird eine echte .md-Datei im Object Storage abgelegt.
- Dokumente sind projektübergreifend auffindbar, auch wenn du sie einem Projekt zuordnest.
1 · Dokument im Dashboard anlegen
- Öffne im Dashboard den Bereich Dokumente.
- Trage einen Titel ein und schreibe den Markdown-Inhalt in das Textfeld.
- Optional ein Projekt zuordnen.
- Auf Profi-Vorlage einfügen klicken, wenn du ein Gerüst willst, statt bei null anzufangen.
- Mit Dokument anlegen speichern.
Das eingefügte Gerüst sieht so aus:
# {Titel}
## Überblick
Kurz: Zweck, Kontext und Ziel dieses Dokuments.
## Anforderungen
-
## Aufbau / Architektur
-
## Umsetzung
1.
## Offene Punkte
-
## Änderungsverlauf
- v1 – Erstfassung2 · Dokument im Chat anlegen
Im Chat sagst du der KI, dass etwas als Vorlage gesichert werden soll. Sie ruft dann create_md auf und übergibt Titel, Markdown-Inhalt, Tags und das Projekt dieser Unterhaltung. In Claude Code geht das auch über den Slash-Befehl /md create.
Speichere das grundlegende Registrierungs-System als Vorlage in metisBrain, mit dem Code, und tagge es mit vorlage und auth.
/md create Registrierung mit E-Mail-Bestätigung und Passwort-Reset
3 · Auf einer Vorlage aufbauen
Der eigentliche Zweck: In einem neuen Projekt baust du auf einer bestehenden Vorlage auf, statt von vorn anzufangen. Die KI holt sich mit read_note den vollständigen Inhalt (nicht nur die Vorschau) und setzt das Neue darauf.
Erstelle eine Registrierung basierend auf meiner Registrierungs-Vorlage und ergänze Zwei-Faktor-Authentifizierung.
- Suche projektübergreifend: Die KI ruft read_note mit scope ALLE auf, damit auch Vorlagen aus anderen Projekten gefunden werden.
- Sie prüft vorher, was in der Vorlage schon steht, und ergänzt nur, was fehlt.
- Enthält die Vorlage Code, wird er als Grundlage mitgenommen.
4 · Versioniert erweitern
Wenn du eine Vorlage um ein Feature erweiterst, wird sie nicht überschrieben, sondern versioniert fortgeschrieben. Die KI nutzt dafür update_md: Sie findet das Dokument über seinen Namen, hängt mit append einen neuen Abschnitt an oder ersetzt mit replace den ganzen Inhalt, und beschreibt die Änderung kurz.
Ergänze meine Registrierungs-Vorlage um einen Abschnitt zu Magic-Link-Login und vermerke die Änderung im Verlauf.
- Die Versionsnummer steigt bei jeder Erweiterung: aus der Erstfassung wird v2, dann v3.
- Zu jeder Version wird ein Eintrag im Änderungsverlauf gespeichert: Nummer, Zeitpunkt und die Kurzbeschreibung der Änderung.
- Die .md-Datei im Object Storage wird mit dem neuen Inhalt überschrieben.
- Auf der Karte im Dashboard siehst du die aktuelle Version (v2, v3 …).
So sieht eine gewachsene Vorlage aus
Nach zwei Erweiterungen steht die Vorlage auf v3, und im Dokument selbst führst du den Verlauf mit:
# Registrierung (System-Vorlage) ## Überblick E-Mail plus Passwort, Bestätigungs-Link, Passwort-Reset. ## Umsetzung 1. Registrierung mit Hash (kein Klartext-Passwort) 2. Bestätigungs-Mail mit einmaligem Token ## Zwei-Faktor (v2) TOTP über App, Wiederherstellungscodes bei der Aktivierung. ## Magic-Link-Login (v3) Einmal-Link per Mail, 15 Minuten gültig, ein Login pro Link. ## Änderungsverlauf - v1 Erstfassung - v2 Zwei-Faktor ergänzt - v3 Magic-Link-Login ergänzt
Was der Tarif abdeckt
- Dokumente und Vorlagen: 5 im Tarif Start, 100 in Pro, unbegrenzt in Team.
- Versionsverlauf für Vorlagen: ab dem Tarif Pro.
- Speicher für die abgelegten Dateien: 250 MB (Start), 5 GB (Pro), 50 GB (Team).
- Export als Markdown oder JSON: ab dem Tarif Pro.
Wenn es nicht klappt
Häufige Fragen
Wie sage ich der KI, dass sie ein System als Vorlage speichern soll?
Sag im Chat sinngemäß: „Speichere das grundlegende System als Vorlage in metisBrain, inklusive Code." Die KI legt daraufhin ein Markdown-Dokument mit sprechendem Titel an, das im Dashboard unter Dokumente erscheint und in jedem anderen Projekt wiederverwendet werden kann.
Wie erweitere ich eine bestehende Vorlage, ohne sie zu überschreiben?
Bitte die KI, das Feature zur Vorlage zu ergänzen, zum Beispiel: „Ergänze meine Registrierungs-Vorlage um Magic-Link-Login." Sie liest zuerst den vollen Inhalt, prüft, ob es schon vorhanden ist, hängt dann den neuen Abschnitt an und erhöht dabei die Version. Der bisherige Inhalt bleibt erhalten.
Wo sehe ich, in welcher Version ein Dokument ist?
Im Dashboard steht die aktuelle Versionsnummer (v2, v3 …) direkt auf der Karte des Dokuments neben dem Titel. Zu jeder Version wird zusätzlich ein Eintrag im Änderungsverlauf gespeichert, mit Zeitpunkt und einer kurzen Beschreibung der Änderung.
Warum heißt die Datei anders als der Titel, den ich vergeben habe?
Der Dateiname wird aus dem Titel gebildet und für den Speicher bereinigt: Er bekommt die Endung .md, und Zeichen außerhalb von Buchstaben, Ziffern, Punkt, Unterstrich, Leerzeichen und Bindestrich werden durch einen Bindestrich ersetzt. Der Titel im Dokument selbst bleibt unverändert.
Wie viele Dokumente sind in meinem Tarif enthalten?
Der Tarif Start umfasst 5 Dokumente und Vorlagen, Pro 100 und Team unbegrenzt viele. Der Versionsverlauf für Vorlagen ist ab dem Tarif Pro enthalten.