Como o Clarvis funciona
Entenda os agentes, as sessões, os planos e as outras partes de uma tarefa no Clarvis.
Comece pelo ciclo do operador
O Clarvis ajuda você a trabalhar em um projeto pelo terminal. Escolha um agente, um modelo e os controles de segurança, depois descreva o resultado desejado. O agente pode ler arquivos, usar ferramentas, alterar código, delegar trabalho ou fazer perguntas. Você define o objetivo e quais ações ele pode executar.
workspace -> sessão -> execução -> agente líder -> ferramentas e subagentes -> resultadoUm workspace é o diretório de projeto em que o Clarvis está operando. Ele determina quais arquivos do projeto, configurações do workspace e históricos de sessão estão no escopo.
Uma sessão é a conversa durável daquele workspace. Ela mantém o histórico da conversa e o uso ao longo de vários turnos. /sessions abre o histórico de sessões, /export grava o histórico da conversa persistido completo e /clear arquiva a sessão atual antes de iniciar uma nova.
Uma execução é o trabalho ativo iniciado por uma tarefa enviada. Enquanto estiver ativa, uma nova entrada orienta esse trabalho em vez de criar uma execução concorrente. /status mostra o agente e o modelo atuais, o estado da execução, o uso de tokens e o custo.
Agentes definem como o trabalho é realizado
Um perfil de agente define seu prompt de sistema, modelo, esforço de raciocínio, permissões, orçamento e capacidade de delegar. Você pode substituir por completo o prompt de sistema de qualquer agente integrado. Use /agent para escolher o líder da próxima execução ou /settings/agents para editar um perfil.
O líder é responsável pela resposta final. Quando a delegação está disponível, ele pode enviar uma tarefa planejada a um subagente ou iniciar trabalho independente e delimitado. Cada filho tem seu próprio perfil, contexto, ferramentas e orçamento. Os resultados voltam ao pai; a visualização de atividade e o histórico da conversa mostram quem é responsável por cada ramo, seu estado atual e o resultado da conclusão.
A delegação é útil quando o trabalho pode avançar de forma independente. Ela não é paralelismo sem custo: cada filho usa contexto do modelo e ferramentas. Por isso, o líder deve delegar um objetivo claro e evitar duplicar a mesma investigação.
Workflows tornam a orquestração reutilizável
Um workflow salva uma sequência de trabalho com vários agentes. Use-o para repetir o mesmo processo, como uma investigação seguida de implementação e revisão.
Digite /workflow para navegar pelas execuções de workflow atuais e anteriores e inspecionar suas árvores de gerenciador e agentes. As definições de workflow ficam em catálogos integrados, globais ou do workspace e são selecionadas quando o Admiral inicia um workflow. Um workflow organiza a execução; o histórico da conversa da sessão ainda registra o que aconteceu e os controles normais de segurança continuam valendo para cada chamada de ferramenta.
Planos tornam a intenção inspecionável
Um plano é o registro ordenado de execução usado pelo agente para decompor um resultado em trabalho verificável. No planejamento normal, o agente pode criá-lo e segui-lo durante a execução. Com revisão de plano ativa, o Clarvis pausa depois da proposta e espera sua decisão antes de começar a implementar.
Planos não são workflows. Um plano descreve as etapas de um objetivo; um workflow define uma estrutura reutilizável de gerenciador e líderes capaz de iniciar várias execuções focadas. Pressione Ctrl+P para inspecionar o plano atual ou mais recente e use /plan para alternar a revisão obrigatória no workspace.
Memória leva o conhecimento do projeto adiante
A memória é uma wiki Markdown local ao workspace, separada do histórico da conversa da sessão. No início da execução, seu resumo raiz limitado fornece aos agentes conhecimento durável do projeto. Depois da execução, uma indexação em segundo plano decide se comandos verificados, decisões, armadilhas ou outro conhecimento não óbvio merecem uma atualização coerente. A maioria das execuções não precisa alterar a memória.
Como a wiki usa Markdown simples em vez de um banco vetorial, você pode inspecionar e editar exatamente o que as próximas execuções poderão reutilizar. Configure em /settings/memory e use memory-policy.md para dizer o que vale a pena preservar.
Tarefas conectam uma fonte externa da verdade
Tasks é uma conexão opcional com um serviço externo de tarefas. /tasks mostra os itens desse serviço sem copiá-los para um banco do Clarvis. Escolha Work on task para iniciar uma execução vinculada ao item no projeto atual.
Ler e alterar tarefas exige permissões separadas. Escritas vêm desabilitadas e exigem modo de trabalho, permissões compatíveis do agente e suporte do provedor. Concluir uma execução do Clarvis nunca muda automaticamente o ciclo de vida de uma tarefa externa.
Extension Profiles definem o conjunto ativo de capacidades
Plugins podem adicionar agentes, ferramentas, hooks e outros serviços. Skills fornecem instruções reutilizáveis. Um Extension Profile lista quais plugins e skills independentes estarão disponíveis nas próximas execuções.
Você pode manter perfis separados para pesquisa, programação, revisão ou outros tipos de trabalho e alternar entre eles no mesmo workspace. Perfis globais podem ser reutilizados em vários workspaces. Cada perfil próprio inclui somente as extensões selecionadas nele.
Abra /extensions para encontrar extensões e escolher seu conjunto ativo. O editor guiado permite revisar as mudanças antes de aplicá-las. O navegador de Plugins também oferece uma ação explícita para instalar e ativar de uma vez. Conteúdo executável do repositório exige aprovação do workspace. O Clarvis registra o perfil e seu identificador de conteúdo (fingerprint) em cada execução e sessão.
O contexto é menor que o transcript
A sessão persistida é o registro durável. O contexto do modelo é o conjunto de trabalho limitado enviado a uma chamada de modelo. O Clarvis pode recolher conteúdo antigo do histórico da conversa para fora da visualização ativa e compactar contexto antigo, permitindo que uma sessão continue sem reenviar tudo.
Use /compact quando quiser solicitar isso deliberadamente. Adicione uma instrução curta de preservação quando decisões específicas precisarem permanecer:
/compact preserve o formato de API aceito e a falha não resolvida no WindowsA compactação não substitui o histórico da conversa persistido. Use /export quando precisar do registro completo, incluindo material que não está mais montado na visualização ativa.
Acompanhe uma execução do início ao fim
- O Clarvis resolve a configuração global/do workspace efetiva e o Extension Profile selecionado.
- Você seleciona o agente líder e a configuração de segurança da próxima execução.
- Seu prompt, ou uma tarefa externa em que escolheu trabalhar, inicia uma execução na sessão atual.
- O líder pode criar um plano, chamar ferramentas permitidas e delegar trabalho delimitado.
- O Clarvis pausa para decisões obrigatórias sobre comandos, planos, workflows ou solicitações ao usuário.
- Os resultados dos filhos voltam ao pai e o líder produz a resposta final.
- A sessão mantém histórico da conversa e eventos para retomada ou exportação.
- Quando configurada, a memória enfileira uma revisão em segundo plano do conhecimento durável.
Se a configuração efetiva não puder iniciar com segurança, /doctor explica a verificação bloqueadora e oferece a tela de reparo correspondente.
Termos usados nesta documentação
| Termo | Significado |
|---|---|
| System prompt | Instruções que definem o papel e o modo de trabalho do agente. Você pode substituir o prompt integrado por completo. |
| Skill | Instruções reutilizáveis, com scripts e arquivos de referência opcionais, carregadas quando necessário. |
| MCP | Model Context Protocol: uma forma de conectar ferramentas e informações de outros serviços. |
| Hook | Ação disparada por um evento, como uma chamada de ferramenta ou o fim de uma execução. |
| Snapshot | Versão fixa do conjunto de extensões usado por uma execução. |
| Fingerprint | Identificador calculado a partir do conteúdo, usado para detectar mudanças. |
| TUI | A interface interativa que você usa no terminal. |
| Kernel | A parte do Clarvis que gerencia as execuções, ferramentas e configurações de um projeto. |