Workflows

Workflows dizem como o Faundr trabalha no seu projeto. Cada um é um roteiro de passos que o agente segue quando o pedido fala de um assunto: "sempre que for de design, leia o design.md, mostre o plano, construa, audite e confira no celular".

Sem workflow, o agente decide o caminho a cada pedido. Com workflow, ele segue o jeito que o time combinou, e você acompanha no canvas em que passo ele está.

As abas

Todas abrem no mesmo canvas: clique numa peça para ver o detalhe dela no painel ao lado.

Do Faundr

Os desenhos vêm do próprio Faundr, marcados com Padrão do Faundr, então contam o que ele faz de verdade: cada decisão é um losango (o sim e o não), o que roda ao mesmo tempo fica lado a lado, e cada passo diz a skill ou o comando que usa.

Automáticos: Início da sessão, Cada pedido, Antes de editar, Antes de um comando, Depois de um comando, Fim da resposta, Checagens no fundo, Arquitetura fora do plano e Fim da sessão.

Skills do Faundr: uma por skill (planning, design, security, merge, undo…), com os modos, onde ela pergunta a você e onde termina. Cada uma diz se roda só quando você chama no terminal ou se o agente também chama sozinho, e quem do Faundr chama ela (ex.: o Fim da resposta chama a auditoria de design). Os comandos curtos de registro e de configuração ficam em dois desenhos: Registro do trabalho e Configuração.

Os passos não se editam. O que dá para fazer é desligar passos neste projeto; os outros mostram por que ficam sempre ligados. Nas skills do Faundr, só os passos opcionais desligam (ex.: medir no navegador na auditoria de design, a revisão por subagente no planejamento, a cobertura nos testes): quando a skill entra, o Faundr avisa o agente quais pular. Segurança, prova de que funciona e perguntas a você nunca desligam. Cada mudança vale para o time todo a partir do próximo pedido (as do início da sessão, na próxima sessão). Voltar ao padrão religa tudo.

Quando uma versão nova do Faundr muda um desenho:

• se ninguém mexeu nele, ele atualiza sozinho;
• se o projeto desligou algum passo, aparece Nova versão do Faundr com o que mudou. Atualizar volta ao padrão novo, com tudo ligado; Manter o meu fica com os passos que vocês escolheram.

O que tem num workflow

Cada workflow chega ao agente uma vez por sessão, para não repetir.

Gatilho: quem chama e quando entra

Workflows do time, skills e skills do Faundr têm o mesmo gatilho, no painel ao lado do canvas:

Quem chama

• Você e a IA (padrão): o agente também chama sozinho quando o gatilho bate.
• Só você no terminal: o agente não chama sozinho. Se ele tentar rodar a skill, o Faundr barra; quando o gatilho bate, ele só lembra você em uma linha ("isso parece trabalho para /x, quer rodar?"). Skill que a própria skill marca como "só a pessoa chama" fica sempre assim.

Quando entra (marque quantos quiser)

No horário é um lembrete agendado: o Faundr nunca abre o agente sozinho. Quando a hora passa, a próxima sessão aberta no projeto (a de quem estiver trabalhando) recebe o pedido, uma vez só. Se ninguém abriu sessão por dias, entra só o mais recente, sem acumular. O painel mostra o próximo horário e o último entregue; mudar o horário não dispara um que já passou hoje.

Uma mudança no gatilho vale a partir do próximo pedido, sem reiniciar a sessão.

As peças

Cada peça tem uma forma própria no canvas, para dar para ler o fluxo de longe:

Monte arrastando: a paleta à esquerda tem as peças e as skills ligadas ao projeto. Arraste para o canvas, ou clique para pôr embaixo da peça escolhida (já ligada a ela). Ligue arrastando da bolinha de uma peça até outra, em qualquer lado: em cima e à esquerda entram, embaixo e à direita saem. Dois cliques no nome de uma peça editam ali mesmo. Organizar arruma em camadas, com os ramos lado a lado.

Uma ligação pode ter uma condição escrita ("se for de design"): o agente só segue por ela quando a condição vale.

A caixa O que a IA lê, no painel ao lado, mostra o texto exato que ele recebe, com os passos numerados na ordem.

Skills do projeto

Na aba Skills ficam as skills que o time já usa no projeto, de três origens:

• Do projeto: as das pastas .claude/skills (Claude Code) e .agents/skills (Codex) do repositório.
• Pessoais: as da pasta de skills de cada pessoa, no computador dela (~/.claude/skills no Claude Code; ~/.agents/skills ou ~/.codex/skills no Codex).
• De plugin: as dos plugins do Claude Code e do Codex ligados para aquela pasta (o card mostra o nome do plugin).

As skills do próprio Faundr não aparecem aqui: elas têm desenho próprio na aba Do Faundr. Os botões no topo filtram por origem, e a busca procura no nome, na descrição, no quando usar e nos assuntos.

Conectar

Rode /faundr:skills no agente (ou clique em Conectar ou atualizar, que copia o comando). O Faundr lê as skills do computador e o agente escreve, para cada uma:

• Quando usar: uma frase do ponto de vista do pedido, como "pedido para escrever ou melhorar o texto de uma página".
• Assuntos: de 2 a 5 palavras ou expressões que, aparecendo no pedido, devem lembrar o agente dela (ex.: headline, texto da home). Sem assunto, vale o nome da skill.

Para ajustar só uma, rode /faundr:skills <nome>. Enquanto houver skills sem quando usar, a aba mostra quantas são, com o botão Pedir à IA para escrever.

Cada sessão relê as skills sozinha, então uma skill nova aparece no painel sem você fazer nada. Uma skill que saiu do computador de todo mundo some da lista. No detalhe, o painel mostra em quantos computadores do time ela está.

O lembrete pelo assunto

Quando o pedido fala de um assunto de uma skill, o Faundr lembra o agente dela antes de ele ler o pedido, mesmo fora de um workflow. O lembrete traz o nome da skill e o quando usar, e o agente chama a skill antes de fazer à mão, se fizer sentido.

• Cada skill é lembrada no máximo uma vez por sessão, e entram no máximo 2 skills por pedido.
• Se você já digitou /nome no começo do pedido, o lembrete não vem.
• Tudo roda no seu computador, sem IA e sem internet, a partir de uma cópia local da lista.
• O passo Bate com uma skill ligada?, no desenho Cada pedido (aba Do Faundr), desliga esse lembrete para todas as skills de uma vez.

Além do assunto, uma skill pode entrar nos outros momentos do gatilho (veja acima): antes de editar certos arquivos, no fim da resposta, depois de um commit, no horário e assim por diante.

Skills manuais

Algumas skills só deixam a pessoa chamar (a própria skill diz isso no arquivo dela). Elas aparecem com só a pessoa chama. Quando o assunto bate, o agente não roda a skill: ele lembra você em uma linha, como "isso parece trabalho para /nome, quer rodar?". No canvas, a skill ganha antes um passo Você roda /nome.

Você também pode deixar qualquer skill assim: no detalhe, em Quem chama, escolha Só você no terminal. Se o agente tentar rodar uma skill com essa opção, o Faundr barra.

O detalhe de uma skill

Clique numa skill para abrir o canvas dela, com o painel ao lado:

• O que faz (da própria skill): a descrição que veio do arquivo da skill.
• Quando usar e o gatilho (quem chama, quando entra, assuntos e arquivos). Mude e clique em Salvar.
• Conectada ao painel: o tipo da skill (veja abaixo).
• Lembrar a IA desta skill: desligado, a skill some do lembrete pelo assunto, mas continua na paleta do canvas. Skill desligada aparece apagada na lista.

Só quem edita o projeto muda o detalhe.

Na paleta do canvas

Todas as skills ligadas ao projeto aparecem na paleta do canvas dos workflows, separadas em Do projeto, Pessoais, Do Faundr e De outros plugins, com busca pelo nome. Arraste uma para o canvas e ela vira uma peça do workflow.

Skills que acham problemas

O agente também marca, em /faundr:skills, as skills cujo trabalho é achar problemas: de segurança, de testes, de qualidade do código ou erros do app. Elas ganham a etiqueta Conectada · Segurança (ou Qualidade, Testes, Erros) e passam a mandar o resultado para o painel:

• Quando uma delas roda (o agente chama ou você digita /nome), no fim da resposta o Faundr pede ao agente para registrar o que ela achou e o que foi corrigido na conversa.
• Cada problema entra na seção certa, como se o Faundr tivesse achado: Segurança (S-n), Qualidade (Q-n), Testes (T-n, falta de teste) ou Erros (E-n), com a etiqueta via /nome. Conta no Lançamento e no Insights como os outros.
• Cada skill só fecha os próprios achados: se ela rodar de novo e não achar mais um problema, ele fecha; os achados do Faundr e de outras skills ficam como estão. Rodando só em alguns arquivos, só os desses arquivos fecham. Se ela não achar nada, os achados abertos dela fecham.
• O tipo dá para trocar no detalhe da skill, em Conectada ao painel: Não: ela não procura problemas ou Sim: o que ela achar vai para a seção escolhida. A skill que o agente ainda não olhou aparece como Ainda não classificada.
• As skills do próprio Faundr não entram: elas já registram sozinhas.

Quem cria e quem aprova

• Você cria pelo painel: Novo workflow abre os modelos prontos (Estudar outro projeto, Tela nova, Corrigir bug, Antes de publicar, Revisão de segurança) ou um em branco.
• O agente propõe: quando percebe um jeito de trabalhar que se repete, ou quando você pede com /faundr:workflow, ele salva um rascunho. O card aparece com a borda destacada e "Proposto pela IA: revise e aprove".

Só vale o que estiver Ativo. Rascunho e desligado não chegam ao agente. Aprovar, editar, desligar e excluir ficam sempre com o time, no painel. O agente nunca muda um workflow sozinho.

Workflows não rodam sozinhos: eles guiam o agente na sessão que você abriu.

Acompanhar ao vivo

Quando o agente segue um workflow, ele marca cada passo, e o canvas acende na hora:

Parte dos passos se marca sozinha, pelo que o Faundr vê a sessão fazer, sem o agente precisar avisar: chamar a skill de um passo deixa ele Fazendo, um comando que termina bem conclui a Ação (ou a Espera) com aquele comando, e abrir agentes põe a peça de Agentes em andamento. O que vem antes desse passo pelas ligações fica como feito; os ramos ao lado, num "em paralelo", não mudam. Esses aparecem com · visto.

Uma execução aberta sem nenhum sinal há 15 minutos aparece como Sem notícias. Fechar o agente encerra sozinho as execuções que aquela sessão deixou abertas.

Na lista, o card do workflow mostra Em andamento ou Esperando você enquanto houver uma execução aberta. Dentro dele, a lista Execuções guarda as últimas 20, com quem seguiu, o pedido, o progresso (3/6) e o computador. Clique numa para ver no canvas onde ela parou. Parar esta execução encerra uma que ficou aberta.

Duas pessoas no mesmo workflow

Cada pessoa que segue um workflow tem a sua execução, e o progresso de uma nunca marca a da outra.

• Quem está em qual passo. Com duas execuções abertas, o topo do canvas mostra Agora: com cada pessoa e o passo dela. Clique numa para ver o canvas dela. O card da lista mostra quantas pessoas estão seguindo.
• Esperando você só aparece para quem é dono da execução. Para o resto do time aparece Esperando e o nome da pessoa.
• Começar um workflow que outra pessoa já segue não é barrado: o agente é avisado de quem está seguindo e em que passo, e fala com você antes de passos que não podem rodar duas vezes ao mesmo tempo (publicar, mexer no banco).
• Editar ao mesmo tempo. Se alguém salvar o workflow enquanto você edita, aparece um aviso no topo do canvas e o Salvar não grava, para não apagar a mudança da outra pessoa. Use Descartar as minhas e ver a nova e refaça a sua mudança por cima.
• Mudar um workflow que alguém está seguindo. A execução continua contando pelos passos da versão em que começou (o canvas mostra "segue a versão N"). O agente dessa pessoa é avisado no próximo pedido, e da próxima vez segue a versão nova.
• Parar a execução de outra pessoa pelo painel avisa o agente dela no próximo pedido, e a lista mostra quem parou.