# Migrations-Checkliste: Langdock nach nuwacom

Autor: Manus AI · Stand: 03. August 2026

Diese Checkliste begleitet den Migrationsleitfaden. Sie ist zum Abhaken gedacht und kann ausgedruckt oder als Datei mitgeführt werden.

---

## Etappe 1 — Inventur und Priorisierung

- [ ] Lokalen Migrationsordner mit der vorgesehenen Unterordnerstruktur anlegen
- [ ] Prompt M1 in einem neuen Langdock-Chat ausführen und Ergebnis unter `00_inventar/` speichern
- [ ] Skills-Bereich in der Seitenleiste durchgehen, alle Skills notieren
- [ ] Agenten-Bereich durchgehen, alle Agenten notieren
- [ ] Workflows durchgehen, alle Workflows notieren
- [ ] Promptbibliothek durchgehen, alle Prompts notieren
- [ ] Library mit Knowledge bases und Folders durchgehen
- [ ] Projekte durchgehen
- [ ] Nutzungsdaten über die Usage Export API abrufen, alternativ Nutzung nach Erinnerung einschätzen
- [ ] Je Objekt entscheiden: übernehmen, verdichten oder zurücklassen
- [ ] Entscheidung dokumentieren, auch die Ablehnungen mit einer kurzen Begründung

## Etappe 2 — Zugänge schaffen

- [ ] Langdock-API-Key erstellen unter Workspace Settings, Products, API
- [ ] Berechtigungen setzen: `SKILL_API`, `AGENT_API`, `KNOWLEDGE_FOLDER_API`, Usage Export
- [ ] Jeden zu migrierenden Agenten mit dem API-Key teilen, Subagenten einzeln
- [ ] Jede zu migrierende Knowledge base mit dem API-Key teilen, Viewer-Rolle genügt zum Lesen
- [ ] nuwacom-API-Key erstellen unter Workspace Settings, API Keys
- [ ] Space-Kennung in nuwacom notieren, benötigt für den Asset-Upload
- [ ] Schnittstellenbeschreibung unter `https://{tenant}.nuwacom.ai/api/scalar` aufrufen und Erreichbarkeit prüfen

## Etappe 3 — Profilwissen exportieren

- [ ] Prüfen, ob Memory in den Langdock-Kontoeinstellungen aktiviert ist
- [ ] Neuen, leeren Chat öffnen, ausdrücklich **keinen** Agenten verwenden
- [ ] Zusatz-Prompt A ausführen, Memory-Einträge wörtlich sichern
- [ ] Zusatz-Prompt B ausführen, Skills und Instruktionen sichern
- [ ] MEGA Prompt im selben Chat ausführen
- [ ] Bei Längenabbruch mit dem Stichwort `FORTSETZEN` weiterführen
- [ ] Rückfragen aus Phase 4 des MEGA Prompts beantworten, Version 1.1 erzeugen
- [ ] Inhaltsreichste Alt-Chats auswählen und je Chat Zusatz-Prompt C ausführen
- [ ] Extrakte mit Zusatz-Prompt D konsolidieren
- [ ] Ergebnis unter `01_profilwissen/` speichern

## Etappe 4 — Skills übertragen

- [ ] Prompt M2 ausführen oder Skills über die Skills-API abrufen
- [ ] Je Skill eine `SKILL.md` unter `02_skills/` ablegen
- [ ] YAML-Kopf prüfen: `name` vorhanden, Slug in Kleinbuchstaben mit Bindestrichen
- [ ] Instruktionslänge prüfen, Grenze liegt bei 50.000 Zeichen
- [ ] Skills mit Begleitdateien als ZIP mit `SKILL.md` im Wurzelverzeichnis packen
- [ ] Beschreibungen auf konkrete Auslösephrasen prüfen und bei Bedarf schärfen
- [ ] In nuwacom über Skills, Add Skill, Upload a Skill hochladen
- [ ] Je Skill in einem neuen Chat testen, ob er zum richtigen Zeitpunkt anspringt
- [ ] Entscheiden, welche Skills als Workspace Skills und welche als Personal Skills gelten sollen
- [ ] Grenze beachten: 20 aktive Skills pro Nutzer

