Diagnostic rapide du projet avec Godspeed

Contexte

Godspeed est un sous-agent diagnostic qui scanne rapidement l’état d’un projet : fichiers clés, stack détectée, version control, tests, documentation. Il retourne un rapport structuré sans proposer d’actions, utile pour comprendre en quelques secondes l’état d’un codebase complexe avant d’orchestrer d’autres agents.

Prérequis

Projet local accessible
Git initialisé (optionnel mais recommandé)
Accès en lecture aux fichiers du projet

Étapes

1. Lancer le diagnostic

Invoque Godspeed directement ou via Bruce pour un diagnostic complet.

/ulk:godspeed

Ou intégré dans Bruce :

/ulk:bruce

2. Attendre le rapport structuré

Godspeed analyse :

Fichiers clés (spec.md, todo.md, CLAUDE.md)
Stack détectée (Node, Python, Go, Rust, etc.)
Frameworks (Next.js, Astro, React, etc.)
État Git (branches, commits récents)
Tests présents
État de la documentation

3. Interpréter le rapport

Le rapport retourne des sections claires :

État du projet (NEW, IN_PROGRESS, LEGACY, BLOCKED)
Stack complète
Nombre de tâches par priorité
Branches divergentes
Fichiers modifiés non commités

Exemple de sortie

=== Diagnostic Godspeed ===

📊 Projet: my-app
🔍 État: IN_PROGRESS
⚡ Stack: TypeScript, Next.js, PostgreSQL, Vercel
🔗 Repository: https://github.com/user/my-app

🗂️ Fichiers clés:
  ✓ docs/spec.md (mise à jour: 2 jours)
  ✓ docs/todo.md (kanban format)
  ✓ CLAUDE.md (152 lignes)
  ✓ .git (main branch, 24 commits)

📋 Tâches:
  🔴 P0: 3 bloquant (1 en cours)
  🟠 P1: 5 critique (2 faites)
  🟡 P2: 8 important (4 faites)

⚠️ Alertes:
  - 3 fichiers modifiés non commités
  - Branch feature/auth diverge de 5 commits

Variantes

Diagnostic léger : Lance godspeed pour juste scanner l’état git et les fichiers clés
Diagnostic approfondi : Fais suivre avec une relecture manuelle du spec.md pour comprendre le contexte métier
Avant changement de contexte : Utilise godspeed pour prendre une photo de l’état avant de quitter

Agents enchaînés

Flux typique après diagnostic :

Godspeed (00) scanne → Bruce (25) orchestre la prochaine action
Godspeed (00) détecte BLOCKED → appelle Tony (50) pour débloquer
Godspeed (00) détecte IN_PROGRESS → appelle Task Runner (04)

Troubleshooting

Symptôme	Cause probable	Résolution
Diagnostic incomplet	Fichiers clés manquants	Créer docs/spec.md et docs/todo.md
Stack mal détectée	package.json absent	Exécute dans le dossier racine du projet
État bloqué indéfini	CLAUDE.md incomplet	Met à jour CLAUDE.md avec le contexte

Voir aussi

26-2b3-checkpoint.md — Fin de session propre
29-gandalf-hygiene.md — Monitoring du contexte