Concevoir une action avec FPL

Statut documentaire : guide — voir Maturité et preuves.

Une action doit représenter une capacité métier ou applicative identifiable, pas un simple regroupement arbitraire de code.

Bon design

• nommer l'intention plutôt que le détail technique ;
• déclarer clairement entrées, résultat et erreurs ;
• valider les préconditions avant mutation ;
• garder les effets observables explicites ;
• utiliser événements ou processus lorsque l'opération dépasse un appel court ;
• ne pas incorporer secrets, endpoints ou politiques de retry dans le script métier ;
• garder la logique réutilisable hors des handlers UI.

Local ou SDK

Si la logique nécessite une bibliothèque externe, une orchestration complexe ou des contraintes opérationnelles fortes, préférer une capacité publiée/SDK à un script qui contourne les frontières du Runtime.