Seu time de IA,
pronto para trabalhar
HIVE é um harness para Claude Code que dá aos seus agentes memória persistente, estrutura de squads e skills reutilizáveis — para cada sessão começar com contexto, não do zero.
HIVE é uma estrutura de pastas e uma camada de convenções que faz o Claude Code se comportar como um time de especialistas. Sem lock-in de framework — apenas arquivos markdown, scripts Python e git.
Cada squad tem sua própria persona Claude, memória persistente (STATE.md), documentos de fundação, skills e workers. Quando você abre a pasta de um squad, o especialista correto carrega automaticamente.
- 11 squads pré-configurados (Comercial, Dev, Marketing, CS, Infra, Financeiro, Produto, Operacional, Qualidade, Inteligência, Orquestrador)
- Memória persistente — estado L1/L2/L3 por squad, sobrevive entre sessões
- 9 hooks de automação — branches de sessão, busca de conhecimento, sincronização de estado
- 50+ skills reutilizáveis — de gestão de issues a revisões multi-modelo com IA
- Workers determinísticos — scripts cron que atualizam o estado dos squads sem chamadas a LLM
- Multi-modelo via OpenRouter — segunda opinião, consenso, comparação de custo
- Zero dependência de nuvem — roda totalmente local, git é a única camada de sincronização
- Fork e adapte — renomeie personas, adicione squads, personalize por empresa
Instalação
Três passos. Sem gerenciador de pacotes necessário.
-
1
Clone o repositório
Substitua
minha-empresapelo nome da sua empresa. Faça um fork se quiser acompanhar as atualizações do upstream.macOS / LinuxWindowsgit clone https://github.com/felipeluissalgueiro/hive.git minha-empresa cd minha-empresa
git clone https://github.com/felipeluissalgueiro/hive.git minha-empresa cd minha-empresa
-
2
Abra no Claude Code
Abra a pasta
minha-empresa/no Claude Code (CLI, desktop ou extensão de IDE). O Claude Code lê oCLAUDE.mde carrega o orquestrador Stamper automaticamente.macOS / LinuxWindows# CLI claude # Ou abra minha-empresa/ no app desktop do Claude Code
# CLI claude # Ou abra minha-empresa/ no app desktop do Claude Code
-
3
Execute o setup
A skill de setup (~5–10 min) faz perguntas sobre sua empresa e configura cada squad com o contexto relevante.
/hive-setup # O que ela faz: # · Pergunta nome da empresa, setor, estágio # · Pergunta seu estilo de trabalho e preferências # · Deixa você escolher quais squads ativar # · Preenche os documentos de fundação com seu contexto # · Grava tudo nos arquivos corretos
Início Rápido
Abra um squad e comece a trabalhar.
# Abra um squad (carrega persona + STATE + fundação) /open-squad commercial # Trabalhe com Victor (Head of Sales)... # Feche o squad (atualiza STATE, propaga L1 para o orquestrador) /close-squad commercial # Veja o que está acontecendo em todos os squads /status # Busque incidentes passados antes de uma operação sensível python _core/lookup.py "deploy vercel"
Fluxo principal
| Comando | O que faz |
|---|---|
| /hive-setup | Sessão guiada de onboarding da empresa (primeira vez) |
| /open-squad <nome> | Carrega contexto do squad + STATE + documentos de fundação |
| /close-squad <nome> | Atualiza STATE + propaga L1 para a memória do orquestrador |
| /status | Agrega L1 de todos os squads ativos |
| /log-incident | Registra incidente no hub + Obsidian |
| /log-session | Encerra sessão com notas estruturadas |
Squads
11 agentes especialistas pré-configurados. Cada squad tem persona, escopo, memória e skills.
Quando você abre a pasta de um squad, o Claude Code carrega tanto o CLAUDE.md raiz (Stamper) quanto o CLAUDE.md do squad (especialista). Você tem duas personas em uma só sessão.
squads/<nome>/CLAUDE.md para refletir a cultura da sua empresa. O nome da persona só é referenciado dentro do próprio CLAUDE.md.
Sistema de Memória
STATE.md em três camadas — sobrevive entre sessões, pesquisável, agregável.
Todo squad mantém um memory/STATE.md com três camadas. L1 é projetada para ser legível por máquina e agregada pelo /status.
# squads/commercial/memory/STATE.md
[L1]
Victor (Commercial) — 3 leads quentes, 1 proposta aguardando revisão, pipeline $42k.
Última atualização: 2026-06-02 14:30
[L2]
Em andamento:
- Proposta para Acme Corp — enviar até sexta
- Ligação de follow-up com TechStartup agendada para sexta
- Atualizando perfil de ICP com aprendizados do Q2
[L3]
Backlog:
- Sequência de cold email para o segmento B
- Análise de concorrentes para o tier enterprise
Arquivos de memória por squad
| Arquivo | Finalidade |
|---|---|
| STATE.md | Estado operacional ao vivo — L1 (agora), L2 (em andamento), L3 (backlog) |
| decisions.md | Log de decisões arquiteturais e operacionais, append-only |
| gotchas.md | Armadilhas conhecidas, lições aprendidas, edge cases não óbvios |
| MEMORY.md | Índice de todos os arquivos de memória salvos com resumos de uma linha |
Busca de conhecimento
Antes de operações sensíveis (deploy, mudança de DNS, integração), pesquise incidentes e sessões anteriores:
# Busca em incidents + sessions + memory python _core/lookup.py "deploy vercel" # Filtrar por fonte python _core/lookup.py "ghl webhook" --source incidents python _core/lookup.py "auth" --source sessions --since 2026-01-01 # Saída JSON para scripts python _core/lookup.py "supabase" --json --top 5
Hooks
9 hooks de automação cuidam do gerenciamento de sessões, sincronização de estado e verificações de segurança.
| Hook | Gatilho | O que faz |
|---|---|---|
| PreToolUse — session branch | Primeiro write de arquivo na sessão | Cria branch session/YYYY-MM-DD-HHMM — sem commits diretos na main |
| PostToolUse — state flag | Após modificação de arquivo do squad | Marca STATE.md como dirty — usado pelo stop hook para decidir o que commitar |
| Stop — session merge | Sessão termina | Auto-commit na branch de sessão, merge para main, limpa a branch |
| UserPromptSubmit — routing | Cada mensagem do usuário | Detecta keywords de squad, carrega contexto se ainda não estiver carregado |
| UserPromptSubmit — knowledge | Keywords de operação sensível | Executa lookup.py — traz incidentes passados antes da ação |
| UserPromptSubmit — recovery | Início de sessão | Detecta sessão anterior inacabada, recupera contexto |
.claude/hooks/. São opt-in — desative qualquer hook removendo sua entrada do .claude/settings.json. Nunca faça force-push para a main; o stop hook depende de um histórico de branches limpo.
Workers
Scripts cron determinísticos que atualizam o estado dos squads sem IA no loop.
Os workers ficam em workers/ e rodam em schedule via _core/harness.sh. São Python puro — sem chamadas a LLM. Leem fontes de dados e escrevem no STATE.md.
Regras de design
- Determinístico — mesma entrada, mesma saída. Sem efeitos colaterais.
- Escreve somente no STATE.md — nunca em CLAUDE.md, skills ou documentos de fundação.
- Idempotente — seguro para rodar várias vezes.
- Falha em voz alta — registra erros, não engole exceções silenciosamente.
# _core/harness.sh — adicione workers aqui run_worker "workers/daily-revenue.py" "09:00" run_worker "workers/health-scores.py" "every:1h" run_worker "workers/competitor-scan.py" "every:24h"
Exemplos de workers
| Worker | Squad | Atualiza |
|---|---|---|
| daily-revenue.py | Finance | L1 com MRR atual e variação vs. mês anterior |
| health-scores.py | CS | L1 com contagens de churned, em risco e saudáveis |
| competitor-scan.py | Intelligence | L2 com novas menções a concorrentes e mudanças de preço |
| pipeline-summary.py | Commercial | L1 com valor do pipeline e contagem de leads quentes |
Skills Globais
50+ comandos reutilizáveis disponíveis para todos os squads. Invoque com /nome-da-skill.
Fundação
| Skill | O que faz |
|---|---|
| /hive-setup | Onboarding guiado da empresa — preenche todos os arquivos de contexto dos squads |
| /open-squad | Carrega persona do squad + STATE + documentos de fundação |
| /close-squad | Atualiza STATE + propaga L1 para a memória do orquestrador |
| /status | Agrega L1 de todos os squads ativos |
| /log-session | Notas estruturadas de sessão — decisões, gotchas, próximos passos |
| /log-incident | Registra incidente no hub com causa raiz e correção |
Fluxo de desenvolvimento
| Skill | O que faz |
|---|---|
| /create-issue | Cria issue no Linear com descrição completa e critérios de aceitação |
| /plan-issue | Decompõe a issue em plano técnico antes de executar |
| /start-issue | Faz checkout da branch + marca In Progress no Linear |
| /close-issue | Merge + marca Done no Linear + validação de deploy |
| /codex-review | Revisão de código P1/P2/P3 via OpenAI Codex CLI |
| /debug | Debugging estruturado com o método de resolução de problemas de Pólya |
Skills OpenRouter
Skills de IA multi-modelo via OpenRouter — segunda opinião, consenso, comparação de custo, simulação de ICP.
O HIVE inclui 7 skills que consultam múltiplos modelos de IA via OpenRouter. Úteis para reduzir viés de modelo, validar decisões e encontrar o modelo mais barato para tarefas recorrentes.
Configuração
- Obtenha uma chave de API em openrouter.ai
- Defina
OPENROUTER_API_KEY=sk-or-...no seu ambiente - Execute o script de instalação:
bash _core/mcp/install.sh
# macOS / Linux export OPENROUTER_API_KEY=sk-or-sua-chave-aqui bash _core/mcp/install.sh # Windows (PowerShell) $env:OPENROUTER_API_KEY = "sk-or-sua-chave-aqui" bash _core/mcp/install.sh
Skills disponíveis
| Skill | O que faz | Quando usar |
|---|---|---|
| /second-opinion | Consulta 1 modelo, obtém resposta bruta | Segunda opinião rápida do Kimi, GPT-5.5, Grok |
| /consensus | N modelos em paralelo, síntese de convergências/divergências | Evitar viés de modelo único em decisões importantes |
| /cost-compare | Mesma tarefa em 3–6 modelos, matriz de custo real | Antes de fixar um modelo em um worker recorrente |
| /icp-check | 2–3 modelos simulam seu ICP lendo um ativo | Validar copy, e-mails, landing pages antes de publicar |
| /anti-bubble | Modelo neutro lê o ativo SEM contexto da empresa | Detectar jargão e premissas invisíveis para quem está por dentro |
| /dod-check | Modelo barato valida diff vs. critérios de aceitação | Validação rotineira de PR antes da revisão humana |
| /code-review-model | Revisão de código P1/P2/P3 via qualquer modelo | Segunda opinião em revisões de código, varredura de segurança |
Modelos suportados (aliases)
| Alias | Modelo | Melhor para |
|---|---|---|
| kimi | Kimi K2.6 | Código, top open-weight |
| gpt5.5 | GPT-5.5 | Raciocínio, flagship |
| grok | Grok 4.20 | Contexto 2M, baixo custo |
| gemini-pro | Gemini (latest) | Multimodal, contexto longo |
| dsflash | DeepSeek Flash | Quase gratuito, contexto 1M |
| qwenflash | Qwen Flash | Rápido, barato, contexto 1M |
Ver mapa completo de modelos (30+ modelos) → · Guia de configuração MCP →
Personalização
HIVE foi projetado para ser forkado. Renomeie personas, adicione squads, estenda skills.