cc-viewer 1.2.1 → 1.2.2

package/concepts/pt-BR/MainAgent.md

@@ -0,0 +1,30 @@
+# MainAgent
+
+## Definição
+
+MainAgent é a cadeia de requisições principal do Claude Code quando não está no modo agent team. Cada interação do usuário com o Claude Code gera uma série de requisições à API, e as requisições do MainAgent formam a cadeia de diálogo central — elas carregam o system prompt completo, definições de ferramentas e histórico de mensagens.
+
+## Como Identificar
+
+No cc-viewer, o MainAgent é identificado por `req.mainAgent === true`, marcado automaticamente pelo `interceptor.js` durante a captura da requisição.
+
+Condições de identificação (todas devem ser atendidas):
+- O corpo da requisição contém o campo `system` (system prompt)
+- O corpo da requisição contém o array `tools` (definições de ferramentas)
+- O system prompt contém texto característico de "Claude Code"
+
+## Diferença em Relação ao SubAgent
+
+| Característica | MainAgent | SubAgent |
+|------|-----------|----------|
+| system prompt | Prompt principal completo do Claude Code | Prompt simplificado específico para a tarefa |
+| array tools | Contém todas as ferramentas disponíveis | Geralmente contém apenas as poucas ferramentas necessárias para a tarefa |
+| Histórico de mensagens | Acumula o contexto completo da conversa | Contém apenas mensagens relacionadas à subtarefa |
+| Comportamento de cache | Possui prompt caching (TTL de 5 minutos) | Geralmente sem cache ou com cache menor |
+
+## Significado no cc-viewer
+
+- **Rastreamento de cache**: O estado do prompt caching das requisições do MainAgent afeta diretamente os custos. Monitorando a proporção entre `cache_creation_input_tokens` e `cache_read_input_tokens`, é possível avaliar a taxa de acerto do cache
+- **Análise de perda de cache**: Quando requisições do MainAgent apresentam grande volume de cache creation (em vez de cache read), isso indica que o cache foi perdido e reconstruído. O cc-viewer marca essas requisições com um indicador de ponto vermelho
+- **Análise da cadeia principal**: A sequência de requisições do MainAgent reflete o processo completo de interação do usuário com o Claude Code, sendo os dados centrais para análise do comportamento da sessão
+- **Reconstrução da sessão**: O cc-viewer reconstrói a visualização da conversa (Chat Mode) através do histórico de mensagens das requisições do MainAgent

package/concepts/pt-BR/Tool-AskUserQuestion.md

@@ -0,0 +1,54 @@
+# AskUserQuestion
+
+## Definição
+
+Faz perguntas ao usuário durante a execução, para obter esclarecimentos, validar suposições ou solicitar decisões.
+
+## Parâmetros
+
+| Parâmetro | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `questions` | array | Sim | Lista de perguntas (1-4 perguntas) |
+| `answers` | object | Não | Respostas coletadas do usuário |
+| `annotations` | object | Não | Anotações para cada pergunta (ex: notas de pré-visualização de seleção) |
+| `metadata` | object | Não | Metadados para rastreamento e análise |
+
+Cada objeto `question`:
+
+| Campo | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `question` | string | Sim | Texto completo da pergunta, deve terminar com ponto de interrogação |
+| `header` | string | Sim | Rótulo curto (máximo 12 caracteres), exibido como chip de tag |
+| `options` | array | Sim | 2-4 opções |
+| `multiSelect` | boolean | Sim | Se permite seleção múltipla |
+
+Cada objeto `option`:
+
+| Campo | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `label` | string | Sim | Texto de exibição da opção (1-5 palavras) |
+| `description` | string | Sim | Descrição da opção |
+| `markdown` | string | Não | Conteúdo de pré-visualização (para comparação visual de layouts ASCII, trechos de código, etc.) |
+
+## Cenários de Uso
+
+**Adequado para:**
+- Coletar preferências ou requisitos do usuário
+- Esclarecer instruções ambíguas
+- Obter decisões durante a implementação
+- Oferecer opções de direção ao usuário
+
+**Não adequado para:**
+- Perguntar "o plano está ok?" — deve usar ExitPlanMode
+
+## Observações
+
+- O usuário sempre pode escolher "Other" para fornecer entrada personalizada
+- A opção recomendada deve ser colocada em primeiro lugar, com "(Recommended)" no final do label
+- A pré-visualização `markdown` é suportada apenas para perguntas de seleção única
+- Opções com `markdown` alternam para layout lado a lado
+- No modo de planejamento, usado para esclarecer requisitos antes de definir o plano
+
+## Significado no cc-viewer
+
+A chamada AskUserQuestion aparece nos logs de requisição como um content block `tool_use`, contendo a definição das perguntas e opções. As respostas do usuário aparecem no histórico de mensagens das requisições subsequentes.

