Home / Documentation / Autopilot System

🤖 Autopilot Multi-Agents

8 agents IA spécialisés qui collaborent pour transformer vos idées en code production-ready. Décrivez, validez, déployez.

📊 Les 8 Agents

🔍 1. Analyst

Rôle: Analyse la demande utilisateur, pose des questions de clarification, estime la complexité.

Tools: Read, Glob, Grep, WebSearch

Output: Spécifications techniques, critères d'acceptation, score complexité (1-10)

🏗️ 2. Architect

Rôle: Conçoit l'architecture optimale, choisit les patterns, crée la task list.

Tools: Read, Glob, WebSearch, Write

Output: Architecture, composants, data flow, liste de tâches prioritisée

💻 3. Coder

Rôle: Écrit le code production-ready selon les spécifications de l'Architect.

Tools: Read, Write, Edit, Bash

Output: Fichiers créés/modifiés, lignes changées, commit summary

🧪 4. Tester

Rôle: Écrit et exécute les tests (unit, integration, e2e), mesure la coverage.

Tools: Read, Write, run_tests, coverage

Output: Tests passed/failed, coverage %, bugs détectés

👀 5. Reviewer

Rôle: Code review : qualité, sécurité OWASP, code smells, performance.

Tools: Read, Glob, analyze_code

Output: Score qualité (0-100), issues, suggestions, approved/rejected

🚀 6. DevOps

Rôle: Configure CI/CD, déploie (Vercel/Netlify/Docker), health checks.

Tools: Bash, Git, deploy, health_check

Output: Deployment status, URL, logs, rollback si échec

🧠 7. Orchestrator

Rôle: Coordonne tous les agents, gère la FSM, détecte les boucles, escalade vers humain.

Tools: FSM, Loop Detection, Confidence Scoring

Output: Coordination, décisions, escalations

⚡ 8. Fullstack (Mode FAST)

Rôle: Agent unique qui fait tout en un shot. Pour tâches simples (<500 LOC).

Tools: Tous les outils

Output: Projet complet, rapide, style Lovable/Bolt

🔄 Machine à États (FSM)

IDLE → ANALYZING → CLARIFYING? → PLANNING →
EXECUTING → TESTING → FIXING? → REVIEWING →
DEPLOYING → COMPLETED

Transitions

  • ANALYZING → CLARIFYING: Si questions pour l'utilisateur
  • TESTING → FIXING: Si tests échouent (max 3 cycles)
  • REVIEWING → EXECUTING: Si review rejette (max 2 cycles)
  • Toute étape → IDLE: Si confidence < 50% ou timeout

🛡️ Sécurités

  • Confidence < 50%: Escalade vers humain (pause + question)
  • 5 répétitions / 60s: Boucle détectée → arrêt + escalade
  • Timeout 30 min: Mission trop longue → arrêt + rapport
  • Checkpoints auto: Sauvegarde à chaque état → rollback possible

⚙️ Configuration

# Activer Autopilot
francois config set AUTOPILOT_ENABLED=true

# Choisir les modèles par agent
francois config set AUTOPILOT_ANALYST_MODEL=sonnet
francois config set AUTOPILOT_ARCHITECT_MODEL=opus  # Décisions critiques
francois config set AUTOPILOT_CODER_MODEL=sonnet
francois config set AUTOPILOT_REVIEWER_MODEL=opus  # Quality assurance
francois config set AUTOPILOT_TESTER_MODEL=haiku   # Tests simples
francois config set AUTOPILOT_DEVOPS_MODEL=sonnet

# Mode FAST (Fullstack en un shot)
francois autopilot fast "Crée une landing page avec formulaire contact"

📖 Exemple Complet

User: "Crée une API REST authentification avec JWT"

[ANALYZING] Analyst pose questions:
  - Base de données ? (PostgreSQL/MongoDB/SQLite)
  - Framework backend ? (Express/Fastify/Hono)
  - Tests requis ? (Oui/Non)

[PLANNING] Architect crée plan:
  1. Setup Express + TypeScript
  2. Modèle User (email, password hash)
  3. Routes: POST /register, POST /login, GET /me
  4. Middleware JWT verification
  5. Tests avec Jest + Supertest

[EXECUTING] Coder implémente (6 fichiers créés)

[TESTING] Tester exécute tests (12/12 passed, 95% coverage)

[REVIEWING] Reviewer approve (score 92/100)
  - ✅ Sécurité: bcrypt pour passwords, JWT secret en env
  - ✅ Qualité: TypeScript strict, error handling
  - ⚠️ Suggestion: Ajouter rate limiting

[DEPLOYING] DevOps déploie sur Render
  - URL: https://auth-api-abc123.onrender.com
  - Health check: ✅ OK

[COMPLETED] Mission réussie en 4min 23s
💡 Conseil

Pour les projets complexes, utilisez Opus pour Architect et Reviewer (décisions critiques), et Sonnet pour le reste (bon équilibre coût/qualité).