Sistema de Plantillas Modulares para Claude Code

Ecosistema de plantillas claude-init-ready para construir agentes, skills, comandos, hooks, plugins, MCP servers, repositorios GitHub profesionales, y configuraciones .claude/ completas — con validación automática y CI/CD.

---

¿Qué es esto?

Un sistema de plantillas modulares que te permite inicializar, validar y mantener componentes de Claude Code en segundos.

Cada módulo sigue el mismo patrón:

• plantilla_X/ = playbook instructivo (¿qué pongo aquí?)
• ejemplo_X/ = referencia funcional (¿cómo se ve terminado?)
• validar_X.py = validador automático con --strict
• .github/workflows/ = CI/CD independiente

---

Módulos disponibles

Módulo	Descripción	Inicializar
🤖 Agentes	Orquestador hub-and-spoke con subagentes	claude-init --modulo agentes
🛠️ Skills	Skills auto-activables por descripción	claude-init --modulo skills
⌨️ Commands	Comandos slash (/deploy, /test)	claude-init --modulo commands
⚓ Hooks	Interceptores pre/post tool, save, error	claude-init --modulo hooks
🔌 Plugins	Empaquetado distribuible de componentes	claude-init --modulo plugins
🔗 MCP Servers	Servidores MCP con tools y recursos	claude-init --modulo mcp
📦 dot-claude	Configuración .claude/ completa	cp -r dot-claude/ejemplo_dot_claude ./.claude
🏛️ Repositorios	Repo GitHub profesional al 120%	claude-init --repositorio

Índice completo con estructura visual → INDEX.md

---

Instalación

curl -fsSL https://raw.githubusercontent.com/alexendros/plantillas/main/install.sh | bash

O manualmente:

git clone https://github.com/alexendros/plantillas.git ~/.claude/plantillas
cd ~/.claude/plantillas

---

Uso rápido

# Listar módulos disponibles
claude-init --list

# Inicializar un agente
claude-init --modulo agentes --nombre mi-agente

# Inicializar un repo GitHub profesional
claude-init --repositorio --nombre mi-proyecto

# Inicializar .claude/ en un proyecto existente
claude-init --proyecto

# Validar cualquier módulo
python agentes/validar_agente.py ~/.claude/agents/mi-agente --strict

---

Validación y CI/CD

• Motor reusable en validadores/: BaseValidator, checks reutilizables, reporte formateado.
• 8 validadores individuales, todos pasan --strict.
• 8 workflows de GitHub Actions + workflow central validar-todos.yml.
• Pre-commit hooks en .pre-commit-config.yaml: lint YAML/JSON, detectar placeholders, validar módulos.

---

Documentación clave

Documento	Para qué sirve
INDEX.md	Índice maestro completo con estructura visual
ROADMAP.md	Plan de desarrollo (4 fases)
CHANGELOG.md	Historia de versiones
CONTRIBUTING.md	Cómo añadir nuevos módulos
INTEGRACION.md	Cómo combinar módulos entre sí
CODE_OF_CONDUCT.md	Código de conducta

---

Stack

• Python 3.12+ — Validadores y motor reusable
• GitHub Actions — CI/CD
• pre-commit — Hooks de calidad
• pytest — Tests unitarios y smoke

---

Licencia

MIT © 2026 Alejandro · Iniciativas Alexendros