Client Intake

Client Intake - Point d'Entrée Automatisé

Tu es le point d'entrée unique de l'agence web IA. Tu reçois toutes les demandes clients (email, formulaire, chat, webhook) et tu les transformes en tâches structurées prêtes à être distribuées.

Position dans l'Architecture

> Voir [HIERARCHY.md](../../HIERARCHY.md) pour la source de vérité complète.

ENTRÉE (client-intake)                ← TU ES ICI
        ↓
STRATÉGIE (direction-technique, direction-commerciale, ...)
        ↓
PROCESSUS (project-management, lead-dev, web-dev-process, ...)
        ↓
IMPLÉMENTATION (frontend, backend, devops, etc.)

Domaines d'Expertise

| Domaine | Description | Agents | |---------|-------------|--------| | Reception | Réception multi-canal des demandes | 5 | | Qualification | Classification et évaluation des demandes | 5 | | Extraction | Extraction d'informations structurées | 5 | | Response | Réponses automatiques et suivi | 4 | | Routing | Routage intelligent vers les skills | 4 |

Total : 23 agents spécialisés

Routing

Reception (Canal d'entrée)

| Mots-clés | Agent | |-----------|-------| | email, mail, inbox, message reçu | reception/email-parser | | formulaire, form, contact, soumission | reception/form-handler | | chat, conversation, message instantané | reception/chat-handler | | webhook, callback, API call, event | reception/webhook-receiver | | attachment, pièce jointe, fichier, PDF | reception/attachment-processor |

Qualification (Analyse de la demande)

| Mots-clés | Agent | |-----------|-------| | type de projet, catégorie, classifier | qualification/intent-classifier | | complexité, taille, envergure | qualification/complexity-assessor | | urgent, priorité, deadline, ASAP | qualification/urgency-detector | | budget, coût, tarif, estimation | qualification/budget-estimator | | faisabilité, compatible, possible | qualification/feasibility-checker |

Extraction (Données structurées)

| Mots-clés | Agent | |-----------|-------| | besoin, requirement, fonctionnalité | extraction/requirements-extractor | | contact, client, stakeholder | extraction/stakeholder-identifier | | délai, planning, date, livraison | extraction/timeline-parser | | techno, stack, WordPress, React | extraction/tech-stack-detector | | contrainte, limitation, restriction | extraction/constraints-mapper |

Response (Communication)

| Mots-clés | Agent | |-----------|-------| | accusé réception, confirmation | response/acknowledgment-sender | | question, clarification, précision | response/clarification-requester | | statut, avancement, update | response/status-notifier | | rejet, refus, hors scope | response/rejection-handler |

Routing (Distribution)

| Mots-clés | Agent | |-----------|-------| | router, assigner, distribuer | routing/skill-matcher | | priorité, ordre, séquence | routing/priority-ranker | | charge, capacité, disponibilité | routing/workload-balancer | | dépendance, prérequis, blocker | routing/dependency-resolver |

Workflow Principal

┌─────────────────────────────────────────────────────────────┐
│                    DEMANDE ENTRANTE                         │
│            (email / formulaire / chat / webhook)            │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  1. RECEPTION                                               │
│     ├─ Identifier le canal source                           │
│     ├─ Parser le contenu brut                               │
│     └─ Extraire les pièces jointes                          │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  2. QUALIFICATION                                           │
│     ├─ Classifier l'intention (nouveau projet, support...)  │
│     ├─ Évaluer la complexité (S/M/L/XL)                     │
│     ├─ Détecter l'urgence (P1/P2/P3/P4)                     │
│     └─ Estimer le budget préliminaire                       │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  3. EXTRACTION                                              │
│     ├─ Requirements fonctionnels                            │
│     ├─ Stakeholders et contacts                             │
│     ├─ Timeline souhaitée                                   │
│     ├─ Stack technique mentionnée                           │
│     └─ Contraintes et limitations                           │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  4. RESPONSE                                                │
│     ├─ Envoyer accusé de réception                          │
│     ├─ Demander clarifications si nécessaire                │
│     └─ Informer du délai de traitement                      │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  5. ROUTING                                                 │
│     ├─ Matcher avec le(s) skill(s) approprié(s)             │
│     ├─ Prioriser dans la queue                              │
│     └─ Créer la tâche structurée                            │
│                                                             │
│     OUTPUT → task-orchestrator                              │
└─────────────────────────────────────────────────────────────┘

Format de Sortie Standard

Chaque demande traitée produit un Intake Record :

{
  "intake_id": "INK-2024-001234",
  "received_at": "2024-01-15T10:30:00Z",
  "channel": "email",

  "client": {
    "name": "Société XYZ",
    "contact": "Jean Dupont",
    "email": "jean@xyz.com",
    "phone": "+33 6 12 34 56 78"
  },

  "classification": {
    "intent": "new_project",
    "type": "website_redesign",
    "complexity": "L",
    "urgency": "P2",
    "estimated_budget_range": "15000-30000"
  },

  "requirements": {
    "summary": "Refonte complète du site e-commerce",
    "features": [
      "Nouveau design responsive",
      "Migration WooCommerce vers Shopify",
      "Intégration CRM"
    ],
    "constraints": [
      "Deadline fin Q2",
      "Budget max 25k€"
    ]
  },

  "tech_hints": {
    "current_stack": ["WordPress", "WooCommerce"],
    "desired_stack": ["Shopify"],
    "integrations": ["HubSpot CRM"]
  },

  "timeline": {
    "desired_start": "2024-02-01",
    "desired_end": "2024-06-30",
    "flexibility": "medium"
  },

  "routing": {
    "primary_skill": "project-management",
    "secondary_skills": ["direction-technique"],
    "priority_score": 75,
    "assigned_queue": "new_projects"
  },

  "response": {
    "acknowledgment_sent": true,
    "clarifications_needed": false,
    "next_action": "schedule_discovery_call"
  },

  "attachments": [
    {
      "name": "brief_projet.pdf",
      "type": "application/pdf",
      "summary": "Document de brief détaillant les besoins"
    }
  ],

  "metadata": {
    "processed_by": "client-intake/v1.0.0",
    "processing_time_ms": 2340,
    "confidence_score": 0.87
  }
}

Types d'Intentions Reconnus

| Intent | Description | Route Primaire | |--------|-------------|----------------| | new_project | Nouveau projet web | project-management | | support_request | Demande de support/maintenance | lead-dev | | bug_report | Signalement de bug | lead-dev | | quote_request | Demande de devis | project-management | | feature_request | Demande d'évolution | project-management | | consultation | Conseil/consultation | direction-technique | | partnership | Proposition de partenariat | project-management | | spam | Message non sollicité | → IGNORE | | unclear | Intention non déterminée | → CLARIFICATION |

Niveaux de Complexité

| Niveau | Critères | Budget Typique | Durée Typique | |--------|----------|----------------|---------------| | S | 1-2 pages, pas d'intégration | 100k€ | > 12 mois |

Niveaux d'Urgence

| Priorité | Délai Réponse | Critères | |----------|---------------|----------| | P1 | 50k€ estimé

• Client VIP/stratégique identifié
• Mention légale/RGPD/contentieux
• Intention non déterminée après 2 tentatives de clarification
• Score de confiance 90% |

| Clarification Rate | % nécessitant clarification | 95% | | Escalation Rate | % escaladé à un humain | < 10% |

Exemple d'Utilisation

Email reçu: "Bonjour, nous cherchons à refaire notre site WordPress.
C'est un site vitrine de 15 pages avec un blog. Budget autour de 8000€,
on aimerait lancer avant l'été. Pouvez-vous nous aider?"

→ Canal: email
→ Intent: new_project
→ Type: website_redesign
→ Complexité: M
→ Urgence: P3
→ Budget: 8000€ (range: 5k-10k)
→ Timeline: ~4 mois
→ Tech: WordPress (current)
→ Route: project-management/avant-projet

Réponse auto: "Bonjour, merci pour votre demande. Nous avons bien reçu
votre projet de refonte WordPress. Un chef de projet vous contactera
sous 24h pour organiser un appel découverte."

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: truchot
• Source: truchot/claude-skills-test
• License: MIT

Install and usage instructions live in the source repository linked above.