javi-forge 0.1.0

package/ai-config/skills/quality/ghagga-review/SKILL.md

@@ -0,0 +1,216 @@
+---
+name: ghagga-review
+description: >
+  AI code review patterns with GHAGGA multi-agent review system.
+  Trigger: code review, PR review, GHAGGA, review automatico, consensus review
+
+metadata:
+  author: project-starter-framework
+  version: "1.0"
+  tags: [code-review, ai, github, quality]
+  language: typescript
+  scope: [.github/, supabase/, dashboard/]
+---
+
+# 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.
+
+```yaml
+# .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.
+
+```typescript
+// 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.
+
+```typescript
+// 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
+
+```typescript
+// 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
+
+```sql
+-- 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
+
+```typescript
+// 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.
+
+```yaml
+# 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.
+
+```typescript
+// NO: consensus para todo
+{ review_mode: "consensus" }
+
+// SI: escalar segun criticidad
+const mode = isCriticalPath(files)
+  ? "consensus"
+  : changedLines > 100
+    ? "workflow"
+    : "simple";
+```
+
+## Quick Reference
+
+| Tarea | Como |
+|-------|------|
+| Setup basico | `./optional/ghagga/setup-ghagga.sh --workflow` |
+| Deploy local | `docker compose -f docker-compose.ghagga.yml up -d` |
+| Dashboard | `http://localhost:5173/ghagga/` |
+| Ver logs | `supabase functions logs review` |
+| Test webhook | `curl -X POST localhost:54321/functions/v1/webhook` |
+
+## Resources
+
+- [GHAGGA Repository](https://github.com/JNZader/ghagga/)
+- [Installation Guide](https://github.com/JNZader/ghagga/blob/main/docs/INSTALLATION.md)
+- [API Documentation](https://github.com/JNZader/ghagga/blob/main/docs/API.md)
+- [GitHub App Setup](https://github.com/JNZader/ghagga/blob/main/docs/GITHUB_APP_SETUP.md)
+
+---
+
+## 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

package/ai-config/skills/references/hooks-patterns/SKILL.md

@@ -0,0 +1,238 @@
+---
+name: hooks-patterns
+description: >
+  Hooks Recommendations for Claude Code automation: auto-formatting, type checking, protection, and test runner hooks.
+  Trigger: hooks, automation, PostToolUse, PreToolUse, auto-format, hook recommendations
+metadata:
+  author: project-starter-framework
+  version: "2.0"
+  tags: [hooks, automation, claude-code, formatting, protection]
+  updated: "2026-02"
+---
+
+# Hooks Recommendations
+
+Hooks automatically run commands in response to Claude Code events. They're ideal for enforcement and automation that should happen consistently.
+
+**Note**: These are common patterns. Use web search to find hooks for tools/frameworks not listed here to recommend the best hooks for the user.
+
+## Auto-Formatting Hooks
+
+### Prettier (JavaScript/TypeScript)
+| Detection | File Exists |
+|-----------|-------------|
+| `.prettierrc`, `.prettierrc.json`, `prettier.config.js` | ✓ |
+
+**Recommend**: PostToolUse hook on Edit/Write to auto-format
+**Value**: Code stays formatted without thinking about it
+
+### ESLint (JavaScript/TypeScript)
+| Detection | File Exists |
+|-----------|-------------|
+| `.eslintrc`, `.eslintrc.json`, `eslint.config.js` | ✓ |
+
+**Recommend**: PostToolUse hook on Edit/Write to auto-fix
+**Value**: Lint errors fixed automatically
+
+### Black/isort (Python)
+| Detection | File Exists |
+|-----------|-------------|
+| `pyproject.toml` with black/isort, `.black`, `setup.cfg` | ✓ |
+
+**Recommend**: PostToolUse hook to format Python files
+**Value**: Consistent Python formatting
+
+### Ruff (Python - Modern)
+| Detection | File Exists |
+|-----------|-------------|
+| `ruff.toml`, `pyproject.toml` with `[tool.ruff]` | ✓ |
+
+**Recommend**: PostToolUse hook for lint + format
+**Value**: Fast, comprehensive Python linting
+
+### gofmt (Go)
+| Detection | File Exists |
+|-----------|-------------|
+| `go.mod` | ✓ |
+
+**Recommend**: PostToolUse hook to run gofmt
+**Value**: Standard Go formatting
+
+### rustfmt (Rust)
+| Detection | File Exists |
+|-----------|-------------|
+| `Cargo.toml` | ✓ |
+
+**Recommend**: PostToolUse hook to run rustfmt
+**Value**: Standard Rust formatting
+
+---
+
+## Type Checking Hooks
+
+### TypeScript
+| Detection | File Exists |
+|-----------|-------------|
+| `tsconfig.json` | ✓ |
+
+**Recommend**: PostToolUse hook to run tsc --noEmit
+**Value**: Catch type errors immediately
+
+### mypy/pyright (Python)
+| Detection | File Exists |
+|-----------|-------------|
+| `mypy.ini`, `pyrightconfig.json`, pyproject.toml with mypy | ✓ |
+
+**Recommend**: PostToolUse hook for type checking
+**Value**: Catch type errors in Python
+
+---
+
+## Protection Hooks
+
+### Block Sensitive File Edits
+| Detection | Presence Of |
+|-----------|-------------|
+| `.env`, `.env.local`, `.env.production` | Environment files |
+| `credentials.json`, `secrets.yaml` | Secret files |
+| `.git/` directory | Git internals |
+
+**Recommend**: PreToolUse hook that blocks Edit/Write to these paths
+**Value**: Prevent accidental secret exposure or git corruption
+
+### Block Lock File Edits
+| Detection | Presence Of |
+|-----------|-------------|
+| `package-lock.json`, `yarn.lock`, `pnpm-lock.yaml` | JS lock files |
+| `Cargo.lock`, `poetry.lock`, `Pipfile.lock` | Other lock files |
+
+**Recommend**: PreToolUse hook that blocks direct edits
+**Value**: Lock files should only change via package manager
+
+---
+
+## Test Runner Hooks
+
+### Jest (JavaScript/TypeScript)
+| Detection | Presence Of |
+|-----------|-------------|
+| `jest.config.js`, `jest` in package.json | Jest configured |
+| `__tests__/`, `*.test.ts`, `*.spec.ts` | Test files exist |
+
+**Recommend**: PostToolUse hook to run related tests after edit
+**Value**: Immediate test feedback on changes
+
+### pytest (Python)
+| Detection | Presence Of |
+|-----------|-------------|
+| `pytest.ini`, `pyproject.toml` with pytest | pytest configured |
+| `tests/`, `test_*.py` | Test files exist |
+
+**Recommend**: PostToolUse hook to run pytest on changed files
+**Value**: Immediate test feedback
+
+---
+
+## Quick Reference: Detection → Recommendation
+
+| If You See | Recommend This Hook |
+|------------|-------------------|
+| Prettier config | Auto-format on Edit/Write |
+| ESLint config | Auto-lint on Edit/Write |
+| Ruff/Black config | Auto-format Python |
+| tsconfig.json | Type-check on Edit |
+| Test directory | Run related tests on Edit |
+| .env files | Block .env edits |
+| Lock files | Block lock file edits |
+| Go project | gofmt on Edit |
+| Rust project | rustfmt on Edit |
+
+---
+
+## Notification Hooks
+
+Notification hooks run when Claude Code sends notifications. Use matchers to filter by notification type.
+
+### Permission Alerts
+| Matcher | Use Case |
+|---------|----------|
+| `permission_prompt` | Alert when Claude requests permissions |
+
+**Recommend**: Play sound, send desktop notification, or log permission requests
+**Value**: Never miss permission prompts when multitasking
+
+### Idle Notifications
+| Matcher | Use Case |
+|---------|----------|
+| `idle_prompt` | Alert when Claude is waiting for input (60+ seconds idle) |
+
+**Recommend**: Play sound or send notification when Claude needs attention
+**Value**: Know when Claude is ready for your input
+
+### Example Configuration
+
+```json
+{
+  "hooks": {
+    "Notification": [
+      {
+        "matcher": "permission_prompt",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "afplay /System/Library/Sounds/Ping.aiff"
+          }
+        ]
+      },
+      {
+        "matcher": "idle_prompt",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "osascript -e 'display notification \"Claude is waiting\" with title \"Claude Code\"'"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Available Matchers
+
+| Matcher | Triggers When |
+|---------|---------------|
+| `permission_prompt` | Claude needs permission for a tool |
+| `idle_prompt` | Claude waiting for input (60+ seconds) |
+| `auth_success` | Authentication succeeds |
+| `elicitation_dialog` | MCP tool needs input |
+
+---
+
+## Quick Reference: Detection → Recommendation
+
+| If You See | Recommend This Hook |
+|------------|-------------------|
+| Prettier config | Auto-format on Edit/Write |
+| ESLint config | Auto-lint on Edit/Write |
+| Ruff/Black config | Auto-format Python |
+| tsconfig.json | Type-check on Edit |
+| Test directory | Run related tests on Edit |
+| .env files | Block .env edits |
+| Lock files | Block lock file edits |
+| Go project | gofmt on Edit |
+| Rust project | rustfmt on Edit |
+| Multitasking workflow | Notification hooks for alerts |
+
+---
+
+## Hook Placement
+
+Hooks go in `.claude/settings.json`:
+
+```
+.claude/
+└── settings.json  ← Hook configurations here
+```
+
+Recommend creating the `.claude/` directory if it doesn't exist.