## Etappe 5 — Dateien übertragen

- [ ] Library, Recent Files öffnen und in die Listenansicht wechseln
- [ ] Nach Herkunft filtern und je Gruppe alle Einträge auswählen
- [ ] Sammel-Download ausführen, bei generierten Dokumenten Markdown wählen
- [ ] Bei Knowledge bases entweder Convert to folder nutzen oder Dateien einzeln herunterladen
- [ ] Vor der Umwandlung bestehende API-, Assistenten- und Automatisierungsverbindungen lösen
- [ ] Dateien im Migrationsordner thematisch einsortieren, nicht nach Herkunft
- [ ] Dubletten entfernen, veraltete Versionen aussortieren
- [ ] Manifest erzeugen: Dateiliste mit Namen, Typ, Datum und Zusammenfassung unter `00_inventar/`
- [ ] In nuwacom die Wissensdatenbank öffnen und die Ordner per Drag-and-drop hochladen
- [ ] Alternativ den Asset-Endpunkt nutzen und dabei `path` als Ordnerarray übergeben
- [ ] Nach dem Upload Vollständigkeit gegen das Manifest prüfen

## Etappe 6 — Guardrails und Instruktionen setzen

- [ ] Langdock Custom Instructions und Workspace-Beschreibung kopieren
- [ ] In nuwacom Workspace Settings, AI Guardrails öffnen
- [ ] Tonalität festlegen
- [ ] Verbindliche Regeln eintragen
- [ ] Zu vermeidende Begriffe eintragen
- [ ] Positiv- und Negativbeispiele für den Stil hinterlegen
- [ ] Logo und Workspace-Name unter General setzen
- [ ] Ergebnis mit einer Testanfrage prüfen

## Etappe 7 — Agenten nachbauen

- [ ] Je Agent die Konfiguration abrufen, per API oder mit Prompt M3
- [ ] JSON beziehungsweise Dokumentation unter `03_agenten/` ablegen
- [ ] In der nuwacom-Vorlagenbibliothek prüfen, ob eine Vorlage den Zweck erfüllt
- [ ] Agenten anlegen: Name, Beschreibung, Kategorie
- [ ] Instruktionen einsetzen, gegliedert nach Task, Action, Response Guidelines und Goal
- [ ] Wissensordner aus der Wissensdatenbank anhängen
- [ ] Gesprächseinstiege übertragen, maximal vier
- [ ] Startformular nachbauen, Feldtypen und Auswahloptionen von Hand ergänzen
- [ ] Benötigte Skills an den Agenten anhängen
- [ ] Mit einer realistischen Aufgabe testen und mit dem Langdock-Verhalten vergleichen

## Etappe 8 — Prompts, Workflows, Integrationen, Projekte

- [ ] Prompt M5 auf die ausgewählten Prompts anwenden
- [ ] Variablensyntax von doppelten auf einfache geschweifte Klammern umschreiben
- [ ] Prompts in nuwacom anlegen, Kategorie und Sichtbarkeitsbereich wählen
- [ ] Wo sinnvoll, Formularanzeige aktivieren
- [ ] Je Workflow Prompt M4 ausführen und die Bauanleitung unter `05_workflows/` ablegen
- [ ] Beschreibungsabsatz in den nuwacom-Chat geben und Workflow generieren lassen
- [ ] Generierten Workflow im Builder prüfen, testen und veröffentlichen
- [ ] Liste der benötigten Integrationen unter `07_integrationen/` erstellen
- [ ] Integrationen in nuwacom einzeln verbinden und autorisieren
- [ ] Projekte anlegen, Dateien zuordnen, projektbezogene Guardrails setzen

## Abschluss

- [ ] Parallelbetrieb beider Plattformen für zwei bis vier Wochen einplanen
- [ ] Prompt N1 in nuwacom ausführen und den Bestand aktivieren
- [ ] Rückfragen aus N1 beantworten und Profildokument aktualisieren
- [ ] Prompt N2 nach der Parallelphase ausführen und Lücken schließen
- [ ] Erst danach den Langdock-Zugang beenden
- [ ] Aktualisierungsrhythmus für das Profildokument festlegen, quartalsweise empfohlen