package/concepts/pt-BR/Tool-Bash.md

@@ -0,0 +1,47 @@
+# Bash
+
+## Definição
+
+Executa comandos shell, com suporte a configuração opcional de timeout. O diretório de trabalho persiste entre comandos, mas o estado do shell (variáveis de ambiente, etc.) não persiste.
+
+## Parâmetros
+
+| Parâmetro | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `command` | string | Sim | Comando bash a ser executado |
+| `description` | string | Não | Descrição curta do comando |
+| `timeout` | number | Não | Timeout em milissegundos, máximo 600000, padrão 120000 |
+| `run_in_background` | boolean | Não | Se deve executar em segundo plano |
+
+## Cenários de Uso
+
+**Adequado para:**
+- Operações git (commit, push, branch, etc.)
+- Comandos de gerenciamento de pacotes como npm/yarn
+- Operações docker
+- Comandos de compilação e build
+- Listar conteúdo de diretórios (`ls`)
+- Outros comandos de sistema que requerem execução shell
+
+**Não adequado para:**
+- Ler arquivos — deve usar Read
+- Buscar nomes de arquivo — deve usar Glob
+- Buscar conteúdo de arquivo — deve usar Grep
+- Editar arquivos — deve usar Edit
+- Escrever arquivos — deve usar Write
+- Exibir informações ao usuário — exibir diretamente no texto da resposta
+- Processos de longa duração (dev server, modo watch) — recomendar que o usuário execute manualmente
+
+## Observações
+
+- Caminhos com espaços devem ser envolvidos em aspas duplas
+- Saída acima de 30000 caracteres será truncada
+- Comandos em segundo plano obtêm resultados via TaskOutput
+- Prefira usar caminhos absolutos, evite `cd`
+- Comandos independentes podem invocar múltiplos Bash em paralelo
+- Comandos com dependências devem ser encadeados com `&&`
+- O ambiente shell é inicializado a partir do profile do usuário (bash ou zsh)
+
+## Significado no cc-viewer
+
+As chamadas Bash aparecem nos logs de requisição como pares de content blocks `tool_use` (contendo o comando) e `tool_result` (contendo a saída). A saída da execução do comando pode ser usada para analisar o comportamento operacional do modelo.

package/concepts/pt-BR/Tool-Edit.md

