Instruções de Operação

Um guia de usuário completo. Para conceitos, veja Introdução.

Conta

Cadastro e login

Registre-se em eastagiletracker.com/register com e-mail e senha, ou continue com o GitHub se preferir OAuth. Verifique seu e-mail pelo link que enviamos; até lá, você pode entrar, mas alguns recursos ficam limitados.

Se você foi convidado para um projeto ou uma organização, siga o link no e-mail de convite — sua conta é criada (ou você faz login) e você cai diretamente no quadro correspondente.

Esqueceu sua senha? Use Forgot Password na página de login; enviamos um link de redefinição por e-mail.

Configurações da conta

A partir do avatar no canto superior direito → Account Settings:

• Profile — Nome de exibição, iniciais (usadas nos avatares de donos), e-mail.
• Bio — Uma breve descrição de si mesmo (até 4 KiB). Aparece em /me e nas listagens de membros da organização, para que um agente (ou um colega) possa escolher a pessoa certa a quem perguntar. Deixe em branco para não participar.
• Password — Mude a qualquer momento.
• Avatar — Faça upload de uma imagem ou recorra às suas iniciais.
• API Keys — Crie tokens de API pessoais; veja o Guia da API.
• Theme — Agile, Labs, Dark ou Light (também alternável na barra lateral).
• Delete Account — Uma confirmação em duas etapas. Remove você de todas as organizações e projetos.

Segurança

A partir do avatar no canto superior direito → Security:

• Dois fatores (TOTP) — Configure um código a partir de qualquer aplicativo autenticador (1Password, Authy, Google Authenticator, …). Receba 10 códigos de recuperação de uso único — eles são mostrados uma única vez, então salve-os. Desative depois com um código atual ou um código de recuperação.
• Passkeys — Adicione uma passkey WebAuthn vinculada ao dispositivo (Touch ID, Windows Hello, chave de segurança de hardware). Faça login sem senha depois disso. Adicione, nomeie e remova chaves na mesma página.

Sessões e refresh tokens

Um login bem-sucedido emite dois tokens: um access JWT de curta duração e um refresh token de longa duração (30 dias, rotacionado a cada uso). O SPA atualiza o token de acesso automaticamente quando ele expira; você permanece logado até que o refresh token expire ou você saia. O logout revoga o refresh token no servidor, então uma cópia roubada não pode ser reproduzida.

Faturamento

A maioria das contas é Free Forever para uso pessoal. Se sua conta tiver um saldo de crédito medido, encontre-o em Account → Billing — recarregue pelo checkout da Paddle, veja o histórico de transações.

Organizações

Toda conta pertence a uma ou mais organizações. Um novo cadastro recebe uma organização pessoal (“Org <Name>”) criada automaticamente, ao estilo Linear/Vercel. Os projetos vivem dentro das organizações, e a associação à organização controla a associação aos projetos.

Trocar de organização

Clique no seletor de organização na topbar para alternar entre as organizações às quais você pertence. A organização ativa colore a barra lateral, define o escopo da lista “Projects” e fica pré-selecionada quando você cria um novo projeto.

Gerenciar uma organização (admin)

Clique no bloco da organização na barra lateral → Manage organization → você cai em /organization/{id}/projects. A barra lateral exibe três abas de administração:

• Projects — Todos os projetos desta organização.
• Members — Membros atuais, papéis e convites pendentes. Convide por e-mail; o convite é vinculado ao e-mail com um token com TTL e um teto de papel (membros não podem convidar admins).
• Settings (somente owners) — Nome da organização, slug, plano. Transfira a propriedade para outro membro aqui.

Remover um membro

Remover um membro de uma organização cascateia: suas associações por projeto nos projetos dessa organização são revogadas na mesma transação. URLs de quadros salvos nos favoritos param de funcionar no momento em que ele perde o acesso à organização — não há trilha órfã.

Projetos

Criar um projeto

Na página Projects, clique em New Project. O formulário de criação pede apenas duas coisas:

• Title — Obrigatório.
• Description — Opcional; visível a todos os membros.

