vibe-toolkit

claude-vibe-marketplace — caja central de vibecoding de Olé Life

Esta es la caja central de la plataforma de vibecoding de Olé Life. Distribuye, de forma versionada, todo lo compartido entre las apps creadas con ole-vibe-starter:

• 🧩 Plugin de Claude Code vibe-toolkit — comandos, skills, hooks de seguridad y el agente vibe-reviewer.
• 🤖 Guardrails — los 6 chequeos automáticos (Node puro, sin dependencias), usados tanto en local como en CI.
• ⚙️ Workflow de CI reusable — lo que corre GitHub Actions en cada app.
• 📚 Docs y las 10 reglas innegociables — fuente única, en plugins/vibe-toolkit/docs/ y el skill ole-rules.

⚠️ Este repo NO se clona por app. Las apps se "suscriben" vía el plugin + el workflow reusable. Clonarlo y copiarlo a una app rompe el modelo (vuelve la deriva).

Estructura

.claude-plugin/marketplace.json        # catálogo (lista el plugin vibe-toolkit)
plugins/vibe-toolkit/
  .claude-plugin/plugin.json           # name + version (el pin de versión)
  commands/                            # setup, deploy, vtv, add-page, add-component, enable-supabase
  skills/                              # ole-rules, sensitive-data-check, access-audit
  agents/vibe-reviewer.md
  hooks/hooks.json + hooks/scripts/    # pre-tool-warn, user-prompt-hint
  guardrails/                          # los 6 checks + _lib + check-all.mjs
  docs/                                # 00-vtv … 09-ci (en español)
.github/
  workflows/guardrails.reusable.yml    # CI que invocan las apps
  actions/sticky-comment/              # comentario sticky en PRs

Cómo lo usa una app

La plantilla ole-vibe-starter ya viene cableada. Cada app trae:

// .claude/settings.json
{
  "extraKnownMarketplaces": {
    "claude-vibe-marketplace": { "source": { "source": "github", "repo": "Olelife/claude-vibe-marketplace" } }
  },
  "enabledPlugins": { "vibe-toolkit@claude-vibe-marketplace": true }
}

# .github/workflows/guardrails.yml
jobs:
  guardrails:
    uses: Olelife/claude-vibe-marketplace/.github/workflows/guardrails.reusable.yml@v1
    secrets: inherit

Instalación manual (si hace falta): /plugin marketplace add Olelife/claude-vibe-marketplace → /plugin install vibe-toolkit@claude-vibe-marketplace. Actualizar: /plugin marketplace update.

Releases (⚠️ version lockstep)

Las apps reciben cambios solo cuando publicás una versión. Un release son dos cosas juntas, siempre:

1. Bump de version en plugins/vibe-toolkit/.claude-plugin/plugin.json (ej. 1.0.1).
2. Mover el tag v1 (mayor) al nuevo commit + crear el tag exacto (ej. v1.0.1).

git tag -f v1 && git tag v1.0.1 && git push -f origin v1 && git push origin v1.0.1

Si bumpeás uno y olvidás el otro, el plugin local y el CI pueden quedar en versiones distintas.

Setup a nivel organización (una sola vez)

• GitHub (org owner): Actions policy que permita workflows/actions internos de Olelife + ruleset de org que exija los checks VTV gate, Supabase schema, .env.example en main.
• Claude (admin console): managed-settings.json con extraKnownMarketplaces apuntando a este repo (garantiza presencia en toda la flota).
• Este repo (repo admin): Settings → Actions → Access → "Accessible from repositories in the Olelife organization".