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:
jiraya project create --title "Novo checkout" --icon 🛒 --lead "Ana" --repo https://github.com/acme/lojaCampos
| Campo | No app | O que faz |
|---|---|---|
| Título e ícone | — | O ícone é um emoji. |
| Descrição | Descrição | Entregue aos agentes como contexto em toda execução de tarefa do projeto. |
| Status | Status | Planejado, Em andamento, Pausado, Concluído ou Cancelado (planned, in_progress, paused, completed, cancelled). |
| Prioridade | Prioridade | A mesma escala das tarefas. |
| Líder | Líder | Um membro ou um agente que responde pelo projeto. |
| Datas | Data de início, Data de vencimento | Dias do calendário. |
| Responsável padrão | Responsável padrão | Veja abaixo. |
| Revisor padrão | Revisor padrão | Veja abaixo. |
| Limite de agentes simultâneos | Limite de agentes simultâneos | Veja Fila e limite de agentes. |
| Recursos | Recursos | Repositó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.
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.
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 é:
- tarefas que já estão em andamento;
- prioridade da tarefa;
- a tarefa mais perto de terminar;
- 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.
jiraya project update <project-id> --max-concurrent-issues 3Use --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
| Comando | O 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