Todo o resto — duração da iteração, dia de início, velocidade inicial, escala de estimativa, estado pronto, alternância de tarefas — é definido depois em Project Settings e vem com padrões sensatos.

Configurações do projeto

No menu Settings do projeto, quatro abas:

• Project — Edite título, descrição, duração da iteração e dia de início, estratégia de velocidade (média das últimas 3 / 5 / 10), estado pronto, escala de estimativa, alternância de tarefas.
• Member — Convide, promova/rebaixe e remova membros humanos (veja Membros e convites, abaixo).
• Agent — Emita e revogue chaves de API de agente para este projeto (veja Agentes, abaixo). Somente owner.
• Import — Traga histórias de outro tracker (veja Importando de outros trackers, abaixo).

Membros e convites

Na aba Member de Project Settings, convide pessoas por e-mail. Os convites pendentes ficam em um balde separado até serem aceitos; você vê quem foi convidado e pode reenviar ou revogar. Membros ativos podem ser promovidos/rebaixados entre viewer, member e owner. Owners podem alterar as configurações do projeto; viewers podem ler, mas não escrever.

O histórico do projeto fica em sua própria página — cada alteração nas configurações do projeto, cada mudança de associação, com o ator (humano ou agente).

Histórias

Criar uma história

Use o recurso + Add story em qualquer painel do quadro (Current, Backlog, Icebox ou um personalizado) — digite um título e pressione Enter.

Novas histórias criadas em Current assumem por padrão current_state = 'unstarted'. Isso é paridade com o PT: uma iteração Current é um plano de trabalho, não uma partição por estado. O dono explicitamente Inicia a história quando começa o trabalho — o relógio do tempo de ciclo não dispara até então.

Obrigatório: título. Escolha um tipo (padrão feature). Adicione descrição, estimativa (somente features), labels, donos, seguidores, bloqueios — qualquer um deles pode ser preenchido depois pelo painel de detalhes.

Pressionou Enter duas vezes rapidamente? Sem problema — o botão é protegido; você obtém exatamente uma história.

Estimar features

Features são o único tipo que recebe pontos. Clique no círculo de pontos em um card (ou no painel de detalhes) e escolha na escala. Features não estimadas mostram um círculo em branco.

• Escala Fibonacci — 0, 1, 2, 3, 5, 8, 13. XP padrão. Qualquer coisa maior que 13 deve ser dividida em histórias menores.
• Escala East Agile — 0, 1, 2, 3. Mais enxuta. Um 3 significa uma iteração inteira do tempo de uma pessoa. Nada cabe além de 3.
• Escala 3-Point — 1, 2, 3 (Pequena / Média / Grande). Dimensionamento estrito tipo tamanho de camiseta — sem opção zero, sem meios-pontos.

Escolha a escala uma vez em Project Settings; você pode mudá-la depois (as estimativas existentes são mapeadas entre elas).

Avançar o estado

Três maneiras de mover uma história pelo ciclo de vida:

1. Clique no botão de ação inline no card — Start, Finish, Deliver, Accept, Reject. O texto do botão reflete o próximo estado válido para o tipo da história.
2. Arraste o card para uma coluna diferente. O sistema aplica a transição que o cruzamento daquela coluna implica. Movimentos para trás pedem confirmação.
3. Transição em massa — Selecione várias histórias, Transition all — cada história transiciona de forma independente. Se uma for ilegal, as outras ainda passam.

Painel de detalhes

Clique em qualquer lugar de uma linha de história para expandi-la inline. O painel de detalhes mostra:

• Título (editável), descrição (Markdown), tipo, estimativa, solicitante.
• Donos (adicionar/remover membros ou agentes), seguidores, labels.
• Tarefas (se habilitadas), comentários, anexos, bloqueios, links, revisões.
• Um menu de 3 pontos para duplicar, excluir e outras ações menos comuns.

Pressione Escape para fechar a história aberta mais recentemente (ele lembra a pilha — recolha uma de cada vez).

Comentários

