@cristiancorreau/forge 2.9.6 → 2.9.8

package/assets/scripts/aitmpl-search.py

@@ -1,808 +0,0 @@
-#!/usr/bin/env python3
-"""
-template-search.py — Busca templates y recursos para desarrollo con agentes IA.
-
-Catálogo curado de frameworks, servidores MCP, skills y herramientas.
-Funciona offline. Opcionalmente extiende con búsqueda en GitHub (--github).
-
-Usage:
-  python3 .agentic/scripts/aitmpl-search.py "fastapi"
-  python3 .agentic/scripts/aitmpl-search.py "mcp postgres"
-  python3 .agentic/scripts/aitmpl-search.py --category mcp-server
-  python3 .agentic/scripts/aitmpl-search.py --list-categories
-  python3 .agentic/scripts/aitmpl-search.py "rails" --github
-  python3 .agentic/scripts/aitmpl-search.py --json "claude"
-"""
-from __future__ import annotations
-
-import argparse
-import json
-import os
-import sys
-import time
-import textwrap
-import urllib.error
-import urllib.parse
-import urllib.request
-from pathlib import Path
-from typing import Optional
-
-# ---------------------------------------------------------------------------
-# Catálogo curado
-# Campos: name, description, category, tags, url, language
-#
-# Categorías:
-#   framework     — frameworks de desarrollo con agentes IA
-#   mcp-server    — servidores Model Context Protocol
-#   skill         — skills/comandos para Claude Code
-#   tool          — herramientas de CLI o automatización
-#   profile       — profiles de stack para forge
-#   resource      — documentación, listas y guías
-# ---------------------------------------------------------------------------
-
-CATALOG: list[dict] = [
-
-    # ── Frameworks ──────────────────────────────────────────────────────────
-
-    {
-        "name":        "cristiancorreau/forge",
-        "description": "Framework de desarrollo con agentes IA para equipos. Profiles para Next.js, Astro, FastAPI, Rails, NestJS, Express, Expo y más. Wizard CLI interactivo.",
-        "category":    "framework",
-        "tags":        ["claude-code", "agents", "typescript", "python", "ruby", "nextjs", "astro", "fastapi", "rails", "nestjs", "express", "expo"],
-        "url":         "https://github.com/cristiancorreau/forge",
-        "language":    "Python",
-    },
-    {
-        "name":        "paul-gauthier/aider",
-        "description": "Pair programming con LLMs en la terminal. Soporta Claude, GPT-4, Gemini. Edita archivos directamente y hace commits automáticos.",
-        "category":    "framework",
-        "tags":        ["claude", "gpt4", "pair-programming", "git", "terminal"],
-        "url":         "https://github.com/paul-gauthier/aider",
-        "language":    "Python",
-    },
-    {
-        "name":        "BuilderIO/micro-agent",
-        "description": "Agente IA que escribe código hasta que los tests pasan. TDD automático: genera código iterativamente hasta lograr green tests.",
-        "category":    "framework",
-        "tags":        ["tdd", "testing", "code-generation", "claude", "openai"],
-        "url":         "https://github.com/BuilderIO/micro-agent",
-        "language":    "TypeScript",
-    },
-    {
-        "name":        "anthropics/anthropic-quickstarts",
-        "description": "Quickstarts oficiales de Anthropic: customer support agent, computer use, multi-agent portfolio. Ejemplos de referencia.",
-        "category":    "framework",
-        "tags":        ["claude", "anthropic", "multi-agent", "computer-use", "quickstart"],
-        "url":         "https://github.com/anthropics/anthropic-quickstarts",
-        "language":    "Python",
-    },
-    {
-        "name":        "anthropics/claude-code-action",
-        "description": "GitHub Action oficial para usar Claude Code en CI/CD. Permite que Claude revise PRs, corrija bugs y responda issues automáticamente.",
-        "category":    "framework",
-        "tags":        ["claude-code", "github-actions", "ci-cd", "pr-review"],
-        "url":         "https://github.com/anthropics/claude-code-action",
-        "language":    "TypeScript",
-    },
-
-    # ── MCP Servers — oficiales ──────────────────────────────────────────────
-
-    {
-        "name":        "MCP — filesystem",
-        "description": "Acceso seguro al sistema de archivos local con control de directorios permitidos. Leer, escribir, listar y buscar archivos.",
-        "category":    "mcp-server",
-        "tags":        ["filesystem", "files", "read", "write", "mcp", "oficial"],
-        "url":         "https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "filesystem",
-            "command": "npx",
-            "args": ["-y", "@modelcontextprotocol/server-filesystem", "{ALLOWED_DIR}"],
-            "params": [{"key": "ALLOWED_DIR", "label": "Directorio permitido", "default": "."}],
-            "env": [],
-        },
-    },
-    {
-        "name":        "MCP — git",
-        "description": "Operaciones git: leer historial, diffs, commits, branches y status. Integración completa con repositorios git locales.",
-        "category":    "mcp-server",
-        "tags":        ["git", "version-control", "commits", "diff", "mcp", "oficial"],
-        "url":         "https://github.com/modelcontextprotocol/servers/tree/main/src/git",
-        "language":    "Python",
-        "install": {
-            "slug": "git",
-            "command": "uvx",
-            "args": ["mcp-server-git", "--repository", "{REPO_PATH}"],
-            "params": [{"key": "REPO_PATH", "label": "Ruta del repositorio git", "default": "."}],
-            "env": [],
-        },
-    },
-    {
-        "name":        "MCP — github",
-        "description": "Integración con la API de GitHub: repos, issues, PRs, branches, commits, búsqueda de código. Requiere GITHUB_TOKEN.",
-        "category":    "mcp-server",
-        "tags":        ["github", "issues", "pull-requests", "api", "mcp", "oficial"],
-        "url":         "https://github.com/modelcontextprotocol/servers/tree/main/src/github",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "github",
-            "command": "npx",
-            "args": ["-y", "@modelcontextprotocol/server-github"],
-            "params": [],
-            "env": [{"key": "GITHUB_TOKEN", "label": "GitHub personal access token (ghp_...)"}],
-        },
-    },
-    {
-        "name":        "MCP — postgres",
-        "description": "Acceso read-only a bases de datos PostgreSQL. Ejecutar queries, explorar schemas y tablas. Ideal para análisis de datos.",
-        "category":    "mcp-server",
-        "tags":        ["postgres", "postgresql", "database", "sql", "mcp", "oficial"],
-        "url":         "https://github.com/modelcontextprotocol/servers/tree/main/src/postgres",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "postgres",
-            "command": "npx",
-            "args": ["-y", "@modelcontextprotocol/server-postgres", "{CONNECTION_STRING}"],
-            "params": [{"key": "CONNECTION_STRING", "label": "PostgreSQL connection string", "default": "postgresql://localhost/mydb"}],
-            "env": [],
-        },
-    },
-    {
-        "name":        "MCP — sqlite",
-        "description": "Interacción con bases de datos SQLite: queries, introspección de schema, gestión de datos. Memo de conocimiento incorporado.",
-        "category":    "mcp-server",
-        "tags":        ["sqlite", "database", "sql", "local", "mcp", "oficial"],
-        "url":         "https://github.com/modelcontextprotocol/servers/tree/main/src/sqlite",
-        "language":    "Python",
-        "install": {
-            "slug": "sqlite",
-            "command": "uvx",
-            "args": ["mcp-server-sqlite", "--db-path", "{DB_PATH}"],
-            "params": [{"key": "DB_PATH", "label": "Ruta del archivo SQLite", "default": "./data.db"}],
-            "env": [],
-        },
-    },
-    {
-        "name":        "MCP — fetch",
-        "description": "Fetch de URLs y conversión a Markdown. Permite a Claude leer páginas web, documentación y APIs HTTP.",
-        "category":    "mcp-server",
-        "tags":        ["http", "fetch", "web", "scraping", "markdown", "mcp", "oficial"],
-        "url":         "https://github.com/modelcontextprotocol/servers/tree/main/src/fetch",
-        "language":    "Python",
-        "install": {
-            "slug": "fetch",
-            "command": "uvx",
-            "args": ["mcp-server-fetch"],
-            "params": [],
-            "env": [],
-        },
-    },
-    {
-        "name":        "MCP — brave-search",
-        "description": "Búsqueda web con Brave Search API. Web search y local search con privacidad. Requiere BRAVE_API_KEY.",
-        "category":    "mcp-server",
-        "tags":        ["search", "web-search", "brave", "internet", "mcp", "oficial"],
-        "url":         "https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "brave-search",
-            "command": "npx",
-            "args": ["-y", "@modelcontextprotocol/server-brave-search"],
-            "params": [],
-            "env": [{"key": "BRAVE_API_KEY", "label": "Brave Search API key"}],
-        },
-    },
-    {
-        "name":        "MCP — slack",
-        "description": "Integración con Slack: enviar mensajes, leer canales, gestionar usuarios. Requiere Slack Bot Token.",
-        "category":    "mcp-server",
-        "tags":        ["slack", "messaging", "communication", "mcp", "oficial"],
-        "url":         "https://github.com/modelcontextprotocol/servers/tree/main/src/slack",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "slack",
-            "command": "npx",
-            "args": ["-y", "@modelcontextprotocol/server-slack"],
-            "params": [],
-            "env": [
-                {"key": "SLACK_BOT_TOKEN", "label": "Slack Bot Token (xoxb-...)"},
-                {"key": "SLACK_TEAM_ID",   "label": "Slack Team ID"},
-            ],
-        },
-    },
-    {
-        "name":        "MCP — puppeteer",
-        "description": "Automatización de browser con Puppeteer: navegar, hacer screenshots, rellenar formularios y ejecutar JavaScript.",
-        "category":    "mcp-server",
-        "tags":        ["puppeteer", "browser", "automation", "screenshot", "scraping", "mcp", "oficial"],
-        "url":         "https://github.com/modelcontextprotocol/servers/tree/main/src/puppeteer",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "puppeteer",
-            "command": "npx",
-            "args": ["-y", "@modelcontextprotocol/server-puppeteer"],
-            "params": [],
-            "env": [],
-        },
-    },
-    {
-        "name":        "MCP — sequential-thinking",
-        "description": "Herramienta de razonamiento paso a paso con revisión y backtracking. Para problemas complejos que requieren análisis estructurado.",
-        "category":    "mcp-server",
-        "tags":        ["reasoning", "thinking", "analysis", "chain-of-thought", "mcp", "oficial"],
-        "url":         "https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "sequential-thinking",
-            "command": "npx",
-            "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"],
-            "params": [],
-            "env": [],
-        },
-    },
-    {
-        "name":        "MCP — memory",
-        "description": "Grafo de conocimiento persistente. Claude puede guardar y recuperar información entre conversaciones con entidades y relaciones.",
-        "category":    "mcp-server",
-        "tags":        ["memory", "knowledge-graph", "persistence", "mcp", "oficial"],
-        "url":         "https://github.com/modelcontextprotocol/servers/tree/main/src/memory",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "memory",
-            "command": "npx",
-            "args": ["-y", "@modelcontextprotocol/server-memory"],
-            "params": [],
-            "env": [],
-        },
-    },
-    {
-        "name":        "MCP — everything",
-        "description": "Servidor MCP de referencia con prompts, tools y resources de ejemplo. Útil para probar clientes MCP y aprender el protocolo.",
-        "category":    "mcp-server",
-        "tags":        ["reference", "testing", "demo", "mcp", "oficial"],
-        "url":         "https://github.com/modelcontextprotocol/servers/tree/main/src/everything",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "everything",
-            "command": "npx",
-            "args": ["-y", "@modelcontextprotocol/server-everything"],
-            "params": [],
-            "env": [],
-        },
-    },
-
-    # ── MCP Servers — comunidad ───────────────────────────────────────────────
-
-    {
-        "name":        "MCP — supabase (comunidad)",
-        "description": "Integración con Supabase: ejecutar queries SQL, gestionar tablas, auth y storage via MCP.",
-        "category":    "mcp-server",
-        "tags":        ["supabase", "postgres", "database", "auth", "storage", "mcp"],
-        "url":         "https://github.com/supabase-community/supabase-mcp",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "supabase",
-            "command": "npx",
-            "args": ["-y", "@supabase/mcp-server-supabase", "--access-token", "{ACCESS_TOKEN}"],
-            "params": [{"key": "ACCESS_TOKEN", "label": "Supabase personal access token"}],
-            "env": [],
-        },
-    },
-    {
-        "name":        "MCP — Cloudflare",
-        "description": "Gestión de Workers, KV, R2, D1, AI Gateway y Vectorize de Cloudflare via MCP. Oficial de Cloudflare.",
-        "category":    "mcp-server",
-        "tags":        ["cloudflare", "workers", "kv", "r2", "d1", "edge", "mcp"],
-        "url":         "https://github.com/cloudflare/mcp-server-cloudflare",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "cloudflare",
-            "command": "npx",
-            "args": ["-y", "@cloudflare/mcp-server-cloudflare"],
-            "params": [],
-            "env": [{"key": "CLOUDFLARE_API_TOKEN", "label": "Cloudflare API token"}],
-        },
-    },
-    {
-        "name":        "MCP — Vercel",
-        "description": "Gestión de proyectos, deploys, dominios y logs de Vercel via MCP. Integración oficial.",
-        "category":    "mcp-server",
-        "tags":        ["vercel", "deploy", "serverless", "hosting", "mcp"],
-        "url":         "https://github.com/vercel/mcp-server",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "vercel",
-            "command": "npx",
-            "args": ["-y", "@vercel/mcp-adapter"],
-            "params": [],
-            "env": [{"key": "VERCEL_TOKEN", "label": "Vercel API token"}],
-        },
-    },
-    {
-        "name":        "MCP — Linear",
-        "description": "Integración con Linear: crear y consultar issues, proyectos y cycles. Para equipos que usan Linear como tracker.",
-        "category":    "mcp-server",
-        "tags":        ["linear", "project-management", "issues", "mcp"],
-        "url":         "https://github.com/linear/linear-mcp",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "linear",
-            "command": "npx",
-            "args": ["-y", "@linear/mcp-server"],
-            "params": [],
-            "env": [{"key": "LINEAR_API_KEY", "label": "Linear API key"}],
-        },
-    },
-    {
-        "name":        "MCP — Playwright",
-        "description": "Automatización de browser con Playwright via MCP. Navegación, screenshots, testing E2E e interacción con páginas web.",
-        "category":    "mcp-server",
-        "tags":        ["playwright", "browser", "e2e", "testing", "automation", "mcp"],
-        "url":         "https://github.com/microsoft/playwright-mcp",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "playwright",
-            "command": "npx",
-            "args": ["-y", "@playwright/mcp@latest"],
-            "params": [],
-            "env": [],
-        },
-    },
-    {
-        "name":        "MCP — Sentry",
-        "description": "Consulta issues, eventos y trazas de Sentry. Permite a Claude diagnosticar errores de producción directamente.",
-        "category":    "mcp-server",
-        "tags":        ["sentry", "errors", "monitoring", "debugging", "mcp"],
-        "url":         "https://github.com/getsentry/sentry-mcp",
-        "language":    "Python",
-        "install": {
-            "slug": "sentry",
-            "command": "uvx",
-            "args": ["mcp-server-sentry"],
-            "params": [],
-            "env": [{"key": "SENTRY_AUTH_TOKEN", "label": "Sentry auth token"}],
-        },
-    },
-    {
-        "name":        "MCP — Docker",
-        "description": "Gestión de contenedores, imágenes y volúmenes Docker via MCP. Ejecutar y gestionar el ciclo de vida de containers.",
-        "category":    "mcp-server",
-        "tags":        ["docker", "containers", "devops", "infrastructure", "mcp"],
-        "url":         "https://github.com/ckreiling/mcp-server-docker",
-        "language":    "Python",
-        "install": {
-            "slug": "docker",
-            "command": "uvx",
-            "args": ["mcp-server-docker"],
-            "params": [],
-            "env": [],
-        },
-    },
-    {
-        "name":        "MCP — AWS (aws-kb-retrieval)",
-        "description": "Retrieval desde AWS Knowledge Base. Para proyectos en AWS que usan Bedrock Knowledge Bases.",
-        "category":    "mcp-server",
-        "tags":        ["aws", "bedrock", "knowledge-base", "rag", "mcp", "oficial"],
-        "url":         "https://github.com/modelcontextprotocol/servers/tree/main/src/aws-kb-retrieval-server",
-        "language":    "TypeScript",
-        "install": {
-            "slug": "aws-kb",
-            "command": "npx",
-            "args": ["-y", "@modelcontextprotocol/server-aws-kb-retrieval"],
-            "params": [],
-            "env": [
-                {"key": "AWS_ACCESS_KEY_ID",     "label": "AWS Access Key ID"},
-                {"key": "AWS_SECRET_ACCESS_KEY",  "label": "AWS Secret Access Key"},
-                {"key": "AWS_REGION",             "label": "AWS Region", "default": "us-east-1"},
-            ],
-        },
-    },
-
-    # ── Profiles de forge ─────────────────────────────────────────────────────
-
-    {
-        "name":        "forge profile — hono-drizzle",
-        "description": "Agente api-engineer especializado en Hono + Drizzle ORM + TypeScript. Incluye rutas, schemas, migraciones y tests.",
-        "category":    "profile",
-        "tags":        ["hono", "drizzle", "typescript", "api", "orm", "edge"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/hono-drizzle",
-        "language":    "TypeScript",
-    },
-    {
-        "name":        "forge profile — nextjs-admin",
-        "description": "Agente admin-engineer para dashboards con Next.js 15 + shadcn/ui. Componentes, tablas de datos y gestión interna.",
-        "category":    "profile",
-        "tags":        ["nextjs", "shadcn", "react", "dashboard", "admin", "typescript"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/nextjs-admin",
-        "language":    "TypeScript",
-    },
-    {
-        "name":        "forge profile — astro",
-        "description": "Agente frontend-engineer para sitios con Astro. SSG/SSR, islands architecture, Content Collections y Tailwind.",
-        "category":    "profile",
-        "tags":        ["astro", "ssg", "ssr", "islands", "typescript", "tailwind", "static"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/astro",
-        "language":    "TypeScript",
-    },
-    {
-        "name":        "forge profile — fastapi",
-        "description": "Agente api-engineer para FastAPI + Python. Endpoints async, Pydantic schemas, SQLAlchemy y pytest.",
-        "category":    "profile",
-        "tags":        ["fastapi", "python", "async", "pydantic", "sqlalchemy", "pytest"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/fastapi",
-        "language":    "Python",
-    },
-    {
-        "name":        "forge profile — rails",
-        "description": "Agente fullstack-engineer para Ruby on Rails. Modelos, migraciones, controllers, views y RSpec.",
-        "category":    "profile",
-        "tags":        ["rails", "ruby", "activerecord", "rspec", "fullstack"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/rails",
-        "language":    "Ruby",
-    },
-    {
-        "name":        "forge profile — nestjs",
-        "description": "Agente api-engineer para NestJS + TypeScript. Módulos, guards, decorators y arquitectura escalable.",
-        "category":    "profile",
-        "tags":        ["nestjs", "typescript", "node", "api", "modules", "guards"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/nestjs",
-        "language":    "TypeScript",
-    },
-    {
-        "name":        "forge profile — express",
-        "description": "Agente api-engineer para Express + Node.js + TypeScript. Middleware, rutas, validación y Jest.",
-        "category":    "profile",
-        "tags":        ["express", "nodejs", "typescript", "middleware", "api"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/express",
-        "language":    "TypeScript",
-    },
-    {
-        "name":        "forge profile — expo",
-        "description": "Agente mobile-engineer para React Native con Expo. Navegación, componentes nativos y EAS.",
-        "category":    "profile",
-        "tags":        ["expo", "react-native", "mobile", "ios", "android", "typescript"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/expo",
-        "language":    "TypeScript",
-    },
-    {
-        "name":        "forge profile — playwright-crawler",
-        "description": "Agente scanner-engineer para scraping y crawling con Playwright. Extracción de datos, screenshots y automatización.",
-        "category":    "profile",
-        "tags":        ["playwright", "scraping", "crawler", "browser", "automation", "typescript"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/playwright-crawler",
-        "language":    "TypeScript",
-    },
-    {
-        "name":        "forge profile — django",
-        "description": "Agente api-engineer para Django 4.x + DRF + PostgreSQL + pytest-django. Modelos, migraciones, serializers, viewsets y tests.",
-        "category":    "profile",
-        "tags":        ["django", "python", "drf", "postgresql", "rest-api", "pytest"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/django",
-        "language":    "Python",
-    },
-    {
-        "name":        "forge profile — vuenuxt",
-        "description": "Agente frontend-engineer para Nuxt 3 + Vue 3 + Pinia + TypeScript. Pages, componentes, composables y SSR.",
-        "category":    "profile",
-        "tags":        ["nuxt", "vue", "typescript", "pinia", "ssr", "tailwind"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/vuenuxt",
-        "language":    "TypeScript",
-    },
-    {
-        "name":        "forge profile — go-gin",
-        "description": "Agente api-engineer para Go + Gin/Echo + sqlc + PostgreSQL + testify. Handlers, services, repositories e migrations.",
-        "category":    "profile",
-        "tags":        ["go", "golang", "gin", "echo", "sqlc", "postgresql", "rest-api"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/go-gin",
-        "language":    "Go",
-    },
-    {
-        "name":        "forge profile — sveltekit",
-        "description": "Agente frontend-engineer para SvelteKit 2 + Svelte 5 + TypeScript + Tailwind. Routes, components, load functions y form actions.",
-        "category":    "profile",
-        "tags":        ["sveltekit", "svelte", "typescript", "tailwind", "ssr", "vite"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/sveltekit",
-        "language":    "TypeScript",
-    },
-    {
-        "name":        "forge profile — laravel",
-        "description": "Tres agentes para proyectos Laravel: api-engineer (Sanctum + Eloquent + Form Requests), fullstack-engineer (Blade + Livewire 3 o Inertia) y migration-specialist (upgrade L6→L13 paso a paso con breaking changes por versión).",
-        "category":    "profile",
-        "tags":        ["laravel", "php", "eloquent", "sanctum", "livewire", "blade", "inertia", "migration", "upgrade"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/laravel",
-        "language":    "PHP",
-    },
-    {
-        "name":        "forge profile — wordpress",
-        "description": "Tres agentes para proyectos WordPress: wp-engineer (FSE + bloques Gutenberg + Interactivity API + WP REST API), divi-engineer (Divi Theme Builder + módulos ET_Builder_Module + Dynamic Content) y elementor-engineer (Elementor Pro + widgets personalizados + Dynamic Tags + Loop Grid).",
-        "category":    "profile",
-        "tags":        ["wordpress", "php", "gutenberg", "fse", "divi", "elementor", "page-builder", "blocks", "theme-builder"],
-        "url":         "https://github.com/cristiancorreau/forge/tree/main/profiles/wordpress",
-        "language":    "PHP",
-    },
-
-    # ── Tools ────────────────────────────────────────────────────────────────
-
-    {
-        "name":        "anthropics/claude-code (CLI)",
-        "description": "Claude Code oficial — CLI para desarrollo con agentes IA directamente en la terminal. Instalación: npm i -g @anthropic-ai/claude-code",
-        "category":    "tool",
-        "tags":        ["claude-code", "cli", "terminal", "official"],
-        "url":         "https://docs.anthropic.com/claude-code",
-        "language":    "TypeScript",
-    },
-    {
-        "name":        "modelcontextprotocol/inspector",
-        "description": "Inspector visual para servidores MCP. Permite probar y depurar servers MCP en una interfaz web interactiva.",
-        "category":    "tool",
-        "tags":        ["mcp", "debugging", "inspector", "testing", "development"],
-        "url":         "https://github.com/modelcontextprotocol/inspector",
-        "language":    "TypeScript",
-    },
-
-    # ── Resources ─────────────────────────────────────────────────────────────
-
-    {
-        "name":        "modelcontextprotocol/servers (todos)",
-        "description": "Repositorio oficial con todos los servers MCP de referencia: filesystem, git, github, postgres, sqlite, fetch, slack, puppeteer, memory y más.",
-        "category":    "resource",
-        "tags":        ["mcp", "servers", "reference", "official"],
-        "url":         "https://github.com/modelcontextprotocol/servers",
-        "language":    "TypeScript",
-    },
-    {
-        "name":        "punkpeye/awesome-mcp-servers",
-        "description": "Lista curada de servidores MCP de la comunidad. Cubre bases de datos, APIs, herramientas de desarrollo, comunicación y más.",
-        "category":    "resource",
-        "tags":        ["mcp", "awesome", "curated", "list", "community"],
-        "url":         "https://github.com/punkpeye/awesome-mcp-servers",
-        "language":    "",
-    },
-    {
-        "name":        "Documentación oficial MCP",
-        "description": "Documentación del Model Context Protocol: guías para construir servers y clients, especificación del protocolo y ejemplos.",
-        "category":    "resource",
-        "tags":        ["mcp", "docs", "specification", "protocol", "official"],
-        "url":         "https://modelcontextprotocol.io",
-        "language":    "",
-    },
-    {
-        "name":        "Documentación Claude Code",
-        "description": "Docs oficiales de Claude Code: hooks, slash commands, configuración de agentes, CLAUDE.md, MCP y más.",
-        "category":    "resource",
-        "tags":        ["claude-code", "docs", "hooks", "agents", "official"],
-        "url":         "https://docs.anthropic.com/claude-code",
-        "language":    "",
-    },
-]
-
-CATEGORIES = sorted(set(t["category"] for t in CATALOG))
-
-# ---------------------------------------------------------------------------
-# Búsqueda local
-# ---------------------------------------------------------------------------
-
-def _search_local(query: str, category: Optional[str] = None) -> list[dict]:
-    terms = query.lower().split() if query else []
-    results = []
-    for item in CATALOG:
-        if category and item["category"] != category:
-            continue
-        if not terms:
-            results.append((0, item))
-            continue
-        haystack = " ".join([
-            item["name"],
-            item["description"],
-            item["category"],
-            " ".join(item["tags"]),
-            item.get("language", ""),
-        ]).lower()
-        score = sum(1 for t in terms if t in haystack)
-        if score > 0:
-            results.append((score, item))
-
-    results.sort(key=lambda x: x[0], reverse=True)
-    return [x[1] for x in results]
-
-
-# ---------------------------------------------------------------------------
-# GitHub API (opcional, --github)
-# ---------------------------------------------------------------------------
-
-CACHE_FILE = Path.home() / ".forge" / "template-search-cache.json"
-CACHE_TTL  = 1800
-
-
-def _cache_load() -> dict:
-    if not CACHE_FILE.exists():
-        return {}
-    try:
-        with open(CACHE_FILE) as f:
-            data = json.load(f)
-        if time.time() - data.get("_ts", 0) > CACHE_TTL:
-            return {}
-        return data
-    except (json.JSONDecodeError, OSError):
-        return {}
-
-
-def _cache_save(data: dict) -> None:
-    CACHE_FILE.parent.mkdir(parents=True, exist_ok=True)
-    data["_ts"] = time.time()
-    try:
-        with open(CACHE_FILE, "w") as f:
-            json.dump(data, f)
-    except OSError:
-        pass
-
-
-def _fetch_github(query: str, limit: int) -> list[dict]:
-    cache     = _cache_load()
-    cache_key = f"gh_{query}_{limit}"
-    if cache_key in cache:
-        return cache[cache_key]
-
-    topic_q = "topic:claude-code OR topic:mcp-server OR topic:ai-agent"
-    full_q  = urllib.parse.urlencode({
-        "q":        f"{query} ({topic_q})",
-        "sort":     "stars",
-        "order":    "desc",
-        "per_page": min(limit, 20),
-    })
-    url     = f"https://api.github.com/search/repositories?{full_q}"
-    headers = {
-        "Accept":     "application/vnd.github+json",
-        "User-Agent": "forge-template-search/2.0",
-    }
-    token = os.environ.get("GITHUB_TOKEN") or os.environ.get("GH_TOKEN")
-    if token:
-        headers["Authorization"] = f"Bearer {token}"
-
-    req = urllib.request.Request(url, headers=headers)
-    try:
-        with urllib.request.urlopen(req, timeout=10) as resp:
-            data = json.loads(resp.read().decode("utf-8"))
-    except urllib.error.HTTPError as e:
-        if e.code == 403:
-            print("  Límite de GitHub alcanzado. Exporta GITHUB_TOKEN para más requests.", file=sys.stderr)
-        return []
-    except (urllib.error.URLError, json.JSONDecodeError, OSError):
-        return []
-
-    results = []
-    for item in data.get("items", []):
-        results.append({
-            "name":        item.get("full_name", ""),
-            "description": item.get("description") or "",
-            "category":    "github",
-            "tags":        item.get("topics", []),
-            "url":         item.get("html_url", ""),
-            "language":    item.get("language") or "",
-            "stars":       item.get("stargazers_count", 0),
-        })
-
-    cache[cache_key] = results
-    _cache_save(cache)
-    return results
-
-
-# ---------------------------------------------------------------------------
-# Output
-# ---------------------------------------------------------------------------
-
-CATEGORY_LABELS = {
-    "framework":  "Framework",
-    "mcp-server": "MCP Server",
-    "skill":      "Skill",
-    "tool":       "Herramienta",
-    "profile":    "Profile forge",
-    "resource":   "Recurso",
-    "github":     "GitHub",
-}
-
-
-def _print_results(results: list[dict], as_json: bool) -> None:
-    if as_json:
-        print(json.dumps(results, ensure_ascii=False, indent=2))
-        return
-    if not results:
-        print("Sin resultados. Prueba con otro término o usa --list-categories.")
-        return
-    for i, t in enumerate(results, 1):
-        cat  = CATEGORY_LABELS.get(t.get("category", ""), t.get("category", ""))
-        name = t.get("name", "")
-        desc = t.get("description", "")
-        tags = t.get("tags", [])
-        url  = t.get("url", "")
-        lang = t.get("language", "")
-        stars = t.get("stars")
-
-        meta_parts = [f"[{cat}]"]
-        if lang:
-            meta_parts.append(lang)
-        if stars:
-            meta_parts.append(f"★ {stars:,}")
-        meta = "  ".join(meta_parts)
-
-        print(f"{i:>2}. {name}")
-        if desc:
-            for line in textwrap.wrap(desc, width=68, initial_indent="     ",
-                                      subsequent_indent="     "):
-                print(line)
-        if tags:
-            tag_str = "  ".join(f"#{t}" for t in tags[:8])
-            print(f"     {tag_str}")
-        print(f"     {meta}")
-        print(f"     {url}")
-        print()
-
-
-# ---------------------------------------------------------------------------
-# CLI
-# ---------------------------------------------------------------------------
-
-def main() -> None:
-    parser = argparse.ArgumentParser(
-        description="Busca templates y recursos para desarrollo con agentes IA.",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog=textwrap.dedent("""\
-            Ejemplos:
-              %(prog)s "fastapi"
-              %(prog)s "mcp postgres"
-              %(prog)s --category mcp-server
-              %(prog)s --category profile
-              %(prog)s "rails" --github
-              %(prog)s --list-categories
-        """),
-    )
-    parser.add_argument("query",            nargs="?", default="",
-                        help="Término de búsqueda")
-    parser.add_argument("--limit",          type=int, default=20, metavar="N",
-                        help="Máximo de resultados (default: 20)")
-    parser.add_argument("--json",           dest="as_json", action="store_true",
-                        help="Salida en JSON")
-    parser.add_argument("--category", "-c", metavar="CAT",
-                        help=f"Filtrar por categoría: {', '.join(CATEGORIES)}")
-    parser.add_argument("--github",         action="store_true",
-                        help="Extender con búsqueda en GitHub API (requiere red)")
-    parser.add_argument("--list-categories", action="store_true",
-                        help="Listar categorías disponibles y cantidad de items")
-
-    args = parser.parse_args()
-
-    if args.list_categories:
-        print("Categorías disponibles:\n")
-        for cat in CATEGORIES:
-            count = sum(1 for t in CATALOG if t["category"] == cat)
-            label = CATEGORY_LABELS.get(cat, cat)
-            print(f"  {cat:<16} {label}  ({count} items)")
-        print(f"\nTotal catálogo: {len(CATALOG)} items\n")
-        return
-
-    if not args.query and not args.category:
-        parser.print_help()
-        sys.exit(1)
-
-    results = _search_local(args.query, args.category)
-
-    if args.github and args.query:
-        print("Buscando en GitHub...", file=sys.stderr)
-        gh = _fetch_github(args.query, args.limit)
-        seen = {r["url"] for r in results}
-        for item in gh:
-            if item["url"] not in seen:
-                results.append(item)
-                seen.add(item["url"])
-
-    results = results[: args.limit]
-
-    if not args.as_json:
-        source = "catálogo local" + (" + GitHub" if args.github else "")
-        print(f"Resultados: {len(results)} ({source})\n", file=sys.stderr)
-
-    _print_results(results, args.as_json)
-
-
-if __name__ == "__main__":
-    main()