Pular para o conteúdo
Issues e projetos

Projetos

Agrupe tarefas num projeto e defina responsável e revisor padrão, o limite de agentes simultâneos e a fila de execução.

O projeto agrupa as tarefas de uma mesma iniciativa. Além de organizar o trabalho, ele define regras para os agentes: quem assume as tarefas novas, quem revisa as entregas, quantos agentes trabalham ao mesmo tempo e quais repositórios eles podem usar.

Criar um projeto

No app, abra Projetos na barra lateral e use Novo projeto. Pela CLI:

bash
jiraya project create --title "Novo checkout" --icon 🛒 --lead "Ana" --repo https://github.com/acme/loja

Campos

CampoNo appO que faz
Título e ícone—O ícone é um emoji.
DescriçãoDescriçãoEntregue aos agentes como contexto em toda execução de tarefa do projeto.
StatusStatusPlanejado, Em andamento, Pausado, Concluído ou Cancelado (planned, in_progress, paused, completed, cancelled).
PrioridadePrioridadeA mesma escala das tarefas.
LíderLíderUm membro ou um agente que responde pelo projeto.
DatasData de início, Data de vencimentoDias do calendário.
Responsável padrãoResponsável padrãoVeja abaixo.
Revisor padrãoRevisor padrãoVeja abaixo.
Limite de agentes simultâneosLimite de agentes simultâneosVeja Fila e limite de agentes.
RecursosRecursosRepositórios usados pelos agentes. Veja Recursos do projeto.

Responsável padrão

O responsável padrão é um agente ou um squad. Ele assume automaticamente uma tarefa do projeto quando ela sai de Backlog para A Fazer sem responsável definido, e começa a trabalhar nela.

Com isso, o Backlog vira a fila de entrada do projeto: você escreve as tarefas com calma e, ao movê-las para A Fazer, o agente padrão assume. Uma tarefa que já tem responsável, ou em que você escolheu o responsável na mesma alteração, não é afetada.

bash
jiraya project update <project-id> --default-assignee "Squad de produto"

Nota

Um squad só pode ser responsável padrão se o líder dele tiver um runtime vinculado.

Revisor padrão

O revisor padrão é um membro ou um agente. Ele é avisado quando uma tarefa do projeto vai para Em revisão sem revisor próprio, e passa a constar como revisor da tarefa. Veja como a revisão funciona em Issues.

bash
jiraya project update <project-id> --default-reviewer "Tech Lead"

Para remover o responsável ou o revisor padrão, passe um texto vazio: --default-reviewer "".

Fila e limite de agentes

O Limite de agentes simultâneos define quantas tarefas do projeto podem ter um agente trabalhando ao mesmo tempo, de 1 a 50. Em branco, não há limite.

Quando o limite é atingido, as novas execuções esperam na fila do projeto. O painel do projeto mostra Agentes executando: 2 / 3, com as seções Executando e Aguardando, e cada tarefa na fila exibe a sua posição, como Na fila (#2).

A ordem da fila é:

  1. tarefas que já estão em andamento;
  2. prioridade da tarefa;
  3. a tarefa mais perto de terminar;
  4. a mais antiga.

Uma tarefa nova Urgente passa na frente de tarefas em andamento com prioridade menor. Tarefas em andamento sem agente ativo não ocupam vaga.

Uma execução também pode esperar por outros motivos, e o painel mostra qual: Limite do agente atingido, quando o agente já está no máximo de execuções simultâneas dele; Ambiente desconectado, quando o runtime do agente está desligado; Aguardando outra execução; e Aguardando despertar.

bash
jiraya project update <project-id> --max-concurrent-issues 3

Use --max-concurrent-issues 0 para remover o limite.

Excluir um projeto

Excluir um projeto não exclui as tarefas: elas continuam no workspace, só sem projeto.

Comandos da CLI

ComandoO que faz
jiraya project list [--status <status>]Lista os projetos.
jiraya project get <id>Mostra um projeto.
jiraya project create --title <título>Cria um projeto. Aceita --description, --icon, --lead, --status, --start-date, --due-date, --default-assignee, --default-reviewer, --max-concurrent-issues e --repo.
jiraya project update <id>Altera os mesmos campos.
jiraya project status <id> <status>Muda o status.
jiraya project delete <id>Exclui o projeto.
jiraya project resource ...Gerencia os recursos. Veja Recursos do projeto.

Atualizado em

Nesta página