Buggazi + Claude Code

Gestión de proyectos para agentes de código. Tan fácil como git. 30 segundos para configurar.

Paso 1: Instalar + registrarse

npm install -g buggazi
bgz signup mi-proyecto --local

Tu API key se guarda en .bgz/config.json dentro de tu proyecto. La key está ACTIVA de inmediato con acceso completo durante 48 horas. Empieza a registrar bugs y features enseguida, sin tarjeta ni email por adelantado. Antes de que se cierre la ventana, tu humano abre el enlace de prueba (verificación de tarjeta de $0) para iniciar la prueba gratuita de 7 días; la misma key sigue funcionando y tus datos se conservan, sin volver a registrarse.

¿Ya tienes una key? Solo ejecuta: bgz login --local --key TU_KEY

¿Te recomendó un usuario de Buggazi? Añade --ref BGZ-REF-XXXX al signup: 14 días de prueba en lugar de 7.

No necesitas --api-url. Por defecto: buggazi.ai.

Paso 2: Agregar a CLAUDE.md

Agrega esto al archivo CLAUDE.md de tu proyecto para que Claude Code sepa usar Buggazi:

Copiar## Buggazi
Este proyecto usa Buggazi para seguimiento de bugs y planificacion de features.
Usa la `bgz` CLI. La configuracion esta en .bgz/config.json (se carga automaticamente).
Si no esta configurado: bgz login --local --key TU_KEY

Ejecuta `bgz init --agent-schema` — devuelve cada comando + flags validos.
Esa es la fuente de verdad: lo que no este en el esquema, no lo uses.

Paso 3 (recomendado): Instalar los hooks del schema gate

bgz init --claude-hooks

Solo para Claude Code. Escribe dos scripts de hooks en .claude/ y los registra en .claude/settings.json (tus hooks existentes se conservan; Claude Code te pide aprobar los hooks del proyecto en el primer arranque):

SessionStart refresca el agent-schema en vivo y recuerda al agente que este proyecto gestiona su trabajo en Buggazi. PreToolUse valida cada comando bgz contra ese esquema antes de ejecutarlo: un verbo o subcomando inventado se bloquea con un error que nombra el comando correcto, y el agente se autocorrige en el mismo turno en vez de quemar una ejecución fallida. Las escrituras crudas con curl contra la API de Buggazi se redirigen a la CLI o al MCP remoto.

Fail-open por diseño: si bgz o el archivo de esquema no están disponibles, todo pasa sin bloqueo y tu sesión nunca se detiene. --print muestra una vista previa sin escribir nada, --force regenera sobre tus copias editadas.

Paso 4: Empezar a usar

Pide a Claude Code lo que necesites — descubre los comandos con bgz init --agent-schema y crea bugs, features y sprints automáticamente. Añade --project KEY para agrupar el trabajo por proyecto (las claves desconocidas crean el proyecto automáticamente, ilimitados en todos los planes).

Un paso más: dispatch a GitHub

Buggazi es el registro duradero; los issues y PRs de GitHub son artefactos de ejecución desechables. Puedes despachar un bug de bgz como un issue de GitHub que invoca a Claude Code en GitHub Actions: el agente abre un PR, tú reflejas el estado del PR en el item de bgz, verificas en local, haces merge y después resuelves en bgz. Solo los items backend/logic/api van en modo headless; el trabajo visual se queda con ojos humanos. El patrón completo (enrutado, polling, límites del workflow, auth por suscripción) está en llms.txt bajo "GitHub Bridge".