Claude Wiedii Plugins — Marketplace Centralizado por Equipos (diseño)

Esta nota es de diseño y decisiones. Para lo operativo, ver:

• Instalación / distribución / configuración → plugins-empresariales-distribucion-configuracion (managed settings de Claude Code, zips de Cowork, modelo de dependencias).
• Qué recibe cada usuario (skills, comandos, MCP) → catalogo-plugins-wiedii.

Resumen

• Funciona con GitLab. El marketplace de Claude Code soporta cualquier host Git (GitLab self-hosted incluido). No hay restricción a GitHub.
• Tiene auto-update, configurable por marketplace.
• El monorepo de plugins por equipo es el patrón correcto: un repo en GitLab con un plugin por área y un único marketplace.json que los cataloga.

Decisión clave: dos sistemas de marketplace

Sistema	Dónde	GitLab	Grupos	Para Wiedii
CLI Marketplace (/plugin marketplace add, managed settings)	Claude Code / Cowork	✅ cualquier host	n/a	✅ el que usamos
Org Admin Marketplace (Organization settings → Plugins)	Admin UI de Claude	❌ solo GitHub	⚠️ sin grupos	❌ (Wiedii es GitLab)

Por eso la distribución es vía managed settings (Claude Code) y zips de organización (Cowork) — detalle en plugins-empresariales-distribucion-configuracion.

Estructura del monorepo wildcat/claude-wiedii-plugins

.claude-plugin/marketplace.json     # catálogo (lista los plugins + allowCrossMarketplaceDependenciesOn)
plugins/
  wiedii-core/      # base TRANSVERSAL a toda la empresa
  wiedii-dev/       # Desarrollo (skills por stack + comandos + MCP + deps oficiales)
  wiedii-finance/   # Finanzas (esqueleto)
  wiedii-design/    # Diseño (esqueleto)
  engram/           # memoria persistente — VENDORIZADO (terceros), dependencia de wiedii-dev

Cada plugin tiene su .claude-plugin/plugin.json; los skills se autodescubren de skills/<nombre>/SKILL.md y los comandos de commands/*.md. Un plugin puede declarar dependencias de otros (incl. de otros marketplaces), que Claude Code auto-instala. El inventario vivo está en catalogo-plugins-wiedii.

Versionado y canales (main vs stable)

• Los plugins no fijan version: para fuentes git, Claude Code usa el SHA del commit como versión → cada cambio promovido es una versión nueva (compatible con la política de pins de Wiedii: el SHA es exacto y reproducible).
• stable es el canal por defecto para TODO el mundo (Desarrollo incluido); main es la rama de integración (donde aterrizan los MRs), no un canal de consumo.

Audiencia	Ref del marketplace	Recibe
Todos	stable	commit de main promovido: ≥3 días + revisado
Mantenedores (validar antes de promover)	main	el último cambio

• Consumir SIEMPRE stable (…git#stable en el add, o "ref": "stable" en settings). Sin #stable se baja main (la rama por defecto del repo es main) — la rama de integración, sin el retardo anti supply-chain.
• main es append-only y stable solo avanza por fast-forward (force-push deshabilitado) → el caché git de Claude nunca entra en conflicto (clave para no técnicos).
• Promoción (maintainer): git push origin <sha-main-≥3-días>:refs/heads/stable.
• Requisito macOS para Code/CLI: git en el PATH (xcode-select --install).

Qué puede contener cada plugin

skills/ (SKILL.md, portables entre herramientas AI) · commands/ (slash) · hooks (PreToolUse/PostToolUse…) · MCP servers (.mcp.json) · dependencias de otros plugins.

Portabilidad

El contenido de los SKILL.md es estándar abierto (Claude Code, Cursor, Codex CLI, etc.). El formato del plugin (plugin.json, commands, hooks) es específico de Claude Code.

Repo GitLab del marketplace

Campo	Valor
Project path	wildcat/claude-wiedii-plugins
Visibilidad	public
Rama por defecto	main (sin Git Flow — es configuración) · canal de consumo: stable

Referencias

• plugins-empresariales-distribucion-configuracion — instalación, managed settings, Cowork, dependencias (operativo).
• catalogo-plugins-wiedii — qué recibe cada usuario.
• prerequisitos-plugins-claude — binarios/MCP que deben estar instalados.
• Discover and install plugins · Create a plugin marketplace · Plugin dependencies
• politicas-core · stack-tecnologico · wiedii-configs