Orchestrateur de Démo Restaurant

Que fait Orchestrateur de Démo Restaurant ?

Exécute un ordre de travail résumable, de la réception du prospect jusqu'à une démo privée locale vérifiée. Considérez cette compétence et l'agent principal comme le plan de contrôle ; utilisez trois agents ouvriers dédiés et les quatre compétences spécialisées comme plans d'exécution.

Lisez references/orchestration-contract.md avant de modifier le modèle d'étapes, les types d'artefacts ou les règles de transition.

Démarrer ou Reprendre un Ordre de Travail

1. Lisez le contexte du projet et inspectez les données locales du prospect avant de naviguer.
2. Initialisez l'ordre de travail avec scripts/workflow.py init. Insérez la ligne de la feuille de calcul, l'ID de lieu, l'URL Maps et un instantané du prospect local lorsqu'ils sont disponibles.
3. Exécutez scripts/workflow.py resume pour obtenir chaque étape active ou prête pour les dépendances, sa voie d'exécution, la compétence assignée, les artefacts attendus et le prompt spécifique à l'étape.
4. Effectuez la réception, la recherche, le verrouillage du design et les emplacements d'images dans l'agent principal avant la répartition.
5. Créez un ouvrier design, un ouvrier nourriture et un ouvrier extérieur lorsque les sous-agents sont disponibles. Démarrez les trois voies prêtes pour les dépendances ensemble ; chaque ouvrier enregistre des artefacts réels et marque uniquement ses étapes assignées comme passed, blocked ou – uniquement pour une branche optionnelle – skipped avec une raison.
6. Rassemblez tous les ouvriers. L'agent principal exécute la validation du contrat, intègre leurs sorties, résout les conflits, effectue l'assurance qualité finale et enregistre la démo privée.
7. Exécutez scripts/workflow.py validate après les transitions. Utilisez --run-contracts une fois que les manifestes de palette, de nourriture ou d'extérieur sont validés.
8. Répétez jusqu'à ce que private_demo soit réussie ou que des preuves créent un véritable blocage. Si les sous-agents ne sont pas disponibles, exécutez les mêmes voies séquentiellement et enregistrez le repli dans les notes de l'étape.

Ne demandez pas à l'utilisateur d'invoquer chaque compétence séparément. Lorsque l'utilisateur demande de construire, exécuter, continuer ou reprendre la Démo, continuez à travers toutes les étapes non bloquées dans la même tâche. Donnez des mises à jour de progression concises lors du changement de compétence spécialisée.

Préserver les Frontières des Spécialistes

Utilisez la compétence assignée plutôt que de reproduire son travail dans l'orchestrateur :

• research, design_lock, image_slots, site_design, implementation et qa : $restaurant-demo-builder
• brand_palette : $restaurant-brand-palette
• food_images : $restaurant-food-image-studio
• exterior_image : $restaurant-exterior-image-studio
• intake et private_demo : cette compétence

Avant de déclencher une étape spécialisée, l'agent principal doit lire complètement cette compétence. Chaque ouvrier doit également lire sa compétence assignée et suivre ses preuves et ses portes de validation. Une étape ne peut être réussie que lorsque ses artefacts requis existent. Le statut d'un manifeste spécialisé enregistré par le workflow ne remplace jamais le validateur spécialisé.

Contrat des Agents Parallèles

Utilisez au maximum trois agents ouvriers dans ces voies isolées :

• design : exécute brand_palette, puis crée la coque site_design réactive avec des espaces réservés d'image définis par contrat. Écrivez les fichiers de palette/verrouillage/transfert et la coque du site ; n'intégrez pas les sorties d'images des ouvriers et n'effectuez pas l'assurance qualité finale.
• food : exécute food_images. Écrivez uniquement l'ordre de travail et le manifeste de Food Image Studio ; ne modifiez pas la coque du site ni la Démo finale.
• exterior : exécute exterior_image. Écrivez uniquement l'ordre de travail et le manifeste de Exterior Image Studio ; ne modifiez pas la coque du site ni la Démo finale.

L'agent principal possède la réception, la recherche, les verrous partagés par toutes les voies, l'implementation finale, l'assurance qualité, les opérations de dépôt, les décisions de publication et le transfert à l'utilisateur. Seul l'agent principal peut copier des actifs sélectionnés des ouvriers dans la Démo finale, réconcilier les conflits de copie/mise en page/actifs, ou déclarer la Démo prête.

Les ouvriers peuvent mettre à jour leurs propres étapes de workflow via workflow.py set-stage ; l'outil d'état sérialise les écritures simultanées. Un ouvrier ne doit pas modifier les fichiers ou statuts d'une autre voie. À la fin d'un ouvrier, inspectez les artefacts réels et exécutez les validateurs au lieu de vous fier uniquement au message.

Règles des Étapes

Suivez cet ordre :

intake
  -> research
  -> design_lock
  -> image_slots
  -> [design: brand_palette -> site_design]
     [food: food_images]                 (parallèle)
     [exterior: exterior_image]
  -> implementation par l'agent principal
  -> qa
  -> private_demo

food_images et exterior_image sont des branches de décision, pas des omissions silencieuses. Validez-les lorsque des actifs qualifiés sont produits ; ignorez-les avec une raison fondée sur des preuves lorsque la page reste principalement textuelle ou que l'extérieur n'ajoute pas de valeur d'arrivée. N'ignorez jamais brand_palette ; utilisez son repli Recipe explicitement étiqueté lorsque les preuves du restaurant ne peuvent pas soutenir une palette dérivée de la marque.

Utilisez uniquement ces statuts. Jusqu'à trois étapes ouvrières indépendantes des dépendances peuvent être in_progress, mais une seule par voie d'ouvrier ; une étape de l'agent principal ne chevauche jamais une étape ouvrière :

• pending : non démarrée
• in_progress : en cours d'exécution active ; une seule étape à la fois
• passed : dépendances, artefacts et validateurs pertinents réussis
• blocked : ne peut pas continuer ; enregistrez un bloqueur concret
• skipped : branche optionnelle délibérément omise ; enregistrez pourquoi

Ne marquez jamais un travail incomplet comme passed pour faire avancer le workflow. Rouvrez une étape terminale avec --reopen lorsque ses preuves ou sa sortie changent.

Commandes

Remplacez <orchestrator-skill> par le dossier de cette compétence installée. Exécutez les commandes de l'ordre de travail depuis votre répertoire de projet restaurant.

Initialisation :

python3 <orchestrator-skill>/scripts/workflow.py init \
  --project-root . \
  --restaurant "Nom du Restaurant" \
  --slug nom-du-restaurant \
  --place-id "PLACE_ID" \
  --maps-url "GOOGLE_MAPS_URL" \
  --lead-json output/leads.json \
  --source-sheet-id "SHEET_ID" \
  --source-sheet-title "Titre de la feuille" \
  --source-tab Sheet1 \
  --source-row 28 \
  --sheet-checked-at 2026-07-13

Inspection et reprise ; resume peut retourner plusieurs étapes actionnables après la répartition :

python3 <orchestrator-skill>/scripts/workflow.py status \
  --workflow orchestration/nom-du-restaurant/workflow.json

python3 <orchestrator-skill>/scripts/workflow.py resume \
  --workflow orchestration/nom-du-restaurant/workflow.json

Enregistrer une étape :

python3 <orchestrator-skill>/scripts/workflow.py set-stage \
  --workflow orchestration/nom-du-restaurant/workflow.json \
  --stage research --status passed \
  --artifact research_record=orchestration/nom-du-restaurant/research/RESEARCH.md \
  --artifact restaurant_profile=orchestration/nom-du-restaurant/research/restaurant-profile.json

Valider :

python3 <orchestrator-skill>/scripts/workflow.py validate \
  --workflow orchestration/nom-du-restaurant/workflow.json --run-contracts

Garde-fous

• Gardez chaque nouvel ordre de travail en mode private-local par défaut.
• N'ajoutez pas de commandes automatiques de déploiement, téléchargement, e-mail, Messenger ou de prospection.
• Gardez distincts les faits vérifiés, les faits instantanés, les inférences, les décisions créatives et les questions ouvertes.
• Revérifiez les horaires actuels, le menu, la note, le nombre d'avis, le statut du site web, les services et les liens de contact avant de les utiliser sur la page.
• Ne placez pas de secrets, de fichiers de compte de service, de jetons ou d'informations d'identification privées dans un ordre de travail.
• Arrêtez-vous à private_demo ; la publication et la prospection nécessitent une autorisation explicite et séparée de l'utilisateur.

Transfert

Signalez le chemin de l'ordre de travail, l'étape en cours, le chemin ou l'URL de la Démo locale lorsqu'elle est disponible, les résultats de validation, les bloqueurs, les éléments nécessitant confirmation du propriétaire et les lacunes d'autorisation de publication. Indiquez explicitement qu'aucune publication ou prospection n'a eu lieu sauf autorisation séparée.