ARTICLE 05
3 use cases concrets avec ulk
3 use cases concrets avec ulk
Trois scénarios. Pour chacun : la situation de départ, la commande clé, la délégation entre agents, le livrable obtenu.
Use case #1 — Du prompt zéro au blog Astro déployé (Instagram → blog)
Situation
Aucun brief écrit. Aucune préparation. Une seule phrase tapée à Claude Code. Objectif : un blog Astro statique qui se nourrit d’un compte Instagram, déployé sur Vercel, avec design system généré depuis l’identité visuelle du compte.
C’est exactement le scénario du script vidéo (video/script-demo-complete.md).
Le prompt unique
/ulk:bruce je veux construire un outil qui transforme un compte Instagram
en blog Astro déployable. Brief, archi, design system depuis le visuel
du compte, code, audit, déploiement Vercel. Tu pilotes tout.
Enchaînement automatique des agents (11 étapes)
1. Bruce (25) — routage
Reçoit le prompt, invoque Godspeed, dresse le plan de bataille en 11 étapes, demande validation.
2. Godspeed (00) — diagnostic
Repo vide. Vérifie aussi les CLI dispo (gh, vercel, node, claude) et la présence d’un LLM local (ollama → 2b3 l’utilisera pour les commits, 0 token Claude).
3. Tony (50) — stack + archi + timing
Questionnaire court : volume de posts, source (API Meta Graph vs scraping), régénération, hosting images, multi-comptes ?
Sortie : Astro 5 SSG + content collections + TypeScript strict + Meta Graph API + Tailwind v4 + GitHub Action cron daily. Timing 4 phases × 0.5 jour = 2 jours dev solo. Handoff vers Stark.
4. Stark (58) — design system depuis Instagram
Nouveauté avril 2026. Analyse l’URL du compte Instagram, extrait le langage visuel via la skill Hue. Produit design-model.yaml (palette, typo, échelle d’espacement, radii), tokens.css, et 6 composants prévisualisés en HTML statique avant d’écrire la moindre ligne de TypeScript.
Cibles : PostCard, PostGrid, PostDetail, StoryStrip, HeaderProfile, FooterMinimal. Handoff vers Shuri pour la doc, Brique (01 frontend) pour l’implémentation.
5. Shuri (01) — spec + todo + sync
Reprend Tony + Stark. Produit docs/spec.md (frontmatter + 9 sections), docs/todo.md (Now : 8 items, Backlog plein), sync vers CLAUDE.md et README.md.
6. project-decomposer (35) — 12 prompts auto-suffisants
Transforme le todo en docs/prompts.md : 12 prompts Claude Code auto-suffisants. Chacun fonctionne même sans contexte préalable — assurance contre la dérive.
7. Implémentation guidée
Exécution séquentielle des 12 prompts. Sub-agent Explore à chaque exploration de dépendance lourde (règle 3 d’hygiène). Plugin officiel /feature-dev délégué pour la moitié des tests vitest.
8. 2b3 (08) — checkpoint propre
tsc strict, lint, vitest (14/14 verts), scan secrets, todo → Done, mémoire capturée vers docs/_memory/architecture/insta-pipeline.md, message de commit suggéré par ollama gemma3:1b local (zéro token Claude pour le commit).
9. Sargeras (45) — audit 10 axes avant prod
Sécurité 92, performance 88, tests 78 (sync.ts à 62 % couverture, ajouté Backlog), CI/CD 80, a11y 86 (4 alts manquants → Backlog). Pas bloquant pour la v1.
10. Killbill (56) — audit coûts
Vercel sur ce projet : 0 $ (free tier OK pour 500 posts statiques). Sur le compte global : 60 $/mois identifiés en gaspillage sur d’autres projets dormants. Mode dry-run par défaut.
11. Xavier (57) → déploiement
Vérifie repo, comptes (GitHub : izo ✓, Vercel : math-drouet ⚠️ perso intentionnel pour démo), token Meta Graph (read-only ✓). Puis vercel --prod — déployé en 38 s.
Bonus : programmation des cloud routines
/ulk:routine
Bouquet recommandé : 2b3 daily 18h, Godspeed weekly Mon, Sargeras weekly Mon, Robocop sur check_suite.completed (failed), Lovecraft daily 8h, Killbill monthly 1st, ED-209 monthly 15th, plus le cron GitHub Action insta-sync daily 06:00 UTC. Sessions autonomes sans machine locale.
Délivrables obtenus
- Blog Astro statique en prod, vraies images du compte Instagram, design Stark.
- Doc complète :
docs/spec.md,docs/todo.md,CLAUDE.md,README.md,docs/prompts.md,design-model.yaml,tokens.css. - Repo git propre avec un commit lisible (« feat(v1): blog Astro depuis compte Insta + design Stark + cron daily »).
- 14 tests verts.
- Rapport Sargeras initial archivé pour traçabilité.
- 8 cloud routines actives.
- Mémoire vault prête pour J+1.
Durée réelle : ~24 minutes de tournage, ~2 jours de dev équivalent en solo sans ulk.
Délivrables obtenus
docs/spec.md,docs/todo.md,CLAUDE.md,README.md— doc cohérente.- Repo git avec historique de commits propres (un par étape).
- Site déployé en prod.
- Rapport Sargeras initial pour traçabilité.
Use case #2 — Audit projet existant
Situation
Un repo récupéré (legacy, repris d’un autre dev, ou simplement plus visité depuis 6 mois). Objectif : savoir où on en est, ce qui pose problème, combien ça coûte.
Étapes
1. Cartographie via Bruce (25)
/ulk:bruce
Bruce appelle Godspeed (00), qui scanne le repo et produit un rapport : stack, état (greenfield / en cours / abandonné / prod), fichiers clés présents/absents, dette apparente.
2. Doc reverse via Strange (16)
Si la doc manque ou est obsolète :
/ulk:strange
Reconstitue docs/spec.md à partir du code. Mode mode=prompt : reverse-engineering des prompts ayant produit un output IA donné.
Pour la doc Obsidian-first :
/ulk:lovecraft harmonize
Détecte l’état de la doc, migre, complète intelligemment.
3. Audit complet via Sargeras (45)
/ulk:sargeras
Rapport 10 axes. Liste les violations triées par sévérité.
4. Audit sécurité dédié via ED-209 (52)
/ulk:ed209
Focus : secrets exposés, dépendances vulnérables, surface d’attaque, headers HTTP, CORS, auth.
5. Audit coûts via Killbill (56)
/ulk:killbill
Audit Vercel + GitHub + Neon. Mode dry-run par défaut. Plan d’économies chiffré.
6. Audit contexte/tokens via Context Audit (55)
/context-audit
Score de santé contexte 0-100. Détecte : MCP inutiles, CLAUDE.md bloaté, skills surdimensionnées, settings manquants.
7. Synthèse via Blackemperor (18) mode audit
/ulk:blackemperor
Mode audit : agrège les sorties Sargeras + ED-209 + Killbill + Context Audit en un rapport unique avec priorités.
8. Plan d’action via Shuri (01)
Shuri reprend les recommandations et les pousse dans docs/todo.md avec catégorie « audit-2026-04 ».
Délivrables obtenus
- Rapport global d’état du projet.
- Liste priorisée de fixes (sécurité d’abord, coûts ensuite, dette tech).
- Plan d’économies cloud chiffré.
docs/todo.mdà jour.
Use case #3 — Workflow quotidien
Situation
Projet en cours, on travaille dessus tous les jours. Objectif : maximiser la productivité sans saturer le contexte.
Routine matinale
1. Démarrage : Xavier (57)
/ulk:xavier
Vérifie : bon repo, bon compte, dernier état git, dernière session. (Avec hook --with-xavier-hook, c’est automatique au démarrage.)
2. Surface mémoire : Lovecraft (47)
/ulk:lovecraft memory surface
Affiche un résumé read-only des décisions des sessions précédentes. Auto-intégré dans la phase 1.5 de Godspeed.
3. Pulse projet : Godspeed (00)
/ulk:godspeed
Diagnostic de l’état actuel du repo. Quels tests sont rouges, quel est le dernier commit, où en est-on dans le todo.
Routine de développement
4. Tâche unique par session
Une seule tâche du todo.md. Pas de chaînage non lié (Règle 2 : /clear entre tâches).
5. Exploration via sub-agent (Règle 3)
Pour comprendre un module, ne pas explorer en main :
"Lance un sub-agent qui me résume comment fonctionne le module auth"
Le sub-agent retourne juste la synthèse. Contexte principal préservé.
6. /compact proactif à 50-60 % (Règle 4)
Quand la session approche 50 % :
/compact Préserve : décision archi (option B), fichiers en cours
(src/auth.ts), bug courant (#A042). Oublie les pistes abandonnées.
7. Erreur ? Robocop (11)
/ulk:robocop
Sur build cassé ou test rouge.
Routine de fin de session
8. Checkpoint via 2b3 (08)
/ulk:2b3
→ commit, todo à jour, mémoire capturée, état git propre.
9. /clear (Règle 2)
Après 2b3, /clear pour la prochaine tâche.
Cloud routines (sans machine locale)
Sessions autonomes programmées via l’agent Routine (53). Triggers recommandés (cf. CLAUDE.md section “Cloud Routines”) :
- 2b3 daily 18 h — auto-checkpoint fin de journée.
- Godspeed weekly — bilan hebdo.
- Robocop / CI Guard
check_suite.completed(failed) — auto-fix CI rouge. - Sargeras weekly Monday — audit hebdo.
- Lovecraft daily 8 h — surface mémoire avant la journée.
- ED-209 monthly — audit sécu mensuel.
Délivrables obtenus (par jour)
- Tâches du todo livrées.
- Commits propres.
- Mémoire à jour.
- Pas de dérive de contexte (les 4 règles tiennent).
Récapitulatif : qui appeler quand
| Situation | Agent |
|---|---|
| Je ne sais pas par où commencer | Bruce (25) |
| Brief vague → archi + stack | Tony (50) |
| Identité visuelle / design system | Stark (58) |
| Doc à créer / synchroniser | Shuri (01) |
| Doc à reconstituer depuis le code | Strange (16) ou Lovecraft (47) |
| Audit complet | Sargeras (45) |
| Audit sécu | ED-209 (52) |
| Audit coûts cloud | Killbill (56) |
| Audit contexte/tokens | Context Audit (55) |
| Build cassé / test rouge | Robocop (11) |
| Fin de session / commit | 2b3 (08) |
| Vérification de contexte | Xavier (57) |
| Mémoire entre sessions | Lovecraft (47) |
| Programmation cloud routines | Routine (53) |
Suite
Vidéo : démo complète d’un use case from-scratch, scène par scène. Voir video/script-demo-complete.md.