Claude-kit: Sistema de Gestión de Configuración para Proyectos de Código Claude

Qué hace claude-kit

Claude-kit es un sistema de gestión de configuración para Claude Code que maneja todo el ciclo de vida del directorio .claude/. No es una herramienta de arranque único ni un generador estático de CLAUDE.md, sino un sistema que evoluciona con tus proyectos.

Comandos y funcionalidad

La herramienta proporciona varios comandos:

• /forge init — Detecta automáticamente tu stack tecnológico (15 soportados) y genera una configuración completa de .claude/ incluyendo CLAUDE.md, settings.json con listas de denegación, reglas contextuales con patrones glob, hooks (bloqueo de comandos destructivos, lint al guardar), 7 subagentes especializados y seguimiento de errores.
• /forge audit — Evalúa tu configuración en una escala de 10 puntos usando una lista de verificación de 12 ítems que cubre seguridad (listas de denegación, bloqueo de comandos destructivos), calidad (reglas, hooks de lint, agentes) y completitud. Los elementos de seguridad faltantes limitan tu puntuación a 6.0.
• /forge status — Panel de registro que rastrea puntuaciones en todos tus proyectos con gráficos de tendencias.
• /forge bootstrap — Configuración interactiva completa con vista previa y confirmación para cuando quieres más control.
• /forge sync — Actualiza configuraciones sin sobrescribir tu contenido personalizado, usando marcadores <!-- forge:section --> para separar secciones gestionadas de personalizaciones.

Características principales

• Apilamiento de tecnologías — Los proyectos con múltiples stacks obtienen todas las configuraciones coincidentes fusionadas automáticamente (ej: Python + Docker + Redis + Supabase = 4 capas combinadas)
• Sincronización de plantillas — Usa marcadores para separar secciones gestionadas de personalizaciones, permitiendo actualizaciones sin sobrescribir tu contenido
• Canalización de prácticas — Sistema de mejora continua que captura patrones de sesiones, documentación upstream y auditorías con etapas de ciclo de vida: bandeja de entrada → evaluando → activo → obsoleto
• 7 subagentes — investigador, arquitecto, implementador, revisor de código, auditor de seguridad, ejecutor de pruebas, revisor de sesiones — con enrutamiento de modelos (haiku/sonnet/opus por tipo de tarea)
• Plantillas de servidor MCP — Configuraciones listas para usar para GitHub, Postgres, Supabase, Redis, Slack
• Registro entre proyectos — Rastrea puntuaciones de auditoría con historial en todos los proyectos gestionados

Qué no es

• No es código de aplicación — todo es markdown + scripts de shell, consumido directamente por Claude Code
• No es un generador de CLAUDE.md — gestiona todo el ciclo de vida del directorio .claude/
• No es una herramienta de un solo uso — arranca, sincroniza, audita y evoluciona con tus proyectos

Tecnologías soportadas

Se soportan 15 stacks: Python/FastAPI, React/Vite/TS, Swift/SwiftUI, Supabase, Docker, GCP Cloud Run, Redis, Node/Express, Java/Spring, AWS Deploy, Go, Análisis de Datos, DevContainer, Trading, y un framework hookify para hooks personalizados.

Comenzar

git clone https://github.com/luiseiman/claude-kit.git
cd claude-kit
export CLAUDE_KIT_DIR="$(pwd)"
./global/sync.sh
# Luego en cualquier proyecto:
/forge init

El proyecto tiene licencia MIT y está disponible en GitHub en https://github.com/luiseiman/claude-kit.