Buggazi + Claude Code

La gestion de projet pour agents de code. Aussi simple que git. 30 secondes pour tout configurer.

Etape 1 : Installation + inscription

npm install -g buggazi
bgz signup my-project --local

Votre cle API est enregistree dans .bgz/config.json dans votre projet. La cle est ACTIVE immediatement avec un acces complet pendant 48 heures. Commencez a signaler des bugs et des features tout de suite, sans carte ni email au prealable. Avant la fermeture de la fenetre, votre humain ouvre le lien d'essai (verification de carte a 0 $) pour demarrer l'essai gratuit de 7 jours ; la meme cle continue de fonctionner et vos donnees sont conservees, sans nouvelle inscription.

Vous avez deja une cle ? Lancez simplement : bgz login --local --key YOUR_KEY

Recommande par un utilisateur de Buggazi ? Ajoutez --ref BGZ-REF-XXXX au signup : 14 jours d'essai au lieu de 7.

Pas besoin de --api-url. Par défaut : buggazi.ai.

Etape 2 : Ajouter a CLAUDE.md

Ajoutez ceci au fichier CLAUDE.md de votre projet pour que Claude Code sache utiliser Buggazi :

Copier## Buggazi
Ce projet utilise Buggazi pour le suivi des bugs et la planification des features.
Utilisez la `bgz` CLI. La config est dans .bgz/config.json (chargee automatiquement).
Si non configure : bgz login --local --key VOTRE_KEY

Lancez `bgz init --agent-schema` — il renvoie chaque commande + flags valides.
C'est la source de verite : ce qui n'est pas dans le schema, ne pas l'utiliser.

Etape 3 (recommandee) : Installer les hooks du schema gate

bgz init --claude-hooks

Claude Code uniquement. Ecrit deux scripts de hooks dans .claude/ et les enregistre dans .claude/settings.json (vos hooks existants sont preserves ; Claude Code vous demande d'approuver les hooks du projet au premier lancement) :

SessionStart rafraichit l'agent-schema en direct et rappelle a l'agent que ce projet suit son travail dans Buggazi. PreToolUse valide chaque commande bgz contre ce schema avant execution : un verbe ou sous-commande invente est bloque avec une erreur qui nomme la commande correcte, et l'agent se corrige dans le meme tour au lieu de bruler une execution ratee. Les ecritures brutes en curl vers l'API Buggazi sont redirigees vers la CLI ou le MCP distant.

Fail-open par conception : si bgz ou le fichier de schema est indisponible, tout passe sans blocage et votre session n'est jamais interrompue. --print previsualise sans rien ecrire, --force regenere par-dessus vos copies modifiees.

Etape 4 : Utilisation

Demandez n'importe quoi a Claude Code - il decouvre les commandes via bgz init --agent-schema et cree bugs, features et sprints automatiquement. Ajoutez --project KEY pour grouper le travail par projet (les cles inconnues creent le projet automatiquement, illimites sur tous les plans).

Pour aller plus loin : dispatch vers GitHub

Buggazi est le registre durable ; les issues et PRs GitHub sont des artefacts d'execution jetables. Vous pouvez dispatcher un bug bgz sous forme d'issue GitHub qui invoque Claude Code dans GitHub Actions : l'agent ouvre une PR, vous reportez l'etat de la PR sur l'item bgz, verifiez en local, mergez, puis resolvez dans bgz. Seuls les items backend/logic/api partent en mode headless ; le travail visuel reste sous des yeux humains. Le patron complet (routage, polling, limites du workflow, auth par abonnement) est dans llms.txt sous "GitHub Bridge".