@@ -0,0 +1,38 @@
+# Edit
+
+## Definição
+
+Edita arquivos através de substituição exata de strings. Substitui `old_string` por `new_string` no arquivo.
+
+## Parâmetros
+
+| Parâmetro | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `file_path` | string | Sim | Caminho absoluto do arquivo a ser modificado |
+| `old_string` | string | Sim | Texto original a ser substituído |
+| `new_string` | string | Sim | Novo texto após a substituição (deve ser diferente de old_string) |
+| `replace_all` | boolean | Não | Se deve substituir todas as ocorrências, padrão `false` |
+
+## Cenários de Uso
+
+**Adequado para:**
+- Modificar trechos específicos de código em arquivos existentes
+- Corrigir bugs, atualizar lógica
+- Renomear variáveis (com `replace_all: true`)
+- Qualquer cenário que requer modificação precisa do conteúdo de um arquivo
+
+**Não adequado para:**
+- Criar novos arquivos — deve usar Write
+- Reescrita em grande escala — pode ser necessário usar Write para sobrescrever o arquivo inteiro
+
+## Observações
+
+- Antes de usar, é obrigatório ter lido o arquivo via Read, caso contrário ocorrerá erro
+- `old_string` deve ser único no arquivo, caso contrário a edição falhará. Se não for único, forneça mais contexto para torná-lo único, ou use `replace_all`
+- Ao editar texto, deve-se manter a indentação original (tab/espaços), não incluir o prefixo de número de linha da saída do Read
+- Prefira editar arquivos existentes em vez de criar novos
+- `new_string` deve ser diferente de `old_string`
+
+## Significado no cc-viewer
+
+A chamada Edit aparece nos logs de requisição como um content block `tool_use`, cujo `input` contém `old_string` e `new_string`, podendo ser usado para rastrear quais modificações o modelo fez nos arquivos.

package/concepts/pt-BR/Tool-EnterPlanMode.md

@@ -0,0 +1,43 @@
+# EnterPlanMode
+
+## Definição
+
+Alterna o Claude Code para o modo de planejamento, usado para explorar a base de código e projetar um plano antes da implementação.
+
+## Parâmetros
+
+Sem parâmetros.
+
+## Cenários de Uso
+
+**Adequado para:**
+- Implementação de novas funcionalidades — requer decisões de arquitetura
+- Existem múltiplas abordagens viáveis — requer escolha do usuário
+- Modificações de código afetam comportamento ou estrutura existente
+- Alterações em múltiplos arquivos — possivelmente envolvendo 2-3 ou mais arquivos
+- Requisitos não claros — necessário explorar antes de entender o escopo
+- Preferências do usuário são importantes — a implementação pode ter múltiplas direções razoáveis
+
+**Não adequado para:**
+- Correções de uma ou poucas linhas (erros de digitação, bugs óbvios)
+- O usuário já forneceu instruções muito específicas
+- Tarefas puramente de pesquisa/exploração — deve usar Task (tipo Explore)
+
+## Comportamento no Modo de Planejamento
+
+Após entrar no modo de planejamento, o Claude Code irá:
+1. Usar ferramentas Glob, Grep, Read para explorar profundamente a base de código
+2. Compreender padrões e arquitetura existentes
+3. Projetar o plano de implementação
+4. Submeter o plano para aprovação do usuário
+5. Usar AskUserQuestion se necessário para esclarecimentos
+6. Sair via ExitPlanMode quando o plano estiver pronto
+
+## Observações
+
+- Esta ferramenta requer consentimento do usuário para entrar no modo de planejamento
+- Se não tiver certeza se o planejamento é necessário, prefira planejar — alinhar antecipadamente é melhor que retrabalho
+
+## Significado no cc-viewer
+
+A chamada EnterPlanMode aparece nos logs de requisição como um content block `tool_use`. Após entrar no modo de planejamento, a sequência de requisições é tipicamente dominada por chamadas de ferramentas exploratórias (Glob, Grep, Read), até que ExitPlanMode seja chamado.

package/concepts/pt-BR/Tool-ExitPlanMode.md

