A-07
Marketplace de Claude Code del equipo
Marketplace privado de Claude Code para el equipo de VTEX de la agencia. Tres plugins que llevan metodología y guardarraíles, no conocimiento de plataforma.
| Cliente | Red Clover · equipo de VTEX |
|---|---|
| Tipo | tooling |
| Plataforma | Claude Code |
| Año | 2026 |
| Rol | Autor y mantenedor |
| Stack | Markdown · Node (hooks) · node --test · JSON Schema |
| Plugins | 3 plugins |
| Skills propias | 13 skills |
| Hooks | 5 |
| Líneas | 5.732 · 5.220 de .md + 480 de hooks .js |
| Commits propios | 57 de 57 |
Contexto
Somos varios trabajando sobre veintiséis repositorios de VTEX IO, cada uno con su cliente y sus convenciones. Claude Code entró al equipo y cada persona lo configuró como pudo: su propio CLAUDE.md, sus propias reglas, sus propios errores.
Opciones
Se podía escribir un documento largo con las convenciones del equipo y pedirle a todos que lo peguen en su configuración. Es lo que suele pasar y falla por dos motivos: nadie actualiza su copia, y un documento no puede impedir que se ejecute un comando.
Decisión
Un marketplace privado con tres plugins y un modelo de dos capas explícito.
Las cuarenta skills oficiales de VTEX cubren el conocimiento del producto: contratos de apps, builders, políticas, GraphQL, Master Data. Eso no lo tengo que escribir yo y no lo voy a mantener mejor que VTEX. Están instaladas y fijadas en una versión validada, porque una skill que se actualiza sola cambia de opinión sin avisarte.
Mis trece skills cubren lo que esa documentación no puede cubrir, porque no es de VTEX: el flujo de Git y de pull requests del equipo, las reglas de CSS con los gotchas que ya nos comimos, el chequeo contra el design system, el recipe de app de admin. Las dos capas conviven porque cada skill declara cuándo se carga.
Y cinco hooks, que es la parte que un documento no puede hacer. Dos son de bloqueo: ningún
agente ejecuta vtex deploy, publish, release, promote ni rollback, ni
gh pr create/merge/review --approve/ready. Los otros verifican el boilerplate al iniciar
sesión, chequean la versión de las skills oficiales e inyectan las convenciones del equipo.
Verificación
3 plugins, 13 skills, 5 hooks, 2 comandos, 5.732 líneas, 57 commits, y dos tests que validan el frontmatter de las skills y la coherencia del boilerplate.
Consecuencias
Mantener esto es trabajo real y tiene un modo de fallar propio: una skill puede envejecer sin avisar. Me pasó en julio de 2026 y está documentado en la errata. La respuesta no fue editar el archivo, fue instalar las dos verificaciones que ahora lo detectan.