Une équipe Aigile virtuelle
dans Claude Code

Toolkit qui transforme Claude Code en équipe Aigile complète. Tout tient en 4 phases de travail + des outils transverses.

1 · Avant-vente 2 · Design 3 · Build & Qualité 4 · Livraison & Suivi
Voir le repo Comprendre l'architecture
21
Skills (que tu lances)
9
Sous-agents (auto)
6
Hooks (gardes auto)
4
Phases de travail
À lire en premier

3 briques, à ne pas confondre

Toute la stack repose là-dessus. Comprendre ces 3 mots, c'est comprendre Aigile Stack.

Ce que TU lances

Skill

Une commande /aigile-<nom> que tu déclenches toi-même. C'est ton interface avec la stack.

/aigile-cadrage
/aigile-lot start 2
/aigile-gate · /aigile-ship
Tourne tout seul

Sous-agent

Jamais lancé à la main. Un skill le déclenche pour un audit indépendant en lecture seule. Un œil critique, pas de l'auto-évaluation.

code-reviewer · rls-auditor
security-verifier · lot-reviewer
cadreur · chiffreur…
Garde-fou auto

Hook

Intercepte une action de Claude (commande, édition, fin de session) pour confirmer, bloquer ou suggérer. En arrière-plan.

check-rm-scope · check-careful · check-freeze
check-supabase-env · check-next-build
stop-learn · analytics
Hors workflow — utilisables à tout moment

Les outils transverses

Ces skills ne suivent pas le flux d'un projet : tu les actives quand le contexte l'exige. On les pose d'abord, pour les sortir du chemin.

Safety

1 skill à modes · pilote 2 hooks

Garde-fous activables. Une fois actifs, ce sont les hooks check-careful et check-freeze qui appliquent les règles.

/aigile-safety carefulNiveau 1 : confirmation avant commandes destructives hors périmètre (push --force, DROP en prod…)
/aigile-safety freezeNiveau 2 : verrouille les éditions à un seul dossier. Anti scope creep.
/aigile-safety guardNiveau 3 : careful + freeze + patterns prod. Pré-livraison.
/aigile-safety offDésactive tous les modes safety en une commande.

Outils Stack

3 skills · gérer la stack elle-même

Pour piloter Aigile Stack au quotidien : démarrer une session, capitaliser, mettre à jour, mesurer.

/aigile-briefBriefing de démarrage de session : lot en cours, git, backlog, prochaine étape.
/aigile-dev (5 modes)up · down · status · doctor · isolate — Supabase local + Next sur les ports dédiés du projet, isolation des builds.
/aigile-stack (4 modes)learn (learnings) · update (mise à jour) · analytics (stats usage) · help (aide offline).

Automatisation

1 skill · au besoin

Brique d'automatisation ponctuelle, créée quand le projet en a besoin — pas une étape du cycle de lot.

/aigile-n8n-workflowCrée un workflow N8N importable, avec doc, gestion d'erreur et alerte admin. Patterns : relance email, sync DB, notifs.

Rédaction

1 skill · au besoin

Retravaille un texte pour lui enlever le côté « généré par IA » et le rendre naturel.

/aigile-humanizerSupprime les marqueurs d'écriture IA selon 33 patterns (inflation, vocabulaire IA, tirets cadratins, clôtures d'assistant…) en préservant la substance.
Le cœur — le workflow d'un projet

4 phases, du prospect au suivi

Chaque skill (bleu) est listé dans sa phase, avec, dessous, les sous-agents verts qu'il déclenche automatiquement.

1

Avant-vente

Transformer un prospect en proposition signée : cadrer, chiffrer, proposer.

/aigile-cadrage
Cadre le projet prospect en 6 questions structurées et produit le WBS en langage client, avant de chiffrer.
↳ déclenchecadreur
/aigile-chiffrage
Chiffre le projet au quart d’heure : tâches, contrôle de vraisemblance, ROI, planning, abonnements (grille 15 sections).
↳ déclenchechiffreur
/aigile-proposition
Génère la proposition commerciale en page HTML autonome, prête à envoyer au prospect.
2

Design

De l'identité client aux pages Next.js statiques production-ready. Un seul skill à 3 modes — la sortie est le vrai code du projet.

/aigile-design 3 modes
brief (design system) → shotgun (variantes, optionnel) → nextjs (pages Next.js + composants UI + Vercel preview + smoke tests Playwright). Pas de maquette HTML jetable : le code produit est réutilisé directement en dev. Emails fictifs : @team383451.testinator.email.
↳ mode nextjs déclenchedesign-reviewer
3

Build & Qualité

Le cœur du dev : scaffolder, développer par lots, et garantir la qualité à chaque clôture de lot. Le quality gate est l'étape de clôture.

