torben
18ae28f918
Chemenu kompiliert Rohnotizen zu einem verlinkten, quellengebundenen Wiki: raw/ -> types/ + tools/ -> kb/ -> reports/. Was mechanisch ist, macht tools/wikitool; was Urteil braucht, macht ein Agent unter Contracts, deren Grenzen in Code durchgesetzt sind statt im Prompt. Dieser Commit ist der Startpunkt der oeffentlichen Historie. Die vorherige Entwicklung fand in einer privaten Instanz statt und ist nicht Teil dieses Repositorys; ihre Erzaehlung steht vollstaendig in CHANGES.md, das mit 44 Eintraegen von 0.1.0 bis 2.1.0 erhalten geblieben ist. Der mitgelieferte Korpus ist ein Testbett und eine Demo: 170 Seiten ueber den Stack selbst - Gates, Lint, Versionierung, Suche, das Wiki-Muster. Er dokumentiert das Werkzeug mit den eigenen Mitteln des Werkzeugs. Lizenz: AGPL-3.0 fuer den Stack (tools/, types/), CC-BY-4.0 fuer die Inhalte. Die Grenze zwischen beiden ist der Dateiplan, den dist export berechnet - siehe NOTICE.
66 lines
3.2 KiB
Markdown
66 lines
3.2 KiB
Markdown
---
|
|
type: types/concept.md
|
|
concept_type: workflow
|
|
tags: [automation, end-to-end, ingest, lint, update]
|
|
created: 2026-08-03
|
|
modified: 2026-08-29
|
|
related: [wikitool]
|
|
sources: [Source - LLM Improvements Codex Analysis]
|
|
confidence: 0.80
|
|
confidence_base: 0.80
|
|
provenance: sourced
|
|
summary: Orchestrierte Einzelbefehle für vollständige Operationen (ingest run, lint run, update run) mit Dry-Run-Vorschau vor dem Schreiben
|
|
---
|
|
# Workflow Orchestration
|
|
|
|
**Typ:** workflow
|
|
|
|
## Definition
|
|
|
|
Workflow-Orchestrierung ist das Konzept der Bereitstellung einzelner, orchestrierter Befehle, die komplette End-to-End-Operationen automatisch ausführen. Anstatt das LLM zu zwingen, mehrere diskrete CLI-Befehle manuell auszuführen (z. B. Quelle erstellen, Entities/Concepts identifizieren, Seiten erstellen, Querverweise hinzufügen, Index neu erstellen), behandelt ein orchestrierter Workflow-Befehl die gesamte Sequenz mit ordnungsgemäßem Error Handling und Validierung.
|
|
|
|
## Kernpunkte
|
|
|
|
- **Reduziert Agent Drift:** Weniger manuelle Schritte bedeuten weniger Gelegenheiten für das LLM, einen Schritt zu verpassen oder Befehle in der falschen Reihenfolge auszuführen
|
|
- **Dry-Run-Vorschau:** Befehle sollten einen `--dry-run`- oder `--plan`-Modus unterstützen, der zeigt, was getan werden würde, bevor Änderungen vorgenommen werden
|
|
- **Atomare Operationen:** Komplette Workflows sollten, wenn möglich, atomar sein - entweder alle Schritte erfolgreich oder keine
|
|
- **Aktuelle Lücke:** AGENTS.md dokumentiert lange Schrittenketten, aber sie werden als einzelne CLI-Aufrufe ausgeführt, nicht als orchestrierte Workflows
|
|
|
|
## Beispiele
|
|
|
|
- `wikitool ingest run raw/notes/file.md` - Komplette Aufnahme: Quelle erstellen, Entities/Concepts identifizieren, Seiten erstellen, Querverweise hinzufügen, Indizes neu erstellen, an Protokoll anhängen, veröffentlichen
|
|
- `wikitool lint run` - Komplettes Linting: strukturelle Prüfung, semantische Überprüfung, Konfidenzabfall, Indizes neu erstellen, an Protokoll anhängen
|
|
- `wikitool update run` - Komplettes Update: Seite lesen, Änderungen identifizieren, Inhalte bewahren, Zitate hinzufügen, Querverweise aktualisieren, Indizes neu erstellen, an Protokoll anhängen, veröffentlichen
|
|
|
|
## Wann zu verwenden
|
|
|
|
- Für wiederholte, mehrstufige Operationen, die einem definierten Muster folgen
|
|
- Wenn Konsistenz und Vollständigkeit kritisch sind
|
|
- Um die kognitive Belastung des LLM-Agenten zu reduzieren
|
|
|
|
## Wann NICHT zu verwenden
|
|
|
|
- Für Einmal- oder explorative Operationen, bei denen Flexibilität erforderlich ist
|
|
- Wenn der Workflow noch nicht gut verstanden oder standardisiert ist
|
|
|
|
## Verwandte Concepts
|
|
|
|
- [[AGENTS.md]] (definiert die Workflows, die orchestriert werden könnten)
|
|
- [[wikitool]] (das Tool, das die Orchestrierung implementieren würde)
|
|
(sollte mit orchestrierten Workflows integriert werden)
|
|
- [[Session Orientation]] (Preflight-Kontext für orchestrierte Operationen)
|
|
- [[Source - LLM Improvements Codex Analysis]][^s-llm-improvements-codex-analysis]
|
|
|
|
## Beziehungen
|
|
|
|
- **implementiert durch:** [[wikitool]]
|
|
|
|
## Siehe auch
|
|
|
|
- [[Source - LLM Improvements Codex Analysis]]
|
|
- [[wikitool]]
|
|
|
|
## Fußnoten
|
|
|
|
[^s-llm-improvements-codex-analysis]: [[Source - LLM Improvements Codex Analysis]]
|