javi-forge 1.2.0 → 1.3.0

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

@@ -1,216 +0,0 @@
----
-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

@@ -1,238 +0,0 @@
----
-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.