/aigile-projet-init
Crée le projet SaaS complet : Next.js + Supabase (dev mutualisé 1 schéma/client + prod dédié) + Vercel + N8N + Resend + Sentry + CLAUDE.md. Installe Playwright dès le scaffold (playwright.config.ts + dossier e2e/).
/aigile-plan
Pilote la roadmap et le backlog : ajoute/trie les bugs et améliorations, planifie les lots. Un lot = une user story ; un lot qui en porte deux est fractionné.
/aigile-lot
Pilote le dev par lots : start vérifie qu'il y a une seule story, clarifie en 5 questions max, écrit le plan par phases ([P] = parallélisable) et génère e2e/lot-N.spec.ts depuis les scénarios d'acceptation ; close déclenche le gate.
/aigile-supabase-rls
Génère et audite les policies RLS Supabase selon les rôles du projet (appliqué en dev via le runner de migrations).
↳ déclencherls-auditor
/aigile-gate orchestrateur
Clôture de lot : aigile-precheck.sh d'abord (arbre propre, build, lint, tests, suite e2e complète une fois, secrets, RLS, conventions — déterministe, chronométré), puis les sous-agents en parallèle, dimensionnés par palier (XS ≤ 3 fichiers : reviewer security seul, 3 min · S ≤ 10 : + lot-reviewer + un reviewer pour le reste, 6 min). Budget contractuel : au double, verdict et reste en backlog. Un finding préexistant ne bloque pas le lot et part au backlog Critique, jamais corrigé dans le gate. Bloque le merge si un feu est rouge.
↳ orchestre (selon le diff, après le précheck) lot-reviewer code-reviewer security-verifier rls-auditor qa-reporter (si UI)
/aigile-audit 3 modes
Audits manuels approfondis : code (relit le diff) · app (teste l'app qui tourne) · security (14 phases). Le quotidien passe par le gate (auto).
↳ déclenchecode-reviewerqa-reportersecurity-verifier
/aigile-investigate
Debug structuré en 5 phases : reproduction → root cause → fix → vérification.
4

Livraison & Suivi

Mettre en prod, livrer au client, suivre dans la durée.

/aigile-ship
Technique, à chaque mise en prod : bump version + changelog commités sur dev, PR dev→main, puis tag sur le merge commit. Jamais de commit de release en direct sur main.
/aigile-canary
Surveille l'app 10 min après une mise en prod ; alerte si régression visuelle ou erreurs.
/aigile-livraison
Client, une fois en fin de projet : doc utilisateur (intégrée, ou --doc seule), accès, formation, backup, support 30j.
↳ déclenchelivraison-auditor
/aigile-monitoring
Crée et gère les monitors uptime (Uptime Kuma) : surveillance 24/7 de l'app en prod.
/aigile-retro
Rétrospective : compare chiffrage vs réel et extrait les leçons (hebdo / projet / global).
La clé de lecture

Quel skill déclenche quel sous-agent

Les 9 sous-agents ne se lancent jamais seuls. Voici qui les déclenche, et pour quoi.

Sous-agentDéclenché parMission (lecture seule)
cadreur/aigile-cadrageAudit cadrage : complétude, libellés non techniques, zones floues, risques projet
chiffreur/aigile-chiffrageAudit chiffrage : ordre de grandeur global, sur- et sous-estimations, incohérences, tarifs
design-reviewer/aigile-design nextjsAudit pages Next.js : design system, composants, responsive, WCAG, perf
rls-auditor/aigile-supabase-rls · /aigile-gateAudit RLS : USING(true), couverture, indexes, SECURITY DEFINER
code-reviewer/aigile-audit code · /aigile-gateAudit du diff multi-focus (security, perf, testing…), en parallèle
security-verifier/aigile-audit security · /aigile-gateFiltre les false positives sécurité via exploit scenarios
qa-reporter/aigile-audit app · /aigile-gate (si UI)Catégorise les findings QA, calcule le health score
lot-reviewer/aigile-gate (clôture lot)Fiche ↔ diff : critères de fin couverts, dérive de périmètre, doc. Le mécanique est fait par aigile-precheck.sh
livraison-auditor/aigile-livraisonAudit livraison : tech, doc, accès, backup, Notion, Airtable…

/aigile-gate est le seul skill orchestrateur : il lance scripts/aigile-precheck.sh (déterministe, une seule fois) puis 3 à 6 sous-agents en parallèle selon le palier du diff (S / M / L) à la clôture d'un lot (qa-reporter ne lit le rapport Playwright que si la suite e2e du précheck a un échec ; bloquant si le lot touche l'UI). Objectif : moins de 6 min pour un lot d'une story. Les sous-agents à checklist tournent sur Sonnet ; code-reviewer garde le modèle de la session.

Sous le capot

Hooks & runtime

Les 8 gardes automatiques, la statusline, et les variables qui pilotent tout ça.

check-rm-scope PreToolUse Bash
Portée des suppressions de fichiers. Une cible sous la racine du projet passe sans confirmation ; hors projet, .git/, supabase/migrations/ et .env* demandent validation. Toujours actif, indépendant de /aigile-safety.
check-careful PreToolUse Bash
Confirmation avant commandes destructives. Piloté par /aigile-safety careful. Respecte les exemptions de portée : suppression dans le projet et SQL destructif sur base locale passent sans demande.
check-freeze PreToolUse Edit
Bloque les éditions hors périmètre. Piloté par /aigile-safety freeze.
check-supabase-env PreToolUse Bash + MCP
Cloison dev/prod Supabase : autorise tout ce qui cible localhost (instance Docker locale du projet) — db reset, DROP, TRUNCATE compris, c'est une base de test — et bloque toute cible prod.
check-next-build PreToolUse Bash
Refuse npm run build et rm -rf .next tant qu'un serveur de dev du projet écoute — le build écraserait son .next. Rediriger vers npm run build:check.
aigile-dev-up SessionStart
Démarre Supabase local + next dev sur les ports dédiés du projet (PORTS.md). Idempotent.
aigile-dev-down SessionEnd
Tue le next dev de la session, purge les builds isolés .next-*. Supabase reste en marche.
stop-learn Stop
Propose une capture leçon en fin de session significative.
analytics UserPromptSubmit
Logge l'usage des skills en local. Aucune télémétrie remote.
🛡️ careful · 🔒 freeze:contacts · 📦 cabi-crm · 🚧 Lot 3 · 🧠 sonnet

Statusline en temps réel · variables : AIGILE_LEARNING_PROMPT, AIGILE_ANALYTICS, AIGILE_PROJECTS_ROOT (toutes désactivables avec =0).