Schnellstart

Diese Anleitung führt in weniger als zehn Minuten durch den Kern von AgentFlow. Alle Beispiele verwenden --dry-run: Sie sehen, wie sich eine Absicht in Plan und Kostenschätzung übersetzt, ohne externe Agenten oder Validierungs-Shells zu starten — ein sicherer Weg, Orchestrierung auf einem echten Repository-Layout zu erkunden.

Wenn Ihnen der Ablauf vertraut ist und Agents sowie Validierung stehen, können Sie --dry-run bewusst weglassen.

1. Bauen und initialisieren

Ausgehend von einer gebauten Binärdatei und einem Projektbaum:

make build
export PATH="$PWD/bin:$PATH"
cd your-repo
agentflow init
agentflow doctor

doctor zeigt Lücken in der Konfiguration — etwa fehlende Agents oder MCP-Einstellungen — bevor ein vollständiger Lauf Zeit oder Tokens kostet.

2. Workflow in natürlicher Sprache im Dry-Run

work ist der oberste Einstieg in natürlicher Sprache. Die folgenden Befehle zeigen Planung und Schätzung ohne Nebenwirkungen auf den echten Agent-Lauf:

agentflow work "develop my-feature" --dry-run --plan-only
agentflow work "develop my-feature" --dry-run --estimate-only

--plan-only löst die Absicht auf und gibt den Ausführungsplan aus. --estimate-only durchläuft die V3-Pipeline bis zur Kosten- und Kontextschätzung — ohne externe Agent-CLIs aufzurufen.

3. Einzelne Pipeline-Schritte isoliert testen

Mit einem Kiro-Spec-Ordner (z. B. .kiro/specs/my-feature/) können Sie jeden Schritt einzeln anstoßen:

agentflow plan my-feature --dry-run
agentflow enrich my-feature --dry-run
agentflow dev my-feature --dry-run
agentflow verify my-feature --dry-run
agentflow review my-feature --dry-run
agentflow status --dry-run

Mit --dry-run laufen Orchestrierung und Logging lokal; echte Subprozesse von Agents werden nicht gestartet.

4. Lauf-Berichte einsehen

Nach einem Dry-Run-work, das bereits Metadaten angelegt hat:

agentflow status --dry-run
agentflow report <run-id> --dry-run

Reports liegen unter .agentflow/runs/<run-id>/report.md, ergänzt durch JSON für Werkzeugketten.

Reale Ausführung

Wenn die Konfiguration steht und Sie externe Prozesse akzeptieren:

agentflow work "develop my-feature" --estimate-only   # zuerst das Kosten-Gate
agentflow work "develop my-feature"                   # Standard: geführte Bestätigung

--estimate-only ist eine wirtschaftliche Schwelle vor bezahlter Agent-Zeit. Der übliche work-Pfad fragt weiter nach Bestätigung, solange Sie nicht die in der CLI-Referenz beschriebenen nicht-interaktiven Flags setzen.

Weiterlesen

• Erster Workflow
• CLI-Referenz (generiert)