@@ -0,0 +1,39 @@
+# ExitPlanMode
+
+## Definição
+
+Sai do modo de planejamento e submete o plano para aprovação do usuário. O conteúdo do plano é lido do arquivo de plano previamente escrito.
+
+## Parâmetros
+
+| Parâmetro | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `allowedPrompts` | array | Não | Lista de descrições de permissões necessárias para o plano de implementação |
+
+Cada elemento do array `allowedPrompts`:
+
+| Campo | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `tool` | enum | Sim | Ferramenta aplicável, atualmente suporta apenas `Bash` |
+| `prompt` | string | Sim | Descrição semântica da operação (ex: "run tests", "install dependencies") |
+
+## Cenários de Uso
+
+**Adequado para:**
+- No modo de planejamento, quando o plano está completo e pronto para submissão à aprovação do usuário
+- Usado apenas para tarefas de implementação que requerem escrita de código
+
+**Não adequado para:**
+- Tarefas puramente de pesquisa/exploração — não é necessário sair do modo de planejamento
+- Querer perguntar ao usuário "o plano está ok?" — esta é exatamente a função desta ferramenta, não use AskUserQuestion para isso
+
+## Observações
+
+- Esta ferramenta não aceita o conteúdo do plano como parâmetro — ela lê do arquivo de plano previamente escrito
+- O usuário verá o conteúdo do arquivo de plano para aprovação
+- Não use AskUserQuestion para perguntar "o plano está ok?" antes de chamar esta ferramenta, isso é redundante
+- Não mencione "plano" nas perguntas, pois o usuário não pode ver o conteúdo do plano antes do ExitPlanMode
+
+## Significado no cc-viewer
+
+A chamada ExitPlanMode marca o fim da fase de planejamento. Nos logs de requisição, as requisições após esta chamada tipicamente mudam para operações de implementação (Edit, Write, Bash, etc.).

package/concepts/pt-BR/Tool-Glob.md

@@ -0,0 +1,34 @@
+# Glob
+
+## Definição
+
+Ferramenta rápida de correspondência de padrões de nomes de arquivo, suporta bases de código de qualquer tamanho. Retorna caminhos de arquivos correspondentes ordenados por data de modificação.
+
+## Parâmetros
+
+| Parâmetro | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `pattern` | string | Sim | Padrão glob (ex: `**/*.js`, `src/**/*.ts`) |
+| `path` | string | Não | Diretório de busca, padrão é o diretório de trabalho atual. Não passe "undefined" ou "null" |
+
+## Cenários de Uso
+
+**Adequado para:**
+- Buscar arquivos por padrão de nome
+- Encontrar todos os arquivos de um tipo específico (ex: todos os arquivos `.tsx`)
+- Localizar arquivos ao buscar definições de classes específicas (ex: `class Foo`)
+- Pode iniciar múltiplas chamadas Glob em paralelo em uma única mensagem
+
+**Não adequado para:**
+- Buscar conteúdo de arquivo — deve usar Grep
+- Exploração aberta que requer múltiplas rodadas de busca — deve usar Task (tipo Explore)
+
+## Observações
+
+- Suporta sintaxe glob padrão: `*` corresponde a um nível, `**` corresponde a múltiplos níveis, `{}` corresponde a múltiplas opções
+- Resultados ordenados por data de modificação
+- Mais recomendado que o comando `find` do Bash
+
+## Significado no cc-viewer
+
+As chamadas Glob aparecem nos logs de requisição como pares de content blocks `tool_use` / `tool_result`. O `tool_result` contém a lista de caminhos de arquivos correspondentes.

package/concepts/pt-BR/Tool-Grep.md

