Notion → spec local → work

Principe

Notion n’est jamais la source d’exécution. AgentFlow s’appuie toujours sur un instantané local sous .agentflow/specs/ (ou les chemins sources.local.paths). La synchro ramène ce qui vit côté cloud ; work lit ensuite fichiers synchronisés et état SQLite.

Les parties prenantes produit peuvent donc garder Notion comme atelier alors que l’ingénierie rejoue des runs à partir de clichés fichier immutables — ce découpage évite les mauvaises surprises lorsque l’équipe métier renomme des propriétés ou réordonne une base sans prévenir engineering.

Configurer Notion

YAML reflète le schéma canonique : activez le connecteur, nommez la variable d’environnement du PAT, rattachez l’identifiant de base de données des specs et pointez l’import par défaut vers .agentflow/specs (vous pouvez le personnaliser ailleurs).

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

Exporter secret :

export NOTION_TOKEN="ntn_..."

Synchroniser

sync notion accepte des URL canoniques de page alors que sync all balaie ensemble toutes les sources encore actives, ce qui garde plusieurs flux auxiliaires cohérents.

agentflow sync notion --page "https://www.notion.so/..."
# ou énumération + synchro combinée sources actives :
agentflow sync all

Aperçu dry-run :

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

Mode interactif peut demander confirmation avant d’écraser une spec locale modifiée.

Exécuter depuis instantanés

Liste + pipelines consultent encore .agentflow/specs après sync :

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

Arbitrages

Voir aussi

• Config Notion
• CLI sync
• CLI inbox