guidomodarelli/golfo-marketplace

> Multi-provider marketplace de skills y plugins para agentes AI.
> Soporta Claude Code, Codex y Hermes 🤖
## 📁 Estructura del repositorio
├── .claude-plugin/
│ └── marketplace.json # Registro de plugins para Claude Code
├── .agents/plugins/
│ └── marketplace.json # Registro de plugins para Codex
├── plugins/
│ └── /
│ ├── .claude-plugin/
│ │ └── plugin.json # Manifiesto del plugin para Claude Code
│ ├── .codex-plugin/
│ │ └── plugin.json # Manifiesto del plugin para Codex (si es compatible)
│ ├── plugin.json # Manifiesto portable Agent Plugins v1 (Hermes)
│ └── skills/
│ └── /
│ ├── SKILL.md # Definición del skill — requerido para cada skill
│ └── evals/
│ └── eval-config.json
└── skill-eval-runner/ # CLI para correr evals localmente
### 🔀 Implementaciones por proveedor (opcional)
Cuando un plugin requiere una implementación diferente por proveedor, usá subdirectorios en lugar de un skills/ compartido:
plugins/ /
├── claude/
│ ├── .claude-plugin/plugin.json
│ └── skills/
└── codex/
├── .codex-plugin/plugin.json
└── skills/
Cada registro luego referencia la ruta del subdirectorio de su proveedor (ej. ./plugins/ /codex).
## 🤖 Agent Ready multi-provider
plugins/golfo-kit/skills/agent-ready-setup prepara siempre los tres planos sin acoplar assets compartidos a un provider:
text
AGENTS.md # instrucciones canónicas
CLAUDE.md # raíz y subdirectorios: proxy exacto + regla
.claude/ # Agent Ready Score y configuración Claude
.agents/hooks/ # scripts de hooks compartidos por ambos providers
.agents/skills/ # skills compartidas y descubribles por Codex
.agents/rules/ # reglas compartidas
.codex/hooks.json # configuración de hooks específica Codex
.codex/.mcp.json # MCP específico Codex, solo si el stack publica mcp.json
Si CLAUDE.md ya contiene instrucciones, el setup las promueve a un AGENTS.md hermano y deja CLAUDE.md como copia exacta de assets/claude-proxy.md. Esto también aplica a .claude/CLAUDE.md y cualquier subnivel. Si ambos archivos existen y difieren, no sobrescribe ninguno y reporta conflicto para resolución manual. La normalización recursiva parte de la raíz Git y omite paths ignorados no trackeados, incluidos nodemodules/ y worktrees, sin perder archivos trackeados bajo esas rutas; los destinos explícitos .claude/, .agents/ y .codex/ se siguen preparando aunque estén ignorados. El bootstrap requiere ejecutarse dentro de un worktree Git y actualiza automáticamente golfo-marketplace para provider activo antes de proyectar assets.
Después de marketplace upgrade, la actualización global no reproyecta assets sobre proyectos ya preparados. La ejecución directa de agent-ready-setup y el hook canónico .agents/hooks/sync-marketplace.sh seleccionan la versión cacheada semver más nueva y actualizan los assets gestionados bajo .claude/, .agents/ y .codex/; ambos providers usan el mismo comportamiento con sus caches respectivas. La proyección recorre assets/common/ y assets/stacks/ /, incluyendo rules, agents, commands, skills, MCP y hooks; los hooks permanecen canónicos bajo .agents/hooks/, mientras .claude/ recibe symlinks para assets no-hook. El hook normaliza instrucciones mediante bootstrap.sh --normalize-only cuando la versión instalada lo soporta y ejecuta el merge semántico de AGENTS.md. La normalización ocurre desde la raíz Git e incluye .claude/CLAUDE.md; conflictos, symlinks y destinos inseguros se preservan y reportan. Muestra diffs, aplica templates sobre archivos regulares modificados y conserva su versión local en un directorio temporal externo al proyecto; output muestra path exacto para revisión o diff. También combina el template con los settings JSON y preserva sus campos custom. El merge IA de AGENTS.md conserva cambios compatibles; si falla o queda sin resolución, aplica template y guarda backup temporal. CLAUDE.md nunca se modifica directamente por el merge IA.