@@ -0,0 +1,47 @@
+# Grep
+
+## Definição
+
+Ferramenta poderosa de busca de conteúdo baseada em ripgrep. Suporta expressões regulares, filtragem por tipo de arquivo e múltiplos modos de saída.
+
+## Parâmetros
+
+| Parâmetro | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `pattern` | string | Sim | Padrão de busca com expressão regular |
+| `path` | string | Não | Caminho de busca (arquivo ou diretório), padrão é o diretório de trabalho atual |
+| `glob` | string | Não | Filtro de nome de arquivo (ex: `*.js`, `*.{ts,tsx}`) |
+| `type` | string | Não | Filtro de tipo de arquivo (ex: `js`, `py`, `rust`), mais eficiente que glob |
+| `output_mode` | enum | Não | Modo de saída: `files_with_matches` (padrão), `content`, `count` |
+| `-i` | boolean | Não | Busca sem distinção de maiúsculas/minúsculas |
+| `-n` | boolean | Não | Exibir números de linha (apenas modo content), padrão true |
+| `-A` | number | Não | Número de linhas a exibir após a correspondência |
+| `-B` | number | Não | Número de linhas a exibir antes da correspondência |
+| `-C` / `context` | number | Não | Número de linhas a exibir antes e depois da correspondência |
+| `head_limit` | number | Não | Limitar número de entradas na saída, padrão 0 (ilimitado) |
+| `offset` | number | Não | Pular os primeiros N resultados |
+| `multiline` | boolean | Não | Ativar modo de correspondência multilinha, padrão false |
+
+## Cenários de Uso
+
+**Adequado para:**
+- Buscar strings ou padrões específicos na base de código
+- Encontrar locais de uso de funções/variáveis
+- Filtrar resultados de busca por tipo de arquivo
+- Contar número de correspondências
+
+**Não adequado para:**
+- Buscar arquivos por nome — deve usar Glob
+- Exploração aberta que requer múltiplas rodadas de busca — deve usar Task (tipo Explore)
+
+## Observações
+
+- Usa sintaxe ripgrep (não grep), caracteres especiais como chaves precisam ser escapados
+- O modo `files_with_matches` retorna apenas caminhos de arquivo, é o mais eficiente
+- O modo `content` retorna o conteúdo das linhas correspondentes, suporta linhas de contexto
+- Correspondência multilinha requer `multiline: true`
+- Sempre prefira usar a ferramenta Grep em vez dos comandos `grep` ou `rg` no Bash
+
+## Significado no cc-viewer
+
+As chamadas Grep aparecem nos logs de requisição como pares de content blocks `tool_use` / `tool_result`. O `tool_result` contém os resultados da busca.

package/concepts/pt-BR/Tool-NotebookEdit.md

@@ -0,0 +1,33 @@
+# NotebookEdit
+
+## Definição
+
+Substitui, insere ou exclui células específicas em um Jupyter notebook (arquivo .ipynb).
+
+## Parâmetros
+
+| Parâmetro | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `notebook_path` | string | Sim | Caminho absoluto do arquivo notebook |
+| `new_source` | string | Sim | Novo conteúdo da célula |
+| `cell_id` | string | Não | ID da célula a editar. No modo de inserção, a nova célula é inserida após este ID |
+| `cell_type` | enum | Não | Tipo de célula: `code` ou `markdown`. Obrigatório no modo de inserção |
+| `edit_mode` | enum | Não | Modo de edição: `replace` (padrão), `insert`, `delete` |
+
+## Cenários de Uso
+
+**Adequado para:**
+- Modificar células de código ou markdown em Jupyter notebooks
+- Adicionar novas células ao notebook
+- Excluir células do notebook
+
+## Observações
+
+- `cell_number` é indexado a partir de 0
+- O modo `insert` insere uma nova célula na posição especificada
+- O modo `delete` exclui a célula na posição especificada
+- O caminho deve ser absoluto
+
+## Significado no cc-viewer
+
+A chamada NotebookEdit aparece nos logs de requisição como um content block `tool_use`, registrando a operação específica de modificação no notebook.

package/concepts/pt-BR/Tool-Read.md

@@ -0,0 +1,41 @@
+# Read
+
+## Definição
+
+Lê conteúdo de arquivo do sistema de arquivos local. Suporta arquivos de texto, imagens, PDF e Jupyter notebook.
+
+## Parâmetros
+
+| Parâmetro | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `file_path` | string | Sim | Caminho absoluto do arquivo |
+| `offset` | number | Não | Número da linha inicial (para leitura segmentada de arquivos grandes) |
+| `limit` | number | Não | Número de linhas a ler (para leitura segmentada de arquivos grandes) |
+| `pages` | string | Não | Intervalo de páginas do PDF (ex: "1-5", "3", "10-20"), aplicável apenas a PDF |
+
+## Cenários de Uso
+
+**Adequado para:**
+- Ler arquivos de código, configuração e outros arquivos de texto
+- Visualizar arquivos de imagem (Claude é um modelo multimodal)
+- Ler documentos PDF
+- Ler Jupyter notebooks (retorna todas as células e saídas)
+- Ler múltiplos arquivos em paralelo para obter contexto
+
+**Não adequado para:**
+- Ler diretórios — deve usar o comando `ls` do Bash
+- Exploração aberta da base de código — deve usar Task (tipo Explore)
+
+## Observações
+
+- O caminho deve ser absoluto, não relativo
+- Por padrão, lê as primeiras 2000 linhas do arquivo
+- Linhas com mais de 2000 caracteres serão truncadas
+- A saída usa formato `cat -n`, com números de linha começando em 1
+- PDFs grandes (mais de 10 páginas) devem especificar o parâmetro `pages`, máximo de 20 páginas por vez
+- Ler um arquivo inexistente retorna erro (não causa crash)
+- Pode chamar múltiplos Read em paralelo em uma única mensagem
+
+## Significado no cc-viewer
+
+As chamadas Read aparecem nos logs de requisição como pares de content blocks `tool_use` (chamada) e `tool_result` (conteúdo retornado). O `tool_result` contém o conteúdo real do arquivo, podendo ser usado para analisar quais arquivos o modelo leu.

