PocketTeam: Um Pipeline de Código Claude com Segurança Baseada em Hooks e Agentes de Aprendizado

O que o PocketTeam faz

PocketTeam é um pipeline construído sobre Claude Code que impõe segurança no nível de chamada de ferramentas e implementa mecanismos de aprendizado onde o sistema melhora após cada execução de tarefa.

Principais recursos

• Segurança baseada em hooks (não em prompts): 9 camadas de segurança interceptam chamadas de ferramentas antes que sejam executadas. Operações perigosas como gravações em .env, rm -rf / ou comandos DROP DATABASE são bloqueadas na camada de tempo de execução. Essas regras são implementadas em código de hook, não no contexto do LLM, tornando-as resistentes a ataques de injeção de prompt ou compactação de contexto.
• Sistema de aprendizado: Um agente Observador é executado ao final de cada tarefa concluída. Ele analisa o que aconteceu, o que funcionou, o que não funcionou e grava aprendizados estruturados em arquivos específicos do agente. Esses arquivos são injetados em contextos futuros dos agentes, permitindo que eles evitem erros cometidos em execuções anteriores.
• Auto-reparação via GitHub Actions: Quando uma compilação falha, um fluxo de trabalho do GitHub Actions dispara uma sessão Claude Code automaticamente. Ele cria um plano de correção e notifica você via Telegram para aprovação, permitindo a resolução remota de falhas de compilação.
• 59 habilidades integradas: Uma biblioteca de procedimentos estruturados incluindo fluxos de trabalho de auditoria OWASP, loops TDD (ralph: mode), mapeamento de base de código, diagnósticos de banco de dados, rastreamento de custos, execução paralela com isolamento de worktree e mais.
• Palavras-chave mágicas: Comandos como autopilot: add dark mode (pipeline completo, zero intervenção humana), ralph: fix failing tests (loop TDD até ficar verde com máximo de 5 iterações), quick: rename this var (direto para implementação) e deep-dive: our DB schema (3 agentes de pesquisa paralelos).
• Navegador headless integrado (ptbrowse): Usa snapshots da Árvore de Acessibilidade (~100–300 tokens por chamada) em vez de capturas de tela (milhares de tokens). O agente de QA pode navegar em páginas, clicar em elementos, preencher formulários, aguardar condições e executar asserções em um navegador Chromium real. Capturas de tela também estão disponíveis e são salvas em .pocketteam/screenshots/.
• Painel em tempo real: O comando pt dashboard mostra a atividade dos agentes em tempo real no Docker, exibindo o que está em execução, o que passou e o que falhou.
• Controle remoto via Telegram: Plugin de canal nativo do Claude Code para controle bidirecional e aprovação de planos a partir de dispositivos móveis.

Instalação e disponibilidade

Instale via pipx install pocketteam. A ferramenta é gratuita com uma assinatura Claude Code e lançada sob a Licença MIT. Source está disponível em https://github.com/Farid046/PocketTeam.