Le Blueprint : rendre n'importe quelle plateforme lisible par les agents

Le module PrestaShop n'est pas une fin en soi. C'est la première implémentation d'un patron réutilisable : comment ouvrir n'importe quelle plateforme e-commerce aux agents IA, sans inventer de protocole. On appelle ça le Blueprint.

Le problème n'est pas le protocole, c'est le couplage

La tentation, quand on implémente UCP ou MCP, est de tout coder dans le module. Le résultat : du code jetable, non transposable. À la plateforme suivante (WooCommerce, une API Symfony, un SaaS fermé), on recommence.

Le Blueprint pose une autre architecture : un cœur découplé + des adapters, articulés autour d'un format pivot.

Agents IA
   ▲  découvrent /.well-known/ucp, puis interrogent
ADAPTERS (UCP REST · UCP MCP · demain WebMCP, feeds)
   ▲  fonctions pures : Capability Graph → surface protocole
CAPABILITY GRAPH (JSON Schema versionné, neutre, sans marque)
   ▲  produit par introspection, via un PORT
PLATEFORME (PrestaShop · Sylius · une API · un proxy)

Le Capability Graph : la seule chose à écrire

Le pivot décrit « ce que ce système sait exposer » — produits, déclinaisons, prix publics, stock, langues, devises — indépendamment de tout protocole. C'est un JSON Schema versionné.

Une plateforme qui sait produire ce graphe hérite gratuitement de tous les adapters. C'est le seul travail spécifique. Le manifest, le mapping UCP, le serveur MCP : réutilisés tels quels.

Trois modes de déploiement, un seul cœur

• Embarqué (codé) : le cœur dans l'app, qui implémente les ports avec ses classes. C'est le module PrestaShop.
• Librairie : le cœur en dépendance Composer d'une app existante — ex. un FondoukBundle pour Sylius/Symfony. Deuxième implémentation de référence prouvant la transposition.
• Proxy : le cœur devant un système intouchable, branché sur son API, exposant la surface agentique à sa place.

La condition qui rend les modes 2 et 3 possibles : le cœur ne dépend d'aucun framework. D'où la séparation physique stricte capability-core/ ↔ prestashop-module/.

La ligne rouge

Le Blueprint est un playbook d'implémentation des standards existants, pas une spec concurrente. Le jour où il décrit un concept que UCP ou MCP définit déjà, on le supprime et on pointe vers leur spec. L'autorité vient d'être la meilleure implémentation, pas un standard de plus.

Lire le Blueprint

Quatre artefacts, extraits du code réel : le schéma du Capability Graph, le contrat d'adapter, le pattern de découverte, les modes de déploiement. Point d'entrée : ARCHITECTURE.md. Tout est ouvert (MIT).

L'équipe Fondouk — Synapsea