Skip to content

DOC

Démarrer un projet inconnu avec Bruce

Point d'entrée orchestrateur pour démarrer, reprendre ou diagnostiquer un projet ulk

Démarrer un projet inconnu avec Bruce

Contexte

Vous abordez un projet pour la première fois ou revenez après une pause. Bruce est le point d’entrée unique d’ulk : il diagnostique automatiquement l’état du projet, orchestre les sous-agents et vous guide de bout en bout. Aucun besoin de comprendre la structure interne — Bruce s’en charge.

Prérequis

  • Accès au répertoire racine du projet
  • Git configuré et historique disponible
  • .claude/agents/bruce.md installé (livré avec ./install.sh)
  • Mémoire persistante optionnelle : ~/.claude/agent-memory-local/bruce/MEMORY.md

Étapes

1. Invoquer Bruce

/ulk:bruce
# ou simplement
/ulk
# ou
bruce

2. Diagnostic automatique (Phase 0)

Bruce lance Godspeed (agent 00) pour scanner le projet :

  • État du git (branches, dernier commit, changements non stashés)
  • Structure du répertoire (monorepo, packages, agents customisés)
  • Stack détectée (framework, dépendances, base de données)
  • État des documents critiques (CLAUDE.md, docs/spec.md, docs/todo.md)
  • Agents installés et leurs versions

Affichage attendu :

🔍 Diagnostic en cours...

Git         : main (a3f8c2d)
Stack       : Next.js 15 + React 19 + TypeScript 5.5
Packages    : 7 monorepo
Agents      : 45+ (ulk-033 detected)
Spec        : docs/spec.md ✅ (1.2 KB, à jour)
Todo        : docs/todo.md ✅ (Kanban format)
CLAUDE.md   : ✅ (section vault:begin...vault:end detectable)

3. Sélection du mode

Selon l’état détecté, Bruce propose :

  • NEW : nouveau projet → lancer spec-writer + task-runner
  • SPECCED : spec validée, pas de code → démarrer build
  • IN_PROGRESS : code existant → reprendre et lister les tâches prioritaires
  • ADVANCED : projet mature → audit pré-release ou revue avant ship
  • LEGACY : code ancien sans docs → lancer legacy-revival (agent 18, mode=legacy)

Vous choisissez via prompt ou Bruce propose le chemin optimal.

4. Accompagnement

Bruce reste votre interlocuteur unique. Il :

  • Confirme les décisions importantes avant action
  • Orchestre les sous-agents sans pollution du contexte
  • Persiste l’état dans sa mémoire locale
  • Vous guide vers la prochaine étape

Exemple de sortie

🎯 Bruce — Orchestrateur ulk
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Projet : portfolio-saas (détecté depuis git config)
État : IN_PROGRESS
Dernière session : 2026-04-10 (spec phase)
Mémoire : ✅ chargée (3 tâches en cours)

CONTEXTE DÉTECTÉ :
  Framework   : Next.js 15 (App Router)
  UI          : shadcn/ui + Tailwind
  DB          : Neon PostgreSQL
  Deploy      : Vercel
  Todo        : docs/todo.md (Kanban, 24 items)
  Spec        : ✅ (validée, pas de changement depuis 48h)

RECOMMANDATION :
  Vous avez 3 tâches bloquées en Phase 2 (build).
  Voulez-vous que je lance un audit des dépendances (perf-auditor)
  ou que je vous accompagne sur une tâche spécifique ?

Que voulez-vous faire ?
  1. Continuer la dernière tâche (shadcn migration)
  2. Lancer un audit pré-release
  3. Consulter le diagnostic complet
  4. Personnalisé (tapez votre demande)

Variantes

  • Variante A : Reprendre après pause — Bruce charge la mémoire, compare l’état git, détecte les changements, met à jour le diagnostic
  • Variante B : Intégrer un nouveau collaborateur — Bruce génère un résumé contextuel court (15K tokens) avec stack, décisions clés et prochaines étapes
  • Variante C : Mode YOLO (autonomous) — Bruce accepte --autonomous en option pour orchestrer sans demander de confirmation (avancé)

Agents enchaînés

Flux typique dépendant du mode :

  • NEW : bruce → spec-writer (03) → task-runner (04) → agents spécialisés
  • IN_PROGRESS : bruce → godspeed (00) → 2b3 (08) → agents correctifs
  • LEGACY : bruce → blackemperor (18) mode=legacy → simplify + perf + docs
  • PRE-RELEASE : bruce → blackemperor (18) mode=release → audits parallèles → GO/NO-GO

Troubleshooting

SymptômeCause probableRésolution
”Permission denied” sur .claude/agents/Permissions fichier ulkchmod 755 ~/.claude/agents/bruce.md
Mémoire Bruce non chargée.claude/agent-memory-local/bruce/MEMORY.md absentPremière session autorisée, mémoire créée automatiquement
Diagnostic incomplet (pas de spec.md détecté)Chemin spécifique au projetBruce scan docs/spec.md et docs/spec*.md, vous pouvez pointer un chemin custom
Contexte trop large pour subagentsProjet > 50 fichiers critiquesBruce fragmente et utilise CONTEXTE PROJET: blocs compacts (3-10K tokens)

Voir aussi

  • ./02-blackemperor-pre-release.md — Audit pré-release avec orchestration complète
  • ./03-lovecraft-memory-loop.md — Boucle mémoire cross-session Obsidian
  • ./04-brique-figma-to-code.md — Implémenter un design Figma via brique
  • agents/orchestrators/25-bruce.md — Documentation complète de Bruce
  • agents/_shared/context-protocol.md — Protocole de contexte pour sous-agents