Features Avançadas

Multi-Agent Coordinator

O Coordinator Mode permite orquestrar múltiplos agentes trabalhando em paralelo. O modelo coordenador não executa trabalho diretamente — ele delega para workers especializados e sintetiza os resultados.

Fluxo recomendado

1. Pesquisa (paralelo)
   Agent(worker A) → explora autenticação
   Agent(worker B) → explora banco de dados
   Agent(worker C) → explora testes
          │
          ▼
2. Síntese (coordenador)
   Lê findings de A, B, C
   Escreve spec de implementação com paths, line numbers, detalhes
          │
          ▼
3. Implementação (sequencial por área de código)
   Agent(worker D) → implementa auth (src/auth/)
   Agent(worker E) → implementa db (src/db/)
          │
          ▼
4. Verificação (agente fresco, sem viés)
   Agent(verifier) → confirma que nada foi quebrado

Como usar

O agente coordenador usa a ferramenta Agent para spawnar workers:

Spawne dois workers em paralelo para pesquisar o bug de autenticação:
- Worker A: analise src/auth/ e identifique onde tokens são validados
- Worker B: verifique os testes de autenticação em src/__tests__/auth/

Cada worker recebe um prompt auto-contido (não vê a conversa do coordenador).

Retomar workers

Use SendMessage para continuar um worker com contexto:

SendMessage(
  to: "agent-a1b2c3",
  message: "A validação está em src/auth/validate.ts:42 — investigue o case de token expirado"
)

Isolamento via worktree

Para trabalho em paralelo no mesmo repositório sem conflitos:

Agent(
  isolation: "worktree",
  prompt: "Implemente o feature X em uma branch isolada"
)

O worktree é criado automaticamente e limpo se o agente não fizer mudanças.

Context Compaction

O Verboo Code gerencia automaticamente o context window para evitar erros de prompt_too_long.

Tipos de compactação

Full compaction — Sumariza toda a conversa em ~20K tokens:

/compact

Partial compaction — Sumariza apenas uma parte, preservando o cache de prompt:

• up_to: sumariza até um ponto, preserva o final
• from: sumariza a partir de um ponto, preserva o início

Microcompaction — Remove conteúdo antigo de tool results (padrão: >36h), substituindo por [Old tool result content cleared]. Economiza tokens sem perder contexto significativo.

Auto-compact

O Verboo Code monitora o uso de tokens e dispara compactação automática antes de atingir o limite:

Limite do context window
  │
  ├── Aviso: "faltam 20K tokens"
  │
  ├── Auto-compact threshold: compacta automaticamente
  │
  └── Limite rígido: bloqueia nova entrada

Circuit breaker: Se a compactação falhar 3 vezes consecutivas, o auto-compact é desabilitado para a sessão para evitar loops infinitos.

Pós-compactação

Após compactar, o Verboo Code reinjeta automaticamente:

• Arquivos recentes (até 5, budget de 50K tokens)
• Arquivo de plano atual (se em plan mode)
• Status de agentes em background
• Skills invocadas na sessão

Sistema de Memória

O sistema de memória persiste informações entre sessões em ~/.verboo/projects/<projeto>/memory/.

Tipos de memória

Estrutura de arquivos

~/.verboo/projects/<hash-do-projeto>/memory/
├── MEMORY.md          ← índice (máx 200 linhas, sempre carregado)
├── user_role.md
├── feedback_testing.md
├── project_auth_rewrite.md
└── reference_linear.md

MEMORY.md é carregado automaticamente a cada sessão. Arquivos de tópico são carregados sob demanda.

Formato dos arquivos de memória

---
name: feedback_terse_responses
description: Usuário prefere respostas curtas sem resumo no final
type: feedback
---

Não adicionar parágrafo de resumo ao final das respostas.

**Why:** Usuário disse "posso ler o diff".
**How to apply:** Toda resposta — encerre direto após o conteúdo.

Salvar uma memória

O agente salva memórias automaticamente quando aprende algo relevante. Você também pode pedir explicitamente:

lembre que prefiro commits semânticos com escopo (feat(auth): ...)

Voice Mode

O Voice Mode permite interação por voz com o agente via STT (Speech-to-Text).

Requisitos

• Autenticação OAuth com claude.ai (não funciona com API key simples)
• Feature flag habilitada na sua conta

Habilitar

/voice

O Voice Mode é controlado por:

1. Feature gate VOICE_MODE no build
2. Feature flag GrowthBook (tengu_amber_quartz_disabled como kill-switch)
3. Presença de token OAuth válido

Buddy System

O Buddy é um companion visual determinístico gerado a partir do userId.

Características

• Determinístico: O mesmo userId gera sempre o mesmo companion
• Atributos: Species, eyes, hat, rarity (common → epic → legendary), shiny flag
• Stats: Distribuídos com base na raridade
• Reações: Responde a menções do nome e ao comando /buddy

O Buddy não afeta a funcionalidade do agente — é apenas um elemento de personalização da interface.

Feature Flags

O Verboo Code usa dois sistemas de feature flags:

Macros em build time

Habilitadas/desabilitadas em scripts/build.ts e eliminadas do bundle em compile time:

GrowthBook (runtime)

Feature flags dinâmicas atualizadas sem rebuild. Exemplos:

• tengu_compact_cache_prefix — shared prompt cache durante compactação
• tengu_amber_quartz_disabled — kill-switch do voice mode
• tengu_auto_background_agents — background automático de agentes

Plan Mode

O Plan Mode restringe o agente a operações read-only, forçando um ciclo de planejamento antes da implementação.

Entrar em plan mode

EnterPlanMode

Ou o agente entra automaticamente ao receber tarefas complexas.

Em plan mode

• Somente ferramentas read-only (Read, Glob, Grep, WebSearch, Agent read-only)
• O agente pode escrever apenas no arquivo de plano (.verboo/plans/<nome>.md)
• Ideal para explorar o codebase e alinhar abordagem antes de qualquer mudança

Sair de plan mode

ExitPlanMode

O usuário aprova ou rejeita o plano. Após aprovação, o agente executa com contexto completo do plano.

Diagnósticos Avançados

Verificação completa

bun run hardening:strict

Executa: typecheck → build → smoke test → doctor runtime.

Verificação de privacidade

bun run verify:privacy

Confirma que o build não faz chamadas não autorizadas a servidores externos.

Scan de segurança de PR

bun run security:pr-scan --base origin/main

Analisa as mudanças na branch em busca de padrões de segurança problemáticos.