package/concepts/pt-BR/Tool-Skill.md

@@ -0,0 +1,35 @@
+# Skill
+
+## Definição
+
+Executa uma skill (habilidade) na conversa principal. Skills são capacidades especializadas que o usuário pode invocar através de slash commands (ex: `/commit`, `/review-pr`).
+
+## Parâmetros
+
+| Parâmetro | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `skill` | string | Sim | Nome da skill (ex: "commit", "review-pr", "pdf") |
+| `args` | string | Não | Argumentos da skill |
+
+## Cenários de Uso
+
+**Adequado para:**
+- O usuário digitou um slash command no formato `/<skill-name>`
+- A solicitação do usuário corresponde à funcionalidade de uma skill registrada
+
+**Não adequado para:**
+- Comandos CLI integrados (ex: `/help`, `/clear`)
+- Skills que já estão em execução
+- Nomes de skills que não estão na lista de skills disponíveis
+
+## Observações
+
+- Após ser invocada, a skill se expande em um prompt completo
+- Suporta nomes totalmente qualificados (ex: `ms-office-suite:pdf`)
+- A lista de skills disponíveis é fornecida nas mensagens system-reminder
+- Quando a tag `<command-name>` é vista, significa que a skill já foi carregada e deve ser executada diretamente sem chamar esta ferramenta novamente
+- Não mencione uma skill sem realmente invocar a ferramenta
+
+## Significado no cc-viewer
+
+A chamada Skill aparece nos logs de requisição como um content block `tool_use`. O prompt expandido pela skill afeta o system prompt ou conteúdo das mensagens das requisições subsequentes.

package/concepts/pt-BR/Tool-Task.md

