Atividade

Atividade mostra quem está trabalhando agora e o que aconteceu no projeto: onde o trabalho parou, cada sessão com o agente e os relatórios para passar o projeto adiante. Tudo é montado das sessões do agente, sem IA. A única parte escrita pelo agente é o bilhete de passagem.

São quatro abas:

A conversa é de quem fez a sessão

O que você pede ao agente, o que ele responde e os comandos que ele roda ficam só com você. Ninguém do time lê, nem pelo painel nem direto no banco.

O time vê o resumo das suas sessões: quando foi, quanto durou, a branch, quantos pedidos houve, os arquivos que mudaram, os commits, as tarefas concluídas e o bilhete de passagem. É o que basta para saber em que pé o projeto está sem ler a conversa de ninguém.

O mesmo vale para o agente: no começo da sessão, o seu agente recebe o resumo da última sessão do projeto. Se ela foi de outra pessoa, ele recebe os arquivos, os commits e o bilhete, mas não os pedidos dela.

Chaves e senhas que o agente leu ou digitou (por exemplo, ao abrir o .env) são trocadas por *** antes de sair do seu computador.

Agora

Quem está trabalhando no projeto neste momento. Cada pessoa do time ganha um card quando está com o projeto aberto no painel ou tem um agente aberto. Dentro do card aparece cada agente dela, com:

• O que está fazendo: pensando, editando um arquivo (com o nome dele), rodando um comando (com a descrição curta, nunca o comando inteiro), precisa de você (pediu permissão ou fez uma pergunta) ou esperando o próximo pedido.
• Qual skill está usando, quando o agente está num comando do Faundr (ex.: /faundr:design aparece como Design). Vale do momento em que você digita o comando, ou o agente chama a skill, até ele terminar a resposta.
• De onde: o agente (Claude Code ou Codex), o nome do computador e a branch.

Tudo se atualiza sozinho, na hora. Agente sem notícias há 15 minutos aparece como "Sem notícias" (o terminal pode ter sido fechado sem avisar); depois de 2 horas, some da aba. Para trocar o nome do computador que aparece, ponha "machine": "Notebook da Ana" em ~/.faundr/config.json.

Pedidos e avisos

Embaixo de quem está trabalhando ficam os pedidos. Há dois tipos:

• Pedido: uma tarefa para um agente fazer. Escreva o que precisa ser feito, escolha para quem (uma pessoa do time, você mesmo ou qualquer pessoa) e envie.
• Aviso para os agentes: só informa, não é tarefa. Exemplo: "não mexa no módulo de pagamento hoje". Chega no próximo agente aberto de qualquer pessoa do time, junto com o próximo pedido, e aparece como feito quando chegar.

Sobre os pedidos:

• O pedido chega no agente aberto da pessoa: no próximo pedido dela ou quando o agente terminar o que está fazendo. Se ninguém estiver com o agente aberto, chega quando a pessoa abrir.
• Pedido de outra pessoa só é feito com o OK de quem está no computador: o agente mostra quem pediu e o quê, e pergunta. Pedido seu para o seu agente ele faz em seguida.
• Cada pedido mostra o estado: esperando, entregue ao agente (em qual computador) ou feito, com uma linha do que foi feito. Pedido que ainda não foi entregue pode ser cancelado.
• Recados entre sessões também aparecem aqui: o agente de uma pessoa pode mandar um recado para outra (faundr msg).
• Para buscar os pedidos na hora, peça ao agente /faundr:inbox. Para ele olhar sozinho de tempos em tempos: /loop 5m /faundr:inbox.
• Os filtros Abertos, Feitos e Todos e a busca ajudam a achar um pedido ou uma pessoa.

Trabalhar em time

Quando mais de uma pessoa trabalha no projeto ao mesmo tempo, o Faundr cuida para um não quebrar o trabalho do outro. Ele avisa, nunca trava:

