Ghagga Review

GHAGGA AI Code Review

Patrones para trabajar con GHAGGA, sistema de code review multi-agente.

When to Use

Usar este skill cuando:

• Configurando GHAGGA para un proyecto
• Creando reglas de review personalizadas
• Trabajando con Edge Functions de review
• Integrando GHAGGA en CI/CD pipeline
• Debuggeando reviews fallidas

Critical Patterns

Pattern 1: Reusable Workflow Integration

Por que: Integrar GHAGGA como paso de CI evita configuracion manual por repo.

# .github/workflows/ci.yml
jobs:
  # ... build jobs ...

  review:
    needs: build
    if: github.event_name == 'pull_request'
    uses: JNZader/project-starter-framework/.github/workflows/reusable-ghagga-review.yml@main
    with:
      ghagga-url: ${{ vars.GHAGGA_URL }}
      review-mode: simple
    secrets:
      ghagga-token: ${{ secrets.GHAGGA_TOKEN }}

Pattern 2: Review Mode Selection

Por que: Cada modo tiene diferente profundidad y costo.

// Simple: 1 LLM, rapido, bajo costo
{ review_mode: "simple" }

// Workflow: multi-paso secuencial, analisis profundo
{ review_mode: "workflow" }

// Consensus: multiples LLMs votan, maxima confiabilidad
{ review_mode: "consensus" }

Criterio de seleccion:

• PRs chicos (< 100 lineas): simple
• PRs medianos o con logica compleja: workflow
• PRs criticos (auth, payments, infra): consensus

Pattern 3: Custom Review Rules via Dashboard

Por que: Reglas custom evitan falsos positivos recurrentes.

// Configurar en dashboard (http://localhost:5173/ghagga/)
// Settings > Review Rules > Add Rule

// Ejemplo: ignorar cambios en archivos generados
{
  "name": "skip-generated",
  "pattern": "**/*.generated.*",
  "action": "skip"
}

// Ejemplo: review estricto en archivos de seguridad
{
  "name": "strict-security",
  "pattern": "**/auth/**",
  "action": "consensus",
  "severity": "high"
}

Code Examples

Example 1: Trigger review via API

// Desde una Edge Function o script
const response = await fetch(`${GHAGGA_URL}/functions/v1/review`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${GHAGGA_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    repository: "owner/repo",
    pull_request_number: 42,
    head_sha: "abc123",
    review_mode: "workflow",
  }),
});

const result = await response.json();
// { status: "completed", summary: "...", findings: [...] }

Example 2: Configurar providers en Supabase

-- En Supabase SQL Editor o migracion
INSERT INTO review_providers (name, model, api_key_env, priority)
VALUES
  ('anthropic', 'claude-sonnet-4-20250514', 'ANTHROPIC_API_KEY', 1),
  ('openai', 'gpt-4o', 'OPENAI_API_KEY', 2),
  ('google', 'gemini-2.0-flash', 'GOOGLE_API_KEY', 3);

Example 3: Webhook handler pattern

// supabase/functions/webhook/index.ts
import { serve } from "https://deno.land/std/http/server.ts";

serve(async (req) => {
  const event = req.headers.get("x-github-event");
  const payload = await req.json();

  if (event === "pull_request" && ["opened", "synchronize"].includes(payload.action)) {
    // Trigger review
    await triggerReview({
      repo: payload.repository.full_name,
      pr: payload.pull_request.number,
      sha: payload.pull_request.head.sha,
    });
  }

  return new Response("ok", { status: 200 });
});

Anti-Patterns

Anti-Pattern 1: Review en cada commit

Problema: Consume API tokens innecesariamente, genera ruido.

# NO: trigger en cada push
on:
  push:
    branches: ['**']

# SI: solo PRs a branches principales
on:
  pull_request:
    branches: [main, develop]

Anti-Pattern 2: Consensus mode para todo

Problema: Costo x3, tiempo x3, para cambios triviales.

// NO: consensus para todo
{ review_mode: "consensus" }

// SI: escalar segun criticidad
const mode = isCriticalPath(files)
  ? "consensus"
  : changedLines > 100
    ? "workflow"
    : "simple";

Quick Reference

Resources

• GHAGGA Repository
• Installation Guide
• API Documentation
• GitHub App Setup

Related Skills

• devops-infra: CI/CD y GitHub Actions workflows
• git-github: GitHub API y CLI
• playwright-e2e: Testing E2E (complemento a AI review)

Changelog

• 1.0 - Version inicial con patrones de integracion