@@ -0,0 +1,53 @@
+# Task
+
+## Definição
+
+Inicia um sub-agent (SubAgent) para processar autonomamente tarefas complexas de múltiplas etapas. Sub-agents são subprocessos independentes, cada um com seu próprio conjunto de ferramentas e contexto dedicados.
+
+## Parâmetros
+
+| Parâmetro | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `prompt` | string | Sim | Descrição da tarefa a ser executada pelo sub-agent |
+| `description` | string | Sim | Resumo curto de 3-5 palavras |
+| `subagent_type` | string | Sim | Tipo do sub-agent, determina o conjunto de ferramentas disponíveis |
+| `model` | enum | Não | Modelo especificado (sonnet / opus / haiku), herda do pai por padrão |
+| `max_turns` | integer | Não | Número máximo de turnos agênticos |
+| `run_in_background` | boolean | Não | Se deve executar em segundo plano; tarefas em segundo plano retornam caminho do output_file |
+| `resume` | string | Não | ID do agent a retomar, continua da última execução |
+| `isolation` | enum | Não | Modo de isolamento, `worktree` cria um git worktree temporário |
+
+## Tipos de Sub-agent
+
+| Tipo | Finalidade | Ferramentas Disponíveis |
+|------|------|----------|
+| `Bash` | Execução de comandos, operações git | Bash |
+| `general-purpose` | Tarefas genéricas de múltiplas etapas | Todas as ferramentas |
+| `Explore` | Exploração rápida da base de código | Todas exceto Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `Plan` | Projetar plano de implementação | Todas exceto Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `claude-code-guide` | Q&A sobre guia de uso do Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | Configurar barra de status | Read, Edit |
+
+## Cenários de Uso
+
+**Adequado para:**
+- Tarefas complexas que requerem múltiplas etapas autônomas
+- Exploração e pesquisa aprofundada da base de código (usando tipo Explore)
+- Trabalho paralelo que requer ambiente isolado
+- Tarefas de longa duração que precisam executar em segundo plano
+
+**Não adequado para:**
+- Ler um caminho de arquivo específico — usar Read ou Glob diretamente
+- Buscar em 2-3 arquivos conhecidos — usar Read diretamente
+- Buscar definição de classe específica — usar Glob diretamente
+
+## Observações
+
+- Após conclusão, o sub-agent retorna uma única mensagem; seus resultados não são visíveis ao usuário, o agent principal precisa retransmitir
+- Pode iniciar múltiplas chamadas Task em paralelo em uma única mensagem para maior eficiência
+- Tarefas em segundo plano verificam progresso via ferramenta TaskOutput
+- O tipo Explore é mais lento que chamar Glob/Grep diretamente, use apenas quando buscas simples não são suficientes
+
+## Significado no cc-viewer
+
+A chamada Task gera uma cadeia de requisições SubAgent, visível na lista de requisições como uma sequência de sub-requisições independente do MainAgent. Requisições SubAgent tipicamente possuem system prompt simplificado e menos definições de ferramentas, formando um contraste claro com o MainAgent.

package/concepts/pt-BR/Tool-TaskCreate.md

@@ -0,0 +1,38 @@
+# TaskCreate
+
+## Definição
+
+Cria entradas estruturadas na lista de tarefas, para rastrear progresso, organizar tarefas complexas e mostrar o andamento do trabalho ao usuário.
+
+## Parâmetros
+
+| Parâmetro | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `subject` | string | Sim | Título curto da tarefa, usar forma imperativa (ex: "Fix authentication bug") |
+| `description` | string | Sim | Descrição detalhada, incluindo contexto e critérios de aceitação |
+| `activeForm` | string | Não | Texto no gerúndio exibido quando em andamento (ex: "Fixing authentication bug") |
+| `metadata` | object | Não | Metadados arbitrários anexados à tarefa |
+
+## Cenários de Uso
+
+**Adequado para:**
+- Tarefas complexas de múltiplas etapas (mais de 3 etapas)
+- O usuário forneceu múltiplos itens a fazer
+- Rastrear trabalho no modo de planejamento
+- O usuário solicitou explicitamente o uso de lista de tarefas
+
+**Não adequado para:**
+- Tarefa única e simples
+- Operações simples de até 3 etapas
+- Consultas puramente conversacionais ou informativas
+
+## Observações
+
+- Todas as tarefas criadas têm status inicial `pending`
+- `subject` usa forma imperativa ("Run tests"), `activeForm` usa gerúndio ("Running tests")
+- Após criar a tarefa, pode-se definir dependências (blocks/blockedBy) via TaskUpdate
+- Antes de criar, deve-se chamar TaskList para verificar se há tarefas duplicadas
+
+## Significado no cc-viewer
+
+TaskCreate é uma operação interna de gerenciamento de tarefas do Claude Code, não gera requisições API independentes. Porém, no Chat Mode é possível ver o bloco tool_use do modelo chamando esta ferramenta.

package/concepts/pt-BR/Tool-TaskGet.md

