dev-tools

cvz · dev-tools

La caja de herramientas de desarrollo de Carlos Villuendas para Claude Code.

cvz es un marketplace; dev-tools es su plugin: skills, agentes, comandos y hooks de propósito amplio que se instalan de una vez y crecen con el tiempo. Hoy empieza con handoff, la primera de muchas herramientas.

Herramientas

Skill	Invocación / Triggers	Qué hace
handoff	/dev-tools:handoff · "guarda el contexto", "lo retomo luego", "wrap up"	Captura el estado de la sesión en un documento autocontenido para que un agente con contexto fresco lo continúe sin redescubrir nada.

A medida que el plugin crezca, cada herramienta nueva añade una fila aquí.

Instalación

# Añadir el marketplace (desde GitHub o desde un directorio local)
/plugin marketplace add carlosvillu/cvz

# Instalar el plugin
/plugin install dev-tools@cvz

O para probar en local sin instalar:

claude --plugin-dir /Users/carlosvillu/Developer/session-handoff

Una vez instalado, las skills se invocan con el prefijo del plugin, p. ej. /dev-tools:handoff, o por sus frases trigger.

Ejemplo: handoff

Estás a mitad de una feature y el contexto se llena. En vez de perder el hilo:

/dev-tools:handoff

La skill reúne el estado del repo con git (solo lectura), escribe un handoff en .claude/handoffs/handoff-<timestamp>.md con las decisiones, los punteros a archivos y un prompt para retomar, y nunca hace commit. Mañana, un agente fresco abre ese archivo y continúa. Ver examples/handoff-feature-a-medias.md.

Filosofía

• Puntero, no transcripción — captura lo que no se puede reconstruir barato; apunta al resto.
• Cuenta una historia, no vuelques datos — el porqué de las decisiones importa más que los hechos.
• Mínimo deliberado — sin maquinaria que no se use; ver docs/AGENTS.md.

Estructura del repo

.
├── .claude-plugin/
│   ├── marketplace.json    # marketplace: cvz
│   └── plugin.json         # plugin: dev-tools (solo metadatos)
├── skills/<nombre>/SKILL.md # una carpeta por skill (descubrimiento por convención)
├── agents/                 # subagentes (futuro)
├── commands/               # slash-commands (futuro)
├── hooks/                  # hooks (futuro)
├── examples/               # casos de uso reales
├── tests/                  # smoke test de manifests (node --test)
├── docs/                   # CONTRIBUTING, AGENTS, plan de migración
└── .github/workflows/      # CI

Los manifiestos solo llevan metadatos; los componentes se descubren por carpetas. Añadir una herramienta = crear una carpeta. Ver docs/CONTRIBUTING.md.

Desarrollo

npm test                                  # smoke test de manifests
claude plugin validate .                  # validación estructural del plugin

Licencia

MIT