Repository navigation
Hook bigtech porte reminder
Esta página explica o hook bigtech_porte_reminder.py de forma didática. Se algum termo for novo, consulte o Glossário.
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 bigtech-porte-reminder é um lembrete leve para medir o tamanho (o porte) de um projeto de código, caso isso ainda não tenha sido feito. Ele sugere rodar a skill /bigtech, que aciona o agente Cosimo para classificar o porte e montar a equipe certa.
O nome significa "lembrete de porte do bigtech". "Porte" é o tamanho e a criticidade do projeto (veja o Glossário).
Ele dispara no evento SessionStart (início da sessão), mas com cuidado para não virar ruído. Ele só aparece em duas situações:
- Quando a pasta atual parece um projeto de código (tem um arquivo típico de projeto, como
package.json,pyproject.toml,CMakeLists.txt,go.mod, entre outros) e o porte ainda não foi classificado. Nesse caso, ele lembra de rodar a/bigtech. - Quando o projeto já foi classificado (existe o arquivo marcador
.bigtech-porte). Nesse caso, em vez de lembrar, ele apenas reforça o modo de operação do plugin, dizendo o porte atual e como conduzir o projeto como uma empresa.
Uma pasta que só tem CLAUDE.md ou .git, sem arquivo de projeto, não dispara o lembrete, para não incomodar em pastas de documentação.
O plugin só funciona bem se souber o tamanho do projeto, porque é o porte que decide quantos agentes entram (anti-exagero). Este lembrete garante que, ao abrir um projeto de código ainda não classificado, você seja convidado a medir o porte logo no início. Assim a equipe certa é montada desde cedo.
Quando você roda a /bigtech e o porte é classificado, a skill grava um pequeno arquivo chamado .bigtech-porte na raiz do projeto. Esse arquivo guarda o porte (porte=early, porte=scale ou porte=bigtech — nunca solo) e a data. A partir daí, este hook para de mostrar o lembrete e passa a apenas reforçar o modo de operação. Se o projeto mudar de tamanho, o porte é reavaliado e o marcador, reescrito. Marcador legado com solo é lido como early.
Este hook foi feito para nunca interromper a sessão. Ele é apenas um lembrete: sempre termina sem erro e nunca bloqueia o turno. Se algo der errado, ele simplesmente não mostra nada.
- O bigtech-session-init também roda no início da sessão, mas para carregar os manuais e avisar de compatibilidade.
- O bigtech-reinforce faz o reforço do modo a cada mensagem (este aqui faz só no início).
Veja também a Skill: /bigtech e o Cosimo (Chief of Staff). Voltar para a Home.