Claude-kit: Sistema de Gerenciamento de Configuração para Projetos de Código Claude

O que o claude-kit faz

Claude-kit é um sistema de gerenciamento de configurações para o Claude Code que cuida de todo o ciclo de vida do diretório .claude/. Não é uma ferramenta de inicialização única ou gerador estático de CLAUDE.md, mas um sistema que evolui junto com seus projetos.

Comandos e funcionalidades

A ferramenta oferece vários comandos:

• /forge init — Detecta automaticamente sua stack tecnológica (15 suportadas) e gera uma configuração completa do .claude/ incluindo CLAUDE.md, settings.json com listas de negação, regras contextuais com padrões glob, hooks (bloqueio de comandos destrutivos, lint ao salvar), 7 subagentes especializados e rastreamento de erros.
• /forge audit — Avalia sua configuração em uma escala de 10 pontos usando uma lista de verificação de 12 itens cobrindo segurança (listas de negação, bloqueio de comandos destrutivos), qualidade (regras, hooks de lint, agentes) e completude. Itens de segurança ausentes limitam sua pontuação a 6.0.
• /forge status — Painel de registro que acompanha pontuações em todos os seus projetos com gráficos de tendência.
• /forge bootstrap — Configuração interativa completa com prévia e confirmação para quando você quer mais controle.
• /forge sync — Atualiza configurações sem sobrescrever seu conteúdo personalizado, usando marcadores <!-- forge:section --> para separar seções gerenciadas de personalizações.

Principais recursos

• Empilhamento de tecnologias — Projetos com múltiplas stacks recebem todas as configurações correspondentes mescladas automaticamente (ex: Python + Docker + Redis + Supabase = 4 camadas combinadas)
• Sincronização de templates — Usa marcadores para separar seções gerenciadas de personalizações, permitindo atualizações sem sobrescrever seu conteúdo
• Pipeline de práticas — Sistema de melhoria contínua que captura padrões de sessões, documentação upstream e auditorias com estágios de ciclo de vida: caixa de entrada → avaliando → ativo → obsoleto
• 7 subagentes — pesquisador, arquiteto, implementador, revisor de código, auditor de segurança, executor de testes, revisor de sessão — com roteamento de modelos (haiku/sonnet/opus por tipo de tarefa)
• Templates de servidor MCP — Configurações prontas para uso para GitHub, Postgres, Supabase, Redis, Slack
• Registro entre projetos — Acompanha pontuações de auditoria com histórico em todos os projetos gerenciados

O que não é

• Não é código de aplicação — é tudo markdown + scripts shell, consumido diretamente pelo Claude Code
• Não é um gerador de CLAUDE.md — gerencia todo o ciclo de vida do diretório .claude/
• Não é uma ferramenta única — inicializa, sincroniza, audita e evolui com seus projetos

Tecnologias suportadas

15 stacks são suportadas: Python/FastAPI, React/Vite/TS, Swift/SwiftUI, Supabase, Docker, GCP Cloud Run, Redis, Node/Express, Java/Spring, AWS Deploy, Go, Análise de Dados, DevContainer, Trading, e um framework hookify para hooks personalizados.

Começando

git clone https://github.com/luiseiman/claude-kit.git
cd claude-kit
export CLAUDE_KIT_DIR="$(pwd)"
./global/sync.sh
# Então em qualquer projeto:
/forge init

O projeto tem licença MIT e está disponível no GitHub em https://github.com/luiseiman/claude-kit.