# Sua primeira tarefa no Tallos: do projeto ao diff revisado

> Sua primeira tarefa no Tallos segue um ciclo: abrir um projeto, começar a tarefa num workspace próprio, dizer ao agente o que precisa, acompanhar o trabalho, revisar cada mudança e decidir se fica ou descarta a cópia. Cada workspace é um git worktree separado, então seu checkout original não muda até você decidir entregar. O ciclo leva uns dez minutos.

- Canonical: https://runtallos.com/pt/aprenda/primeira-tarefa
- English: https://runtallos.com/learn/first-task.md
- Atualizado em: 2026-09-29
- Section: Aprenda

## Em resumo

- Cada tarefa ganha seu workspace (um git worktree)
- Agentes compatíveis abrem num chat; o terminal cru está a um clique
- Revisão de diff com notas por linha que voltam para o agente
- Nada é entregue até você fazer commit, push ou abrir um PR

## O que eu preciso antes da primeira tarefa?

Você precisa do Tallos instalado, de uma CLI de agente instalada e conectada e de um repositório git na máquina. Se ainda não instalou o Tallos, siga o guia de [macOS](https://runtallos.com/pt/aprenda/instalar-no-mac) ou de [Windows](https://runtallos.com/pt/aprenda/instalar-no-windows). Se nenhum agente estiver conectado, abra Configurações → Conexões e siga [como conectar seus agentes](https://runtallos.com/pt/aprenda/conectar-seus-agentes).

- **Tallos** no macOS 13+ ou Windows 10+.
- **Um agente conectado**, como Claude Code, Codex ou Gemini CLI.
- **Um repositório git** com a branch principal limpa. Um projeto pessoal é um bom primeiro alvo.
- **Uma tarefa pequena e verificável.** Uma correção de bug, um teste ou uma mudança pequena de interface que você confere em minutos.

## Como rodar minha primeira tarefa no Tallos, passo a passo?

1. **Termine as boas-vindas** — Na primeira abertura, escolha o idioma e o agente padrão em **Qual agente de IA você usa?** e clique em **Continuar**. Por enquanto, deixe desligado **Deixar os agentes executarem comandos sem perguntar**, em Avançado: o agente vai pedir permissão antes de rodar comandos.
2. **Abra um projeto** — Clique em **Escolher uma pasta** e selecione o repositório, ou use **Clonar de uma URL**. O Tallos lê o estado do git e usa a branch padrão como base de onde todo workspace novo parte.
3. **Comece a tarefa num workspace próprio** — Clique em **Novo workspace** na barra lateral, ou no **+** ao lado do projeto. Um tour curto aponta os três campos: **Projeto**, o nome da tarefa (deixe em branco e o Tallos nomeia a partir da sua primeira mensagem) e **Agente**. Crie. O Tallos roda `git worktree add` em segundo plano e mostra o progresso na aba nova.
4. **Descreva o que você precisa** — Agentes compatíveis, como Claude Code e Codex, abrem num chat limpo por padrão. Escreva a tarefa com suas palavras: o que mudar, onde, e como você vai saber que funcionou. Agentes sem suporte a chat abrem direto no terminal.
5. **Acompanhe o agente** — Siga o progresso no chat ou clique em **Ver terminal** no topo do painel para ver a CLI crua. A barra lateral mostra quais workspaces estão trabalhando e quais precisam de você. Responda aos pedidos de permissão conforme aparecem.
6. **Teste um segundo agente (opcional)** — Quando aparecer o tour **Tente um segundo agente**, clique em **Tentar outro agente**. O Tallos entrega a mesma tarefa a outro agente, em outra cópia do projeto, e você compara os dois resultados lado a lado.
7. **Revise as mudanças** — Quando o agente terminar, clique em **Revisar mudanças**. Você vê cada alteração contra a branch de onde o workspace partiu. Deixe notas em linhas específicas e use **Enviar notas para** para devolvê-las ao agente num lote só.
8. **Fique com o trabalho ou descarte** — Para ficar com o trabalho, faça stage e commit em Source Control, dê push e clique em **Criar PR**. Para descartar, clique com o botão direito no workspace e exclua; o Tallos pede confirmação e remove a pasta e a branch. Em nenhum dos casos seu checkout principal mudou.

> Quer testar o ciclo no seu repositório? Baixe o Tallos. → https://runtallos.com/signup

## O que é um workspace no Tallos?

Um **workspace** no Tallos é uma cópia separada do repositório em disco, criada com `git worktree`, com branch própria, arquivos próprios e sessões de agente próprias. Por isso o tour diz que o original fica seguro: o agente edita a cópia, nunca o seu checkout principal. E é por isso que dois agentes trabalham ao mesmo tempo sem mexer nos arquivos um do outro. O [guia de git worktrees](https://runtallos.com/pt/aprenda/git-worktrees-para-agentes-de-ia) explica o mecanismo.

**Agente no checkout principal**
- As edições caem na pasta em que você está trabalhando
- Um segundo agente gera conflito de arquivos
- Desfazer exige `git stash` ou `git reset`

**Agente num workspace do Tallos**
- As edições caem num worktree e numa branch separados
- Cada agente tem sua cópia
- Descartar é excluir o workspace

## O que é uma boa primeira tarefa para um agente de IA?

Uma boa primeira tarefa é pequena, específica e fácil de conferir. A ideia é aprender o ciclo, não testar o limite do agente. Diga o arquivo ou a funcionalidade, o comportamento esperado e como verificar.

| Tipo de tarefa | Exemplo de prompt | Como verificar |
| --- | --- | --- |
| Correção de bug | “A data na página de fatura aparece em UTC. Mostre no fuso do usuário.” | Abra a página e compare |
| Teste | “Adicione testes unitários para `parsePrice` cobrindo string vazia e vírgula.” | Rode o comando de testes |
| Mudança pequena de UI | “Adicione um spinner de carregamento no botão Salvar do `SettingsForm`.” | Clique em Salvar e observe |
| Refatoração | “Extraia a lógica de retry de `api.ts` para um helper. Sem mudar comportamento.” | Os testes continuam passando; o diff é contido |

_Primeiras tarefas que facilitam a revisão_

## Como decido se fico com o trabalho do agente?

Fique com o trabalho só quando o diff faz o que você pediu e nada além. Leia cada arquivo, rode os testes e procure mudanças fora do escopo. Se estiver perto mas errado, anote as linhas e devolva as notas em vez de corrigir na mão. O checklist completo está em [como revisar código gerado por IA](https://runtallos.com/pt/aprenda/revisar-codigo-gerado-por-ia), e a [revisão de diff](https://runtallos.com/pt/recursos/revisao-de-diff) mostra cada ferramenta do painel.

> **Nada é entregue sem você** — O Tallos nunca faz merge sozinho. O trabalho fica na branch do workspace até você fazer commit, push e abrir um pull request, ou excluir o workspace.

## Solução de problemas: e se a primeira tarefa travar?

- **A criação do workspace falha.** A branch base pode não ter sido buscada. Rode `git fetch origin` no projeto ou escolha outra branch de partida.
- **O agente não inicia.** Rode a CLI dele (`claude`, `codex`, `gemini`…) num terminal. Se falhar lá, reinstale ou entre de novo por Configurações → Conexões.
- **O agente fica esperando para sempre.** Provavelmente ele está pedindo permissão. Abra o chat ou clique em **Ver terminal** e responda.
- **Testes ou servidor de desenvolvimento falham no workspace.** Um worktree novo não tem os arquivos ignorados pelo git, como `node_modules` ou `.env`. Instale as dependências no workspace ou liste os arquivos num `.worktreeinclude` na raiz do repositório para o Tallos copiá-los nos workspaces novos.
- **Você não acha a revisão.** Clique em **Revisar mudanças** no tour ou abra Source Control na barra lateral direita do workspace.

## O que testar depois da primeira tarefa?

Rode a mesma tarefa em dois agentes e compare os diffs; depois leia [como rodar agentes de IA em paralelo](https://runtallos.com/pt/rodar-agentes-de-ia-em-paralelo). Quando quiser que um agente líder divida e supervisione o trabalho por você, siga para [sua primeira squad](https://runtallos.com/pt/aprenda/seu-primeiro-squad).

> Teste no seu próprio repositório. → https://runtallos.com/signup

## Perguntas frequentes

### O Tallos mexe na minha branch principal enquanto o agente trabalha?

Não. Cada tarefa roda num workspace próprio, um git worktree separado com branch própria. Seu checkout principal só muda quando você mesmo faz o merge.

### Dá para conversar com o agente num chat em vez do terminal?

Sim. Agentes compatíveis abrem num chat por padrão, e Ver terminal no topo do painel mostra a CLI crua. Dá para deixar o terminal como padrão em Configurações → Agentes → Visão do agente.

### Como desfaço tudo o que o agente fez?

Exclua o workspace. O Tallos pede confirmação e remove a pasta do worktree e a branch; seu checkout principal fica intacto.

### Preciso dar nome para cada tarefa?

Não. Deixe o nome em branco e o Tallos nomeia o workspace a partir da sua primeira mensagem.

### Dois agentes podem trabalhar na mesma tarefa ao mesmo tempo?

Sim. Use Tentar outro agente ou crie um segundo workspace com outro agente. Cada um recebe sua cópia do projeto, e você compara os resultados.

### Por que o agente fica pedindo permissão?

O bypass de permissões vem desligado no Tallos, então os agentes perguntam antes de rodar comandos. Dá para mudar em Configurações → Agentes → Permissões do agente quando você confiar no agente e na tarefa.

---

**Rode seus agentes em paralelo com o Tallos** — Claude Code, Codex, Gemini e mais de 30 agentes — cada um no seu workspace, com squads, chat, terminais e revisão num só app. Usa as assinaturas que você já tem.

https://runtallos.com/signup (macOS 13+ · Windows 10+)