Até 10.000 caracteres, renderizados em Markdown. Edite e exclua seus próprios comentários; a trilha de auditoria mantém o histórico. @-mencione membros e o autocompletar os identifica.

Anexos

Arraste um arquivo para o painel de detalhes ou use o botão de upload. Até 2 GB por arquivo — sim, grande o suficiente para vídeos de demonstração com gravação de tela. Use o reprodutor de vídeo inline.

Labels

Na página Labels da barra lateral: crie labels com nomes e cores, arquive quando ficarem obsoletas (labels arquivadas desaparecem do quadro, mas permanecem pesquisáveis). Adicione labels por história no painel de detalhes.

Bloqueios, links, revisões

• Bloqueios — Uma nota de texto livre “isto está bloqueado por X”. Marque como resolvido/não resolvido. Filtre o quadro por has:blocker.
• Links — Seis tipos de relacionamento: relates to, duplicates, blocks, is blocked by, pull request, branch. Cole uma URL do GitHub e o tipo é detectado automaticamente.
• Revisões — Atribua um revisor (humano ou agente) com um status (pending, approved, rejected) e um comentário opcional.

Tarefas

Se habilitadas em Project Settings, as histórias ganham subtarefas — uma checklist dentro da história. Marque-as conforme avança; a contagem aparece no card.

Referência de campos da história

Toda variável de escolha na superfície de detalhe da história carrega um pequeno ícone [?] ao lado de seu rótulo. Clique nele no aplicativo para ver a mesma orientação resumida abaixo. Os tradutores entregam o texto do aplicativo junto com o restante da interface; esta seção é a referência canônica em formato longo.

Os campos são listados na ordem em que aparecem na aba Overview.

Status

O lugar da história no ciclo de vida: Unstarted → Started → Finished → Delivered → Accepted (ou Rejected de volta para Started).

O estado crítico é Delivered: o engenheiro a marca como entregue, mas ela não está pronta até que o product owner explicitamente a Aceite em relação aos critérios de aceitação — ou a rejeite, devolvendo-a. Isso embute um ciclo de feedback do cliente em cada história, em vez de adiar a aceitação para uma demonstração no fim da sprint.

Se as histórias se acumulam em Delivered, esse é um sinal de que o ciclo de aceitar/rejeitar travou. Observe a contagem de Delivered no fim de cada iteração — se estiver crescendo, esse é o seu sinal de que o product owner está sem recursos ou de que os critérios de aceitação não estão claros o suficiente desde o início.

Iteração

Em qual iteração a história está planejada. Deixe como None para manter a história no Backlog, onde o sistema a agrupará automaticamente sob uma iteração futura com base na velocidade.

A sobreposição manual aqui é útil quando você quer fixar uma história em uma iteração específica, independentemente da ordem — por exemplo, vinculando uma história de release a uma data fixa. Caso contrário, deixe a ordem no Backlog conduzir a atribuição de iteração; é isso que mantém a projeção de velocidade honesta.

Donos

Quem está fazendo o trabalho. Os donos podem ser humanos ou agentes — ambos aparecem como participantes nomeados na trilha de auditoria, na autoria de comentários e nas análises. Não há como disfarçar um dono agente como humano.

Múltiplos donos são a expressão visível da programação em par (ou par com agente). Adicione o agente que pegou a história e o humano que está revisando — ambos os nomes aparecem no card. Isso mantém o trabalho em progresso baixo; terminar antes de iniciar a próxima história é a maior alavanca individual sobre o tempo de ciclo.

Os donos não são o mesmo que Seguidores (um campo separado no card). Seguidores são pessoas que se importam com a história, mas não estão fazendo o trabalho — tipicamente assinantes de notificações.

Tipo de história

Os quatro tipos não são intercambiáveis — a distinção é o ponto central do modelo de dados.