@@ -0,0 +1,35 @@
+# TaskGet
+
+## Definição
+
+Obtém os detalhes completos de uma tarefa através do ID da tarefa.
+
+## Parâmetros
+
+| Parâmetro | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `taskId` | string | Sim | ID da tarefa a obter |
+
+## Conteúdo Retornado
+
+- `subject` — Título da tarefa
+- `description` — Requisitos detalhados e contexto
+- `status` — Status: `pending`, `in_progress` ou `completed`
+- `blocks` — Lista de tarefas bloqueadas por esta tarefa
+- `blockedBy` — Lista de tarefas pré-requisito que bloqueiam esta tarefa
+
+## Cenários de Uso
+
+**Adequado para:**
+- Obter a descrição completa e contexto da tarefa antes de iniciar o trabalho
+- Entender as dependências da tarefa
+- Obter requisitos completos após ser atribuído a uma tarefa
+
+## Observações
+
+- Após obter a tarefa, deve-se verificar se a lista `blockedBy` está vazia antes de iniciar o trabalho
+- Use TaskList para ver o resumo de todas as tarefas
+
+## Significado no cc-viewer
+
+TaskGet é uma operação interna de gerenciamento de tarefas, não gera requisições API independentes.

package/concepts/pt-BR/Tool-TaskList.md

@@ -0,0 +1,36 @@
+# TaskList
+
+## Definição
+
+Lista todas as tarefas na lista de tarefas, para visualizar o progresso geral e trabalho disponível.
+
+## Parâmetros
+
+Sem parâmetros.
+
+## Conteúdo Retornado
+
+Informações resumidas de cada tarefa:
+- `id` — Identificador da tarefa
+- `subject` — Descrição curta
+- `status` — Status: `pending`, `in_progress` ou `completed`
+- `owner` — Responsável (ID do agent), vazio indica não atribuído
+- `blockedBy` — Lista de IDs de tarefas não concluídas que bloqueiam esta tarefa
+
+## Cenários de Uso
+
+**Adequado para:**
+- Ver quais tarefas estão disponíveis (status pending, sem owner, não bloqueadas)
+- Verificar o progresso geral do projeto
+- Encontrar tarefas bloqueadas
+- Encontrar a próxima tarefa após concluir uma
+
+## Observações
+
+- Prefira processar tarefas em ordem de ID (menor ID primeiro), pois tarefas anteriores geralmente fornecem contexto para as posteriores
+- Tarefas com `blockedBy` não podem ser reivindicadas até que as dependências sejam resolvidas
+- Use TaskGet para obter detalhes completos de uma tarefa específica
+
+## Significado no cc-viewer
+
+TaskList é uma operação interna de gerenciamento de tarefas, não gera requisições API independentes.

package/concepts/pt-BR/Tool-TaskOutput.md

@@ -0,0 +1,34 @@
+# TaskOutput
+
+## Definição
+
+Obtém a saída de tarefas em segundo plano em execução ou concluídas. Aplicável a shells em segundo plano, agents assíncronos e sessões remotas.
+
+## Parâmetros
+
+| Parâmetro | Tipo | Obrigatório | Descrição |
+|------|------|------|------|
+| `task_id` | string | Sim | ID da tarefa |
+| `block` | boolean | Sim | Se deve bloquear aguardando a conclusão da tarefa, padrão `true` |
+| `timeout` | number | Sim | Tempo máximo de espera (milissegundos), padrão 30000, máximo 600000 |
+
+## Cenários de Uso
+
+**Adequado para:**
+- Verificar o progresso de agents em segundo plano iniciados via Task (`run_in_background: true`)
+- Obter resultados de execução de comandos Bash em segundo plano
+- Aguardar a conclusão de tarefas assíncronas e obter a saída
+
+**Não adequado para:**
+- Tarefas em primeiro plano — tarefas em primeiro plano retornam resultados diretamente, sem necessidade desta ferramenta
+
+## Observações
+
+- `block: true` bloqueia até a tarefa ser concluída ou atingir timeout
+- `block: false` é usado para verificação não-bloqueante do estado atual
+- O ID da tarefa pode ser encontrado via comando `/tasks`
+- Aplicável a todos os tipos de tarefa: shells em segundo plano, agents assíncronos, sessões remotas
+
+## Significado no cc-viewer
+
+A chamada TaskOutput em si não gera requisições API, é uma operação interna de gerenciamento de tarefas do Claude Code e não aparece nos logs de requisição.