Hook bigtech session init

Hook: bigtech-session-init

Esta página explica o hook bigtech_session_init.py de forma didática. Se algum termo for novo, consulte o Glossário.

O que é um hook

Um hook (gancho automático) é um pequeno programa que dispara sozinho em um momento específico, sem você pedir. O bigtech traz 6 hooks; este é um deles.

O que o bigtech-session-init faz

O bigtech-session-init prepara a sessão logo quando você abre o Claude Code. Ele faz três coisas, todas sem atrapalhar o seu trabalho:

1. Carrega o caminho dos manuais (docs-bootstrap). Ele descobre onde estão os manuais de governança do plugin (a pasta docs/) e injeta esse caminho no contexto, junto com a regra de "leia o manual antes de decidir". Assim o assistente sabe onde encontrar as regras.
2. Avisa sobre incompatibilidade. Ele verifica se o plugin caveman está ativo. Se estiver, alerta para desativá-lo, porque ele conflita com o bigtech.
3. Sugere dependências. Se os plugins opcionais playwright e superpowers não estiverem instalados, ele sugere a instalação (sem obrigar).

O nome significa "inicialização de sessão do bigtech".

Quando ele dispara

Ele dispara no evento SessionStart, ou seja, no início de cada sessão do Claude Code. Por isso, depois de instalar o plugin, é preciso reiniciar a sessão para que ele rode (veja Instalação).

Por que ele existe

O plugin tem manuais de governança (regras de quem decide o que, padrões de código, testes e deploy). Para o assistente segui-los, ele precisa saber onde eles estão antes de começar a trabalhar. Esse hook resolve isso de forma automática, no início da sessão. Sem ele, os manuais não entrariam em contexto e o plugin não operaria no modo correto.

O que é o docs-bootstrap

"docs-bootstrap" é o nome da parte que carrega os manuais. "Bootstrap" significa "preparação inicial automática" (veja o Glossário). Em palavras simples: assim que a sessão começa, o hook diz ao assistente "os manuais estão nesta pasta; leia o manual certo antes de tomar qualquer decisão de governança, código, teste, deploy ou auditoria".

Ele também lembra de uma regra importante: quando o assistente principal aciona um especialista (um subagente), precisa passar o caminho dos manuais junto, porque o subagente não herda esse contexto sozinho.

Como ele descobre o caminho

O hook usa uma informação que o Claude Code fornece (a localização do plugin instalado) para montar o caminho até a pasta docs/. Esse caminho é resolvido na hora, no computador de quem usa o plugin. Nenhum caminho fixo fica escrito no código, então funciona em qualquer máquina.

Ele nunca trava o seu trabalho

Este hook foi feito para nunca interromper a sessão. Ele sempre termina sem erro. Se algo der errado (por exemplo, não conseguir ler a lista de plugins ativos), ele simplesmente segue com um aviso genérico, sem bloquear. Esse comportamento seguro se chama silent-fail (falha em silêncio): na dúvida, ele não atrapalha.

Relação com os outros hooks

• O bigtech-porte-reminder também roda no início da sessão, mas com outro propósito: lembrar de medir o tamanho do projeto.
• O bigtech-reinforce age a cada mensagem que você envia, para manter o plugin no modo certo.

---

Veja também Instalação e o Glossário. Voltar para a Home.