• Feature — Novo valor observável pelo usuário. O único tipo que carrega pontos e conta para a velocidade. Isso obriga você a fatiar o trabalho em valor que o usuário pode ver.
• Bug — Um defeito. Sem pontos. Defeitos não rendem crédito de velocidade, o que mantém o custo do retrabalho visível em vez de recompensado.
• Chore — Trabalho necessário sem valor direto para o usuário (refatorações, infra, configuração). Sem pontos. A equipe é pressionada a agrupar chores em features sempre que possível, para que o enquadramento de valor permaneça honesto.
• Release — Um marcador de zero pontos para um marco. Vai direto de Unstarted para Accepted, ancorando uma data para a projeção.

Se você se pegar querendo pontuar um bug ou chore: não faça isso. Isso quebra a projeção que torna todo o sistema honesto. A velocidade é um instrumento de medição; você não adultera seu próprio instrumento.

Prioridade

Não use isto se puder evitar. O Backlog é a prioridade — de cima a baixo, prioridade única, sem empates. O product owner é dono da ordem.

Um campo de “prioridade” é o clássico antipadrão que silenciosamente converte um backlog empírico e ordenado de volta em planejamento ilusório. Se você se pegar com três P1s, você não tem uma prioridade — você tem um Backlog com a ordem errada. Corrija a ordem; exclua o sinal de prioridade.

O campo existe para compatibilidade com importações de trackers que usam um (Jira, Asana, …) para que histórias importadas não percam informação na entrada. Deixe-o em “None” em trabalho novo.

Pontos

Tamanho relativo da história. Features recebem pontos; bugs, chores e releases permanecem em zero.

A estimativa é uma conversa de dimensionamento, não uma promessa. Não traduza pontos em horas; não infle pontos para parecer rápido. A velocidade é um instrumento de medição — você não adultera seu próprio instrumento.

Três escalas estão disponíveis:

• Fibonacci — 0, 1, 2, 3, 5, 8, 13. A clássica escala do XP. Qualquer coisa maior que 13 deve ser dividida.
• East Agile — 0, 1, 2, 3. Uma escala mais enxuta. Um 3 significa uma iteração inteira do tempo de uma pessoa.
• 3-Point — 1, 2, 3 (Pequena / Média / Grande). Dimensionamento estrito tipo tamanho de camiseta.

Se você está frequentemente estimando em 5s, 8s ou 13s, suas histórias são grandes demais. Divida até que cada uma seja entregável de forma independente (o S e o I de INVEST).

Solicitante

Quem pediu a história. Geralmente uma pessoa — o product owner, uma parte interessada ou um agente atuando em nome de alguém.

O solicitante não é o dono. O dono é quem está fazendo o trabalho; o solicitante é quem se importa com o resultado e o aceitará (ou não). Podem ser a mesma pessoa, mas são papéis distintos. Registrar o solicitante é o que te dá a resposta de auditoria para “quem pediu isto?” seis meses depois.

Labels

Tags coloridas. As histórias podem carregar várias. Usadas para categorização transversal — mvp, tech-debt, security, um nome de release específico — e para filtragem do quadro (label:mvp na caixa de busca, ou salve como um painel de filtro personalizado).

As labels têm escopo de projeto. Gerencie-as na página Labels na barra lateral. Arquive labels obsoletas em vez de excluí-las; o arquivo mantém o histórico pesquisável enquanto limpa o quadro.

Bloqueios

Notas de texto livre descrevendo o que está impedindo o avanço desta história. Marque como resolvido quando o impedimento for removido.

Os bloqueios são um sinal de fluxo, não uma fila. Use a reunião diária para evidenciá-los; resolva-os fora de banda. Se você tiver mais de um ou dois bloqueios abertos por história por mais de um dia, o planejamento está errado — divida a história ou mude a dependência. O objetivo é que o painel Blocked fique majoritariamente vazio na maior parte do tempo.

Descrição

O que a história é e como reconhecer que ela está pronta. Markdown.

Os critérios de aceitação pertencem aqui — idealmente no formato Given / When / Then, para que mapeiem diretamente em testes de aceitação:

Given I am signed in as a member
When I click "Add a story" in Current
Then the story is created in state "unstarted"

INVEST é a verificação de sanidade sobre se uma história está bem formada:

• Independent (Independente) — pode ser liberada sem outras histórias.
• Negotiable (Negociável) — captura a intenção, não uma especificação congelada.
• Valuable (Valiosa) — para um usuário ou parte interessada.
• Estimable (Estimável) — a equipe consegue dimensioná-la.
• Small (Pequena) — cabe confortavelmente em uma iteração.
• Testable (Testável) — tem critérios de aceitação que podem ser exercitados.

Uma história no topo do backlog com critérios de aceitação vagos é um bug de planejamento — não um problema futuro a ser ignorado. Corrija-a antes de deixá-la avançar.

Ações em massa

Selecione várias histórias no quadro (shift-clique para faixa, ou Select all in panel). Então:

• Transição em massa
• Exclusão em massa
• Duplicação em massa

O quadro

O quadro é a tela inicial de cada projeto. Três colunas por padrão:

• Current — Histórias na iteração ativa. Agrupadas por cabeçalho de iteração (atual, depois futuras, depois fechadas). Os cards aparecem em ordem de sequência temporal de iteração, com seu estado visível em cada card; a coluna não é fatiada por estado — isso quebra a sequência temporal de iteração em que a equipe planeja.
• Backlog — Fila estritamente ordenada. O sistema agrupa automaticamente as iterações futuras com base na velocidade. O product owner é dono da ordem de cima a baixo; a clareza pode degradar conforme você rola para baixo, mas nunca no topo.
• Icebox — Ideias sem data. Sem ordem, sem estimativa. O Icebox tem permissão para ser um cemitério.

Painéis configuráveis — caixas de seleção da barra lateral

A seção Board da barra lateral lista cada coluna preset com uma caixa de seleção: marque uma caixa para mostrar essa coluna, desmarque para ocultá-la. As alternâncias persistem por projeto por usuário (são sincronizadas via GET/PUT /preferences). Os presets são:

• Current Iteration (ativo por padrão)
• Backlog (ativo por padrão)
• Icebox (ativo por padrão)
• Done — Histórias aceitas.
• My Work — Histórias onde você é um dono.
• Blocked — Histórias com bloqueios não resolvidos.
• Epics — Agregações em nível de épico.
• Chat — Coluna de chat com escopo de projeto.

Painéis de filtro personalizados

Fixe uma busca como painel: cole uma consulta como type:feature label:mvp owner:claire, salve-a. Redimensione as colunas como quiser; as larguras persistem entre sessões.

Busca

A barra de busca aceita a sintaxe de filtro descrita em Introdução. Os resultados da busca ficam em um painel de resultados; clique em qualquer um para pular até ele no quadro.

Chip da iteração atual

A barra superior mostra o número da iteração atual, o intervalo de datas e os pontos aceitos vs. planejados. Clique para pular para a coluna Current.

Iterações

O sistema cria iterações automaticamente com base na sua duração e dia de início. Você não precisa “abrir” ou “fechar” iterações.

Para planejar com antecedência, arraste histórias do Backlog para grupos de iterações futuras. O sistema marca os grupos em vermelho se eles excederem sua velocidade. Para planejar mais à frente, role o backlog — ele mostra três ou quatro iterações adiante.

Para retroceder: clique em qualquer cabeçalho de iteração passada na coluna Current para detalhar o relatório da iteração.

Releases

Releases são um tipo de história, não um objeto separado. Crie um release da mesma forma que criaria qualquer história: escolha Release como o tipo, dê um nome (por exemplo, v2.4), arraste-o para a iteração em que você pretende lançar.

Releases pulam os estados Started/Finished/Delivered/Rejected — vão de Unstarted para Accepted em um único passo. Aceite um release quando você lançar; as visões de análise exibem o marcador de release.

Análises

A aba Analytics (no topo do projeto) oferece seis relatórios:

• Project Overview — Tendência de velocidade, KPIs da iteração recente, burnup, burndown, fluxo cumulativo.
• Iteration — Detalhe em uma única iteração: KPIs, burndown, fluxo de estado.
• Releases & Burndowns — Linha do tempo de releases, burndown por release.
• Story Activity — Quem fez o quê, filtrável por ator, tipo, intervalo de datas.
• Cycle Time — Média e distribuição do tempo de Started até o seu estado pronto.
• Projections — Previsão de quando o backlog estará concluído na velocidade atual.

Agentes

Esta é a parte do produto que o diferencia. Um agente é um colega de equipe nomeado — mas é uma IA.

Adicionar um agente a um projeto

Você precisa ser um owner (ou admin) do projeto. Abra Project Settings → Agents:

1. Create new agent key.
2. Dê um nome ao agente (ele aparecerá com esse nome nas trilhas de auditoria, na autoria de comentários e nos avatares de donos).
3. Escolha um papel — viewer (somente leitura) ou member (pode escrever). O papel de owner é restrito a humanos.
4. A chave é exibida uma única vez — copie-a; não a armazenamos de forma recuperável. O prefixo é ea_agent_….

O que os agentes podem fazer

Um agente com papel member pode fazer qualquer coisa que um membro humano pode:

• Criar, editar, transicionar, excluir histórias
• Comentar, anexar arquivos, adicionar labels, definir donos
• Escolher a si mesmo como dono de uma história
• Ler atividade, acompanhar eventos

A trilha de auditoria registra cada escrita com a identidade do agente. Não há como fazer uma ação de agente parecer uma ação humana.

Gerenciar chaves de agente

Em Project Settings → Agents você vê todas as chaves ativas, seus nomes, papéis e o carimbo de horário do último uso. Revogue uma chave a qualquer momento; o agente perde o acesso imediatamente. A atividade passada do agente permanece na trilha de auditoria para sempre.

Usar agentes com a API

Veja Guia da API → Chaves de agente para exemplos de código.

Importando de outros trackers

Se você está vindo de outra ferramenta, temos importadores para oito fontes:

• Pivotal Tracker
• Jira
• Asana
• GitLab
• Shortcut
• Trello
• Linear
• Plane

Em Project Settings → Import, faça upload de uma exportação (CSV da maioria, JSON do Plane). Histórias, donos, comentários, labels e estados são mapeados automaticamente; algumas fontes também trazem iterações.

Uma prévia mostra o que será importado. Incompatibilidades (por exemplo, uma label que não existe no seu projeto) geram uma escolha — criar-ou-pular, você decide.

Temas

Quatro temas disponíveis. Troque no rodapé da barra lateral (ou em Account Settings → Theme):

• Agile — A paleta da landing page de marketing. Brancos quentes, acento de marca azul-escuro (#1f6f9f), ícones de tipo de história saturados. Opção principal no seletor.
• Labs — A paleta do Pivotal Tracker, preservada com carinho. Interface escura, topbar azul, intervalos de coluna em pastel. A original.
• Dark — Escuro neutro puro.
• Light — Claro neutro puro. Tinta no papel.

Seu tema persiste entre sessões.

Idioma

A interface é traduzida para 15 idiomas: inglês, francês, alemão, espanhol, japonês, chinês, coreano, português, italiano, holandês, sueco, dinamarquês, tcheco, finlandês, polonês. Troque no rodapé da barra lateral — a interface, as páginas de autenticação, a área de conta/segurança, a lista de projetos e a landing de marketing se localizam imediatamente. A localização de detalhe de história / análises / configurações vem a seguir.

Atalhos de teclado

Alguns que valem a pena:

• Escape — Recolhe a história aberta mais recentemente.
• Enter em um campo inline — Enviar (não recolhe a linha).
• Shift-clique — Seleção de faixa de histórias.

Mais são adicionados ao longo do tempo; veja Help na barra lateral para a lista atual.

Auto-hospedagem

O East Agile Tracker é de código aberto. O código-fonte completo está em github.com/EastAgile/agile-tracker — clone, compile e execute na sua própria infraestrutura. O mesmo conjunto de recursos da versão hospedada.

Para a configuração, veja o README do projeto.