convez.ai
SkillDesenvolvimento WebIntermediário
VAMOO-AI

Claude Kit Mentorados

VAMOO-AI/claude-kit-mentorados

Kit de configuração e skills para Claude Code com regras de produção

Ver no GitHub
InicialPluginScore · de 0 a 100

Starter kit pronto para Claude Code com regras globais, 10 skills prontas, automações e templates de CI/Playwright. Instala-se em ~2 minutos e corrige três vícios comuns: testar sem verificar, mexer em arquivos desnecessários e inventar APIs. Pensado para uso em produção com método incluído.

Instalação

$npx convez-ai VAMOO-AI/claude-kit-mentorados

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
1
Acompanhando
0
Saúde
50%
Último commit
há 2 dias
Versão
v0.95.2
Issues abertas
1
Contribuidores
1

Casos de uso

  • Configurar Claude Code com regras de produção e boas práticas
  • Instalar skills prontas para segurança, deploy e integração com serviços (n8n, WhatsApp, CRM)
  • Estruturar projetos com testes e2e (Playwright) e CI automática

Veredito

Kit sólido e pragmático. Resolve problemas reais do uso de Claude em produção com regras e automações testadas. Recomendado para quem quer metodologia estruturada, não apenas prompts improvisados.

README

A tradução para o português deste README ainda está na fila.

🚀 Claude Starter Kit

CI License: MIT Release

A configuração de Claude Code que eu uso em projetos reais — regras, skills, automações e método — empacotada pra você instalar em ~2 minutos.

Sem o kit, o Claude "puro" tende a três vícios que queimam iniciante: diz que terminou sem testar, mexe em arquivo que você não pediu e inventa API que não existe. O kit instala as regras e skills que corrigem esses comportamentos — as mesmas que eu uso com clientes em produção, sanitizadas. E cada regra aqui existe porque preveniu ou corrigiu um bug real.

Pré-requisito: ter o Claude Code instalado e logado. Teste no terminal: claude --version. Se aparecer um número, você está pronto.


O que vem no kit

ArquivoVai pra ondePra que serve
templates/CLAUDE-global.md~/.claude/CLAUDE.mdSuas regras globais — valem em todo projeto. Como o Claude deve agir, verificar, commitar, proteger escopo. (Fica em templates/ pra não ser carregado como config de quem abre uma sessão dentro do clone do kit.)
AGENTS.md~/.claude/agents.mdRegras dos sub-agentes (quando o Claude dispara ajudantes em paralelo).
settings.json~/.claude/settings.jsonAtalhos e automações: idioma PT, lint/typecheck automático a cada edição, som ao terminar. É uma config produtiva (libera npm run, npm test, git read-only sem perguntar) — se preferir aprovar tudo, apague entradas da lista allow.
statusline-command.sh~/.claude/statusline-command.shBarra de status: diretório atual, branch git e quanto do contexto já foi usado.
skills/~/.claude/skills/10 skills (busca de docs, revisão de segurança, deploy, n8n/WhatsApp, VPS, CRM e mais). Ver a seção Skills incluídas abaixo.
commands/~/.claude/commands/Atalhos: /revisar (revisa seu diff) e /explicar (explica um código de forma didática).
docs/como-trabalhar-com-claude.md—Guia de leitura — como pedir bem, verificar e não se queimar. Comece por aqui.
templates/—Modelos pra copiar em projetos novos: CLAUDE.md de projeto, .env.example, .gitignore, CI, e playwright/ (testes e2e).
install.sh—O instalador que coloca tudo no lugar e instala o dot-context + ctx7.

Além disso o kit instala duas coisas que multiplicam o Claude:

  • superpowers — pacote de "skills" (TDD, debugging sistemático, brainstorming). O Claude passa a seguir métodos comprovados em vez de improvisar.
  • dot-context (ai-context) — dá ao Claude uma memória do projeto. Ele guarda documentação e contexto em .context/ dentro do seu projeto e relê toda sessão.

📖 Antes de tudo, leia docs/como-trabalhar-com-claude.md. É o que mais vai te ajudar — config sem método não adianta.


Skills incluídas

O instalador copia todas as skills abaixo. Algumas funcionam de cara; outras só fazem efeito depois que você liga um pré-requisito (uma API, um MCP, uma conta). Sem o pré-requisito a skill simplesmente não dispara — não quebra nada, só não faz nada.

✅ Prontas pra usar (sem setup extra)

SkillPra que servePré-requisito
find-docsBusca documentação oficial e atualizada antes de escrever código. Mata API inventada.nenhum (o instalador já põe o ctx7)
secscanRevisão de segurança read-only: RLS, secrets, deps vulneráveis. "roda um secscan". Ver docs/seguranca.md.nenhum
shipPipeline de release com gates (typecheck/lint/test → commit → push → PR).editar o passo de deploy pro seu stack
pipedrive-automationModelos de automação de CRM Pipedrive (deals, pipeline, relatórios).conta/API Pipedrive pra rodar de fato

⚙️ Exigem ligar um pré-requisito

SkillPra que servePré-requisito
n8n-workflow-agentConstruir/debugar workflows n8n com agentes de WhatsApp (UAZAPI, Chatwoot, etc.).instância n8n + API key, instância UAZAPI
notebooklmConsultar seus notebooks do Google NotebookLM com respostas citadas.login Google (auth via browser, 1ª vez)
notebooklm-project-opsCriar/sincronizar um notebook NotebookLM a partir das docs do projeto.CLI nlm ou MCP notebooklm + docs no projeto
agent-reportingRegistra progresso das tarefas no TickTick automaticamente.TickTick MCP configurado + token
vps-hardening-clientesRunbook anti-queda de VPS Docker Swarm + Traefik (bug Docker 27→29).é referência/receita — aplica numa VPS com essa stack
ambientes-clientesRunbook de setup de ambiente de cliente (GitHub + Vercel + Supabase) sem custo de seat.é referência — você segue o passo a passo

As skills de WhatsApp/VPS/CRM vêm de casos reais de produção, anonimizados. Os exemplos usam placeholders (<agente>, Cliente A, telefones fake) — troque pelos seus dados ao aplicar.

A skill notebooklm é vendorizada (copiada de um projeto de terceiro, em inglês — ver skills/notebooklm/ATTRIBUTION.md). Não edite os arquivos dela à mão: pra atualizar, re-vendorize do upstream.


Instalação (passo a passo)

1. Baixe o kit

git clone https://github.com/VAMOO-AI/claude-kit-mentorados.git claude-starter-kit
cd claude-starter-kit

2. Rode o instalador

bash install.sh

Ele copia os arquivos pro seu ~/.claude e instala o MCP dot-context. Antes de sobrescrever qualquer coisa (CLAUDE.md, agents.md, statusline, skills, comandos), ele salva uma cópia em ~/.claude/backup-kit-<data>/. Só o settings.json não é sobrescrito nunca — se você já tiver um, o modelo do kit fica em settings.kit.json pra mesclar à mão.

Quer ver o que ele faria antes de rodar de verdade?

bash install.sh --dry-run

3. Instale o superpowers (dentro do Claude Code)

Isso é um passo manual — abra o Claude Code e rode estes dois comandos:

/plugin marketplace add anthropics/claude-plugins-official
/plugin install superpowers@claude-plugins-official

4. Preencha o CLAUDE.md com os SEUS dados

Abra ~/.claude/CLAUDE.md e troque os trechos <entre-colchetes> (seu nome, sua stack, como você quer ser respondido). Apague o que não usar. Esse arquivo é seu — adapte à vontade.

5. Confira se deu certo

claude mcp list        # deve aparecer "ai-context ... ✓ Connected"

Abra o Claude Code e rode /help ou comece a digitar / — você deve ver skills do superpowers na lista. Pronto. 🎉


Como usar no dia a dia

  • Memória de projeto: num projeto novo, na primeira conversa, peça "init the context". O Claude cria a pasta .context/ e passa a lembrar do projeto.
  • Modo aprendizado: diga "explica" ou "modo aula" e o Claude passa a ensinar o porquê de cada coisa, passo a passo (definido no seu CLAUDE.md).
  • Skills: quando uma tarefa casa com uma skill (escrever testes, debugar um erro), o Claude usa o método certo sozinho. Você também pode pedir, ex.: "usa test-driven-development".

🌱 Iniciante vs ⚡ Avançado

O kit serve aos dois níveis. Comece pelo seu e cresça.

Iniciante — leia primeiro:

  1. docs/como-trabalhar-com-claude.md — o método.
  2. docs/memoria-e-contexto.md — como o Claude lembra: global vs projeto, o que vai no CLAUDE.md vs em docs/. (O tema que mais confunde.)
  3. docs/seguranca.md — os 5 furos que iniciante esquece (RLS, secrets, deps) + revisão automática.
  4. Use /explicar e /revisar, modo "explica", e a skill find-docs.

Avançado — quando já estiver confortável:

  1. docs/testes-e2e-com-playwright.md — testar o caminho do usuário de verdade (template em templates/playwright/).
  2. docs/programacao-avancada-com-claude.md — sub-agentes paralelos, worktrees, hooks, criar suas próprias skills.
  3. Skill /ship — pipeline de release com gates (typecheck/lint/test → commit → push → PR). Edite o passo de deploy com o comando do seu stack.
  4. templates/ci.yml — CI no GitHub Actions pra travar qualidade no PR.
  5. docs/mcps-recomendados.md — Playwright, GitHub e cia., sob demanda.
  6. templates/CLAUDE-projeto.md.exemplo — um CLAUDE.md por projeto.

Perguntas comuns

Já tinha um CLAUDE.md (ou skills, ou statusline), vou perder? Não. Tudo que o instalador sobrescreve ganha uma cópia em ~/.claude/backup-kit-<data>/ antes. Skills suas que não vieram do kit ficam intactas. O settings.json, se já existir, não é sobrescrito — o modelo do kit fica em settings.kit.json pra você comparar e mesclar.

Funciona no Windows? O kit foi pensado pra macOS/Linux. No Windows, use o WSL (Ubuntu) e rode os mesmos comandos. O som de "terminou" no settings.json é específico de Mac — pode remover a parte do afplay sem problema.

Posso desinstalar? Sim. Restaure seus arquivos de ~/.claude/backup-kit-<data>/ e rode claude mcp remove ai-context. Pra tirar o plugin: /plugin uninstall superpowers.


🎓 Quer ir além?

O kit é a base. O que multiplica de verdade é o método: como pedir bem, verificar de verdade, estruturar projeto e shipar com segurança — e isso eu trabalho de perto na mentoria, com projetos reais.

  • 📩 Me chama no Instagram: @ruanvamoo.ai
  • ⭐ O kit te ajudou? Deixa uma estrela no repo — é o que me diz que vale manter público.
  • 🐛 Achou um problema? Abre uma issue — feedback de quem está começando vale ouro aqui.

Bom proveito! 🤖

Ver o original no GitHub

Bom para

Relacionados