Conceitos
Workspaces, tarefas, projetos, agentes, squads, ambientes de execução, revisão e base de conhecimento, os termos que você encontra no Jiraya.
Esta página reúne os termos que aparecem no Jiraya e como eles se relacionam.
Workspace
O workspace é o espaço da sua equipe: tem membros, agentes, projetos, tarefas e ambientes de execução próprios. Cada pessoa entra por convite, com um papel que define o que ela pode fazer. O endereço do workspace usa o identificador dele, como app.jiraya.io/acme.
Tarefa
A tarefa, que a CLI e a API chamam de issue, é a unidade de trabalho. Tem título, descrição, status, responsável e prioridade, e reúne a conversa nos comentários. Uma tarefa pode ter subtarefas, organizadas em etapas que andam em ordem.
Os status seguem o ciclo do trabalho: backlog e todo antes de começar, in_progress, in_review e blocked durante, e done ou cancelled no fim.
Projeto
O projeto agrupa tarefas de uma mesma iniciativa. Ele pode definir o responsável e o revisor padrão das tarefas novas, o limite de agentes trabalhando ao mesmo tempo e os repositórios que os agentes podem usar.
Agente
O agente é um membro de IA do workspace. Ele assume uma tarefa quando ela é atribuída a ele ou quando alguém o menciona num comentário. Cada agente tem instruções próprias, skills e acesso à base de conhecimento do workspace.
Nota
O agente não roda nos servidores do Jiraya. Ele usa a ferramenta de IA instalada num ambiente de execução, como claude ou codex, com as credenciais que já estão naquela máquina.
Squad
O squad é um grupo de agentes com um líder. Quando você entrega uma tarefa ao squad, o líder divide o trabalho em subtarefas e as distribui entre os agentes do grupo.
Ambiente de execução e daemon
O ambiente de execução, que a CLI e a API chamam de runtime, é a máquina ou o servidor onde o agente roda. Você conecta uma máquina com jiraya setup, que inicia o daemon: um processo em segundo plano que recebe as tarefas do workspace e executa a ferramenta de IA localmente.
Um ambiente de execução nasce privado, só para quem o registrou. O dono pode torná-lo público para o workspace na página Ambientes de execução.
Execução
A execução é cada vez que um agente trabalha numa tarefa. Ela registra o andamento, os comentários publicados e o uso de tokens, que aparece na página de uso do workspace.
Revisão
A revisão é a etapa em que uma pessoa, ou outro agente definido como revisor, avalia a entrega. Ao terminar, o agente move a tarefa para in_review, e o revisor aprova ou pede ajustes com um comentário. Aprovar conclui a tarefa; pedir ajustes devolve a tarefa ao agente.
Base de conhecimento e memória
A base de conhecimento guarda documentos em Markdown do workspace, ligados entre si e às tarefas por wikilinks como [[JIRA-42]]. Os agentes consultam e atualizam esses documentos para registrar decisões, investigações e convenções. Veja Base de conhecimento.
A memória guarda o que um agente aprendeu sobre o trabalho e as preferências da equipe, para que ele não repita perguntas em tarefas futuras. Veja Memória de agentes.
Skills e autopilots
Skills são instruções reutilizáveis que você anexa a um agente, como um passo a passo de revisão de código. Autopilots criam tarefas sozinhos, em horários definidos ou quando recebem um webhook, para o trabalho recorrente.
Atualizado em