Notion → lokale Spezifikation → work

Grundsatz

Notion ist nie die alleinige Laufzeitwahrheit. AgentFlow arbeitet immer von einem lokalen Snapshot unter .agentflow/specs/ (oder den Pfaden in sources.local.paths). Sync holt Inhalt aus der Cloud; work liest lokale Dateien und SQLite-Zustand.

Produkt- und Designrollen können in Notion schreiben; Engineering wiederholt Läufe aus Dateisystem-Snapshots. So bleibt das Verhalten nachvollziehbar, wenn sich Workspace-Schemas oder Datenbankstrukturen ändern.

Notion konfigurieren

YAML spiegelt das Schema: Connector aktivieren, Umgebungsvariable für das PAT festlegen, Datenbank-ID der Specs setzen, Importpfad typischerweise .agentflow/specs (anders wo dokumentiert).

sources:
  notion:
    enabled: true
    token_env: NOTION_TOKEN
    specs_database_id: "<your-database-id>"
    import_path: .agentflow/specs

Token setzen:

export NOTION_TOKEN="ntn_..."

Synchronisation

Einzelne Seite per URL oder alle aktivierten Quellen:

agentflow sync notion --page "https://www.notion.so/..."
agentflow sync all

Vorschau ohne Seiteneffekte:

agentflow --dry-run sync notion --page "https://www.notion.so/..."

Im interaktiven Modus kann vor dem Überschreiben einer lokal geänderten Spec nachgefragt werden.

Arbeiten vom lokalen Snapshot

Listing und Ausführung lesen denselben synchronisierten Baum:

agentflow inbox --source notion
agentflow work "develop billing-v2" --source notion

Abwägungen

Verwandtes

• Notion-Konfiguration
• CLI: sync
• CLI: inbox