prospection-pipeline

# Prospection et pipeline ## Étape 0 — Références (obligatoire) Charger `${CLAUDE_PLUGIN_ROOT}/reference/directives-outils.md` et appliquer ses règles pendant toute l'exécution (IDs, confirmations, données, formats, erreurs). ## Workflow 1. **Choisir la source de prospection** selon la demande : - Recherche géographique « métier + ville » → `prospecter_maps` (`speciality`, `city`) ; - Entreprise précise par nom ou SIRET → `prospecter_entreprise` (`nom` ou `siret`) ; pour une vérification SIRET seule : `rechercher_entreprise_siret` ; - Ciblage par code NAF / spécialité / date de création → `prospecter_prospect` (`code_naf`, `specialite`, `date`, `nom_societe`, `nombre` 1-100) ; - **Soumissions de formulaires (leads entrants)** → `get_formulaire_soumissions` (`formulaire_id` ou `formulaire_nom`) : chaque soumission est un prospect CHAUD — c'est la source à traiter en premier (elle a levé la main). 2. **Dédoublonner AVANT d'ajouter** : vérifier que le prospect n'existe pas déjà via `rechercher_prospects` (`q` recherche libre) et `search_entreprises` (`q`). Ne jamais créer de doublon dans le pipeline. Pour une SOUMISSION de formulaire : chercher par email puis par nom (`rechercher_prospects`, `list_contacts` `q`) AVANT `enregistrer_prospect` — une soumission d'un contact déjà connu = interaction à tracer (`log_activity`), pas un nouveau prospect. 3. **Ajouter au pipeline** — `ajouter_prospect_pipeline` avec `entreprise_id` OU `contact_id` (pipeline par défaut si `pipeline_id` absent ; `etape_id` pour une étape précise). - Fiche à créer directement (client apporté, partenaire — pas un prospect entrant) : `create_entreprise` / `create_contact` après dédoublonnage (étape 2), jamais en remplacement du flux `enregistrer_prospect`. - Capture entrante : `create_formulaire` crée le formulaire de collecte (champs validés par l'utilisateur) dont les soumissions (`get_formulaire_soumissions`) alimentent ensuite ce workflow. 4. **Assigner un responsable** — renseigner `responsable_id` dans `ajouter_prospect_pipeline` (retrouver l'ID via `list_commerciaux`). Si aucun responsable n'est indiqué, demander à l'utilisateur plutôt que d'assigner au hasard. 5. **Faire avancer les étapes** — `deplacer_prospect_etape` (`id` du prospect, `payload` avec l'étape cible). Consulter `get_pipeline` / `get_stats_pipeline` pour connaître les étapes existantes, et `get_historique_prospect` pour le contexte avant de déplacer. ## Garde-fous - Enregistrer en masse (`enregistrer_tous_prospects`) uniquement sur demande explicite ; par défaut, passer par `enregistrer_prospect` au cas par cas après dédoublonnage. - Ne jamais déplacer un prospect vers une étape sans confirmation de l'utilisateur sur l'étape cible. - Terminer par un récapitulatif : prospects trouvés, doublons écartés, ajouts au pipeline, assignations.