Índice da documentação

// Documentação do Singularity

Mission Control e o quadro Kanban

O Mission Control é a vista inicial operacional de cada espaço de trabalho. O quadro reúne tickets, prioridades e estado dos agentes para mostrar de imediato o que está pronto, ativo, bloqueado ou concluído.

Mission Control

O Mission Control abre o quadro do espaço ativo. Num relance, vês os projetos, as respetivas branches e alterações Git, os tickets distribuídos por estado e os agentes que estão a trabalhar ou que precisam da tua atenção.

A pesquisa e os comandos do quadro continuam acessíveis por cima das colunas. Clica num cartão para abrir o respetivo detalhe; os terminais e as outras ferramentas continuam disponíveis no workbench.

Mission Control a mostrar um quadro Kanban de demonstração sem dados de utilizador
O Mission Control reúne o estado dos projetos e o fluxo dos tickets numa única vista.

As colunas

O fluxo principal inclui Todo para o trabalho pronto, In progress para o trabalho assumido ou em preparação, Pending para uma execução suspensa mas recuperável, Failed para uma execução parada devido a um erro e Done para o trabalho concluído. O estado técnico Working assinala um agente ativo.

Pending não é uma falha. O agente pode estar à espera de uma resposta, de uma revisão, de tickets filhos, de um conflito ou da fila de commits. Uma intervenção humana aparece em User action. Em Todo, On hold estaciona deliberadamente tickets: continuam visíveis mas deixam de ser planeados.

O cartão de um ticket

O cartão condensa uma referência pública como A-2478, o título, o tipo, a prioridade e os projetos afetados. A letra vem do tipo — funcionalidade, bug, refatoração, documentação, teste, IA ou sessão —, enquanto um ticket pai utiliza P.

Durante uma missão, a etiqueta de atividade indica a fase do agente: leitura, escrita, teste, commit ou espera. Em Done, a resolução curta resume o resultado sem abrir o detalhe.

Criar um ticket

Clica em New ticket em Todo. Só o título é obrigatório. Podes indicar a descrição, os anexos, etiquetas, dependências, tipo, prioridade, agente e modelo, dispositivo ou branches de destino, e agendar o início se esta funcionalidade estiver ativa.

Create guarda sem lançar nenhum agente; Create and send entrega imediatamente o ticket ao agente configurado.

Mover, filtrar, ordenar

Arrasta um cartão para uma coluna para alterar o seu estado, ou dentro da sua coluna para alterar a ordem quando a ordenação manual está disponível. Os destinos inválidos continuam a ser recusados para respeitar o ciclo da execução.

A barra de ferramentas pesquisa e filtra os tickets. Os controlos de ordenação reordenam a vista; em Done, a ordem por última modificação mantém os resultados recentes no topo.

O quadro em grande escala

Cada coluna tem o seu próprio deslocamento vertical: uma lista longa não alonga as outras colunas. O quadro também se desloca horizontalmente se a janela não conseguir mostrar tudo.

Done renderiza os cartões de forma diferida em lotes de 20 e mostra os lotes seguintes à medida que desces. Os tickets arquivados ficam fora do quadro atual.

Definições do quadro

Em Settings → Kanban, a lista real é:

  • Ticket detail layout (disposição do detalhe do ticket): vista única ou dividida.
  • Maximum concurrent agents (número máximo de agentes em simultâneo).
  • Maximum retries (número máximo de novas tentativas): de 0 a 10.
  • Automatically accept splits (aceitar automaticamente as divisões), se a pré-qualificação estiver disponível.
  • Automatically accept tickets created by agents (aceitar automaticamente os tickets criados pelos agentes).
  • Automatically prioritize bugs (priorizar automaticamente os bugs).
  • Ticket status-change sound (som de mudança de estado dos tickets).

As definições dos worktrees, dos agentes e dos plugins encontram-se nos respetivos painéis dedicados.

Perguntas frequentes

Qual é a diferença entre Pending e Failed?

Pending indica uma execução em pausa mas recuperável: o agente pode estar à espera da tua resposta, de uma revisão, de tickets filhos ou da fila de commits. Failed significa que a execução parou devido a um erro e tem de ser relançada ou corrigida.

Porque é que nem todos os tickets Done são apresentados de imediato?

Done renderiza os cartões em lotes de 20 para manter fluido um quadro grande. Desloca a coluna para carregar os lotes seguintes.