• Sozinho no projeto: nada muda.
• Alguém já está trabalhando quando você chega: no começo da sessão, o agente conta quem está no projeto e pergunta se pode abrir uma mesa de trabalho separada para você, explicando o que pode atrapalhar. Nada é feito sem o seu sim, e o que você ainda não salvou vai junto para a mesa.
• Quem já estava trabalhando fica sabendo no próximo pedido: "a Ana entrou no projeto e está mexendo em X".
• Antes de mexer num arquivo que outra pessoa mexeu na última hora, o agente recebe o aviso de quem foi e o que ela está fazendo.
• Juntar o trabalho: no fim da tarefa, o agente pergunta se pode juntar ao projeto principal. Com o sim, ele pega a versão mais nova, junta, roda os testes, resolve os conflitos explicando em português simples (ou pergunta, quando não tiver certeza) e envia (/faundr:merge). Enquanto outra pessoa estiver ativa, mandar direto para o projeto principal pede a sua confirmação.
• Tarefa com dono: faundr claim "<tarefa>" deixa a tarefa com o seu nome no painel. Se outra pessoa tentar pegar, o agente dela recebe o aviso e pergunta antes. faundr release deixa livre de novo.
• Funcionalidade com dono: quem cria ou começa uma funcionalidade vira o dono. Se o agente de outra pessoa for mexer nela, ele avisa de quem é e só segue com o sim (veja Funcionalidades).
• Dois agentes seus na mesma pasta: o segundo pergunta se pode criar uma cópia separada da pasta, para um não desfazer o trabalho do outro.

Para juntar o trabalho de duas pessoas, o projeto precisa estar no GitHub; se não estiver, o agente oferece ajuda para configurar. Para ver quem está no projeto pelo terminal: faundr team.

Onde parei

Mostra:

• Última sessão: data, duração, branch, o bilhete de passagem e o resumo da sessão: o que foi pedido, quantos arquivos mudaram, os commits, as tarefas concluídas, o que foi registrado e como terminou.
• O que ficou para fazer: as tarefas abertas por funcionalidade e as preocupações em aberto.

Se alguém do time está com o agente aberto agora, aparece a etiqueta "sessão em andamento agora".

É a mesma informação que o agente recebe no início da próxima sessão, e a que o /faundr:resume resume.

Diário de sessões

Uma linha por conversa com o agente, das mais recentes para as mais antigas, 10 por página. Cada sessão mostra:

• data, início, fim (ou "agora", se ainda está aberta) e duração;
• branch e agente (Claude Code ou Codex);
• o bilhete de passagem;
• o resumo: pedidos, arquivos, commits, tarefas;
• Eventos brutos: tudo o que o plugin registrou, para quem quer o detalhe.

Nas sessões de outra pessoa, os pedidos aparecem só como número ("Pediu (5)") e os eventos brutos não trazem a conversa nem os comandos, só os arquivos e os commits.

Sessões sem nenhum pedido (abertas e fechadas sem uso) ficam escondidas. Use o link para mostrá-las.

Relatórios

Resumo da semana

Os últimos 7 dias em linguagem simples, para quem não programa: o que avançou, o que ficou pronto, os problemas e o custo. Use para atualizar sócios e investidores.

• Copiar o resumo e Montar de novo.
• Envio automático: toda segunda de manhã, o resumo vai para o Slack ou o Discord. O envio usa os mesmos endereços (webhooks) configurados em Erros → App publicado. Ligue ou desligue com o botão Ligar o envio semanal.

Passagem para um dev

Um documento só, montado pelo Faundr, com o que um dev precisa para assumir o projeto: o que é, onde parou, onde roda, como rodar, regras, decisões, riscos abertos e o mapa do código.

Use quando for contratar alguém, pedir ajuda numa comunidade ou trocar de agente. Os botões:

• Baixar (.md): salva o documento num arquivo.
• Copiar o documento: para colar num e-mail, num chat ou noutra IA.
• Montar de novo: refaz com o estado atual do projeto.

Pelo terminal: !faundr handover --out PASSAGEM.md.

O bilhete de passagem

O bilhete tem de 1 a 3 frases: o que ficou pela metade, qual é a próxima etapa e qualquer cuidado para quem continuar. Exemplo:

O Faundr pede o bilhete ao agente no fim das sessões longas (4 ou mais arquivos editados, ou uns 20 minutos de edições), e de novo a cada 30 minutos. Para escrever quando quiser, use /faundr:handoff, com ou sem o que você quer registrar.

O bilhete aparece em Onde parei, no card do projeto na página inicial e no início da próxima sessão do agente.

Comandos