Verboo Code: como mudar o estilo de resposta do agente com output styles

Você pede uma correção e a Verboo Code devolve o código pronto, sem explicar a escolha. Às vezes é o que você quer. Outras vezes você queria entender o porquê, ou queria que o agente parasse e deixasse você escrever a parte difícil. É isso que o output style muda: o jeito que o agente de programação conversa com você, sem mexer no que ele sabe fazer.

Cadê o /output-style?

Foi descontinuado. Quem digita /output-style na Verboo Code recebe esta mensagem:

/output-style has been deprecated. Use /config to change your output style, or set it in your settings file. Changes take effect on the next session.

Os estilos continuam existindo. Mudou só o lugar de escolher: agora é o /config ou o arquivo de settings, e a troca vale a partir da próxima sessão.

Quais output styles vêm de fábrica?

Três. O padrão e dois voltados para aprender enquanto o agente trabalha:

Estilo	O que muda na resposta	Bom para
Default	Completa a tarefa com eficiência e responde de forma concisa	Trabalho do dia a dia
Explanatory	Antes e depois de escrever código, adiciona um bloco ★ Insight com 2 ou 3 pontos sobre as escolhas de implementação e os padrões do projeto	Entrar num código que você não conhece
Learning	Tudo do Explanatory e, quando a tarefa passa de 20 linhas com decisão de design, deixa um TODO(human) no código e pede que você escreva de 2 a 10 linhas	Praticar com a mão no teclado

No Learning, o agente para depois do pedido Learn by Doing e espera você implementar antes de seguir. Se você só quer a tarefa feita, não use esse.

Como trocar o output style pelo /config?

Dentro da sessão:

/config

Selecione Output style. Abre o painel Preferred output style com os três estilos de fábrica e os que você criou. Escolha um e saia do /config.

A escolha é gravada em .verboo/settings.local.json, na pasta do projeto, com a chave outputStyle. Feche a sessão e abra outra:

verboo

A partir dela, o agente responde no estilo novo.

Dá para definir o estilo direto no arquivo de settings?

Dá. A chave é outputStyle e o valor é o nome do estilo:

{
  "outputStyle": "Explanatory"
}

O arquivo onde você coloca decide quem pega o estilo:

Arquivo	Vale para
~/.verboo/settings.json	Você, em todos os projetos
.verboo/settings.json	Todo mundo que clonar o repositório (vai para o git)
.verboo/settings.local.json	Você, só neste projeto (é onde o /config grava)

Para voltar ao padrão, use "outputStyle": "default" ou apague a chave.

Como criar o meu próprio output style?

Um arquivo Markdown por estilo, numa pasta output-styles. O conteúdo do arquivo vira as instruções do estilo. Exemplo de um estilo que pede para o agente explicar o risco antes de editar:

mkdir -p .verboo/output-styles

E o arquivo .verboo/output-styles/revisor.md:

---
name: Revisor
description: Aponta o risco de cada mudança antes de editar e responde curto
keep-coding-instructions: true
---

# Estilo Revisor

- Antes de editar qualquer arquivo, liste em até 3 tópicos o que vai mudar e o risco de cada mudança.
- Responda em português, em frases curtas, sem repetir o código que acabou de escrever.
- Ao terminar, diga qual comando de teste rodar para conferir a mudança.

Abra o /config e o Revisor já aparece na lista, com a descrição que você escreveu. Os três campos do frontmatter:

Campo	Se você não preencher
name	Usa o nome do arquivo sem .md (revisor)
description	Tira a descrição do próprio conteúdo do arquivo
keep-coding-instructions	Fica desligado (veja a próxima seção)

No outputStyle vai o name, não o nome do arquivo. Com o exemplo acima, o valor é "Revisor".

Por que o agente parou de programar direito com o meu estilo?

Porque faltou keep-coding-instructions: true no frontmatter. Sem esse campo, o estilo customizado tira do prompt de sistema a seção de instruções de como executar tarefas de código, e o agente passa a se guiar só pelo seu estilo.

Os estilos de fábrica Explanatory e Learning já vêm com o campo ligado, por isso mantêm o comportamento de programação. Estilo seu, não: se ele é para trabalho de código, escreva o campo. Sem ele, só faz sentido quando você quer o agente para outra coisa, como escrever documentação ou responder dúvidas.

Onde a Verboo Code procura os estilos?

Pasta	Escopo
~/.verboo/output-styles/	Seus, em todos os projetos
.verboo/output-styles/ ou .claude/output-styles/	Do projeto. Vale da pasta atual subindo até a raiz do repositório git

A pasta .claude/output-styles/ também é lida, então estilos de projeto que você já tinha nessa pasta funcionam sem copiar. Já a pasta do usuário é só ~/.verboo/output-styles/: um estilo em ~/.claude/output-styles/ não aparece. Se você mudou a pasta de configuração com VERBOO_CONFIG_DIR, a pasta do usuário passa a ser $VERBOO_CONFIG_DIR/output-styles/.

Quando dois estilos têm o mesmo nome, ganha o de escopo mais específico: o do projeto ganha do seu, e o seu ganha do de fábrica. Um Explanatory.md com name: Explanatory no projeto substitui o estilo de fábrica para quem trabalha nele.

Output style ou AGENTS.md: qual usar?

Cada um muda uma coisa diferente:

	Output style	AGENTS.md / /memory
Muda	Como o agente conversa: tamanho, formato, se explica, se pede sua ajuda	O que o agente sabe do projeto: comandos, convenções, onde fica cada coisa
Um por vez?	Sim, só um estilo ativo	Não, os arquivos se somam

"Rode pnpm test antes de dizer que terminou" é regra do projeto e vai no AGENTS.md, como no tutorial de instruções permanentes com /memory. "Responda em tópicos e explique o risco" é jeito de conversar e vai no output style.

Comportamento verificado no código-fonte da Verboo Code (verbeux-ai/code, v0.15.41) em 04/11/2026: src/commands/output-style, src/constants/outputStyles.ts, src/outputStyles/loadOutputStylesDir.ts, src/constants/prompts.ts, src/components/Settings/Config.tsx e src/utils/markdownConfigLoader.ts.