Um dia de trabalho com o Faundr

Esta página acompanha uma sessão típica, do momento em que você abre o agente de IA até o fim do dia, e mostra o que o Faundr faz em cada momento. Você não precisa decorar nada: a maior parte acontece sozinha.

Ao abrir o agente

Assim que a sessão começa, o Faundr entrega ao agente um resumo do projeto, antes mesmo de você escrever algo:

• onde parou a última sessão: os pedidos, os commits, as tarefas concluídas e o bilhete de passagem;
• as regras do time, que o agente deve seguir sempre;
• as decisões já tomadas, para ele não propor de novo o que já foi decidido;
• a funcionalidade em andamento e o que falta nela;
• as preocupações abertas e o que há de novo em segurança, erros, qualidade e testes;
• notas do time, se alguém escreveu uma no painel;
• os workflows ativos do time, com quando usar cada um.

Na primeira pergunta da sessão, o Faundr também roda, em segundo plano, as checagens sem IA: segurança, qualidade, design, Stack, variáveis e o inventário dos testes. Também relê as suas skills, para uma skill nova aparecer no painel sem você fazer nada. Nada disso atrasa a resposta do agente.

Ao começar algo novo

Para uma funcionalidade nova, peça normalmente: o agente planeja com você antes (/faundr:planning). Para criar já como a atual da pasta, use /faundr:feature:

/faundr:feature Tela de login — entrar com e-mail e senha

Antes de começar, o agente mede o tamanho do pedido e olha o projeto, para só perguntar o que o código não responde. Depois faz poucas perguntas sobre o que você vê e faz na tela (nunca sobre tecnologia), cada uma com opções e uma recomendação, e mostra um resumo para você aprovar. As suas escolhas viram decisões, e o "pronto quando" vira o critério de pronto da funcionalidade. Depois ele divide o trabalho em tarefas, e tudo aparece em Funcionalidades.

Você também pode simplesmente pedir o que quer. Quando o agente começa algo de vários passos, ele registra a funcionalidade e as tarefas sozinho. Um plano aprovado no modo de planejamento do agente também vira funcionalidade com checklist.

Se o trabalho é grande e vai em fases, o agente registra as próximas etapas desde o começo. Elas aparecem em Funcionalidades → Próximas etapas, e o Faundr lembra delas quando a etapa atual termina.

Se o pedido bate com um workflow ativo do time, o agente recebe os passos e segue um por um, e o time acompanha no canvas, ao vivo. Se o pedido fala do assunto de uma das suas skills, o agente é lembrado de usá-la. Veja Workflows.

Enquanto o agente trabalha

Cada mudança passa por algumas proteções, sem você precisar pedir:

• Antes da primeira mudança da sessão, o Faundr salva um ponto de volta dos arquivos. Ele salva de novo a cada 30 minutos de edições.
• Antes de editar um arquivo, o agente recebe as regras e decisões ligadas àquele arquivo e a lista de quem depende dele, para não quebrar outra parte sem perceber.
• Se ele tentar gravar uma chave secreta no código (Stripe, Supabase, AWS, OpenAI…), a edição é barrada e ele é orientado a usar o .env.
• Se ele tentar um comando perigoso (apagar pastas, git reset --hard, DROP TABLE, mexer no banco de produção), o agente para e pede a sua confirmação. O que não tem volta nenhuma é barrado direto.
• Se ele tentar instalar um pacote que não existe ou que é suspeito de tão novo, o Faundr barra ou pergunta.
• Se um comando falha, o erro vira um item em Erros. Quando o mesmo comando volta a passar, o erro fecha sozinho.
• Se ele entrar em círculo (o mesmo erro 3 vezes, ou o mesmo arquivo mudado muitas vezes sem resolver), o Faundr pede que ele pare, explique o que está acontecendo e considere voltar a um ponto anterior.

Os detalhes estão em Proteção contra desastres.

No fim de cada resposta

Quando o agente termina uma resposta em que mexeu em arquivos, o Faundr confere o que ficou pendente. Se faltar algo, ele pede ao agente, antes de encerrar:

1. Provar que funciona: rodar o build, os testes ou a checagem de tipos e contar o resultado.
2. Deixar o bilhete de passagem, em sessões longas: de 1 a 3 frases sobre o que ficou pela metade e o que vem depois.
3. Revisar as telas que mudou, se o projeto tem um design.md.
4. Conferir o critério de pronto, quando o checklist da funcionalidade termina.
5. Anunciar a próxima etapa e perguntar se segue.
6. Atualizar a Stack ou a Visão, se ficaram desatualizadas.
7. Registrar o trabalho, se a sessão mudou vários arquivos e nada foi registrado no Faundr.
8. Mandar ao painel o resultado de uma skill conectada que rodou na resposta (uma skill sua que acha problemas de segurança, testes, qualidade ou erros). O que ela achou aparece na seção certa com "via /nome".

A auditoria rápida de design e as atualizações da Stack e da Visão dá para deixar só para quando você pedir, com o modo econômico (o /faundr:setup oferece). A prova, o bilhete e a segurança continuam sempre.

Por isso, às vezes a resposta do agente continua depois de parecer pronta, com uma frase do tipo "rodei o build e passou". É o Faundr fazendo o trabalho dele.

Em segundo plano, o Faundr também refaz o mapa do código, checa de novo a segurança, a qualidade e o design dos arquivos alterados, e soma os tokens gastos.

Quando algo dá errado

No fim do dia

• Antes de fechar, rode /faundr:handoff se quiser deixar o bilhete com as suas palavras. Em sessões longas, o agente já é lembrado de escrever um.
• Faça o commit do que ficou pronto. Tarefas marcadas como feitas com mudanças fora de commit aparecem como sem commit no painel até o próximo commit.
• Abra o painel para ver o dia: Atividade → Onde parei mostra a última sessão e o que ficou para fazer.

No dia seguinte, a próxima sessão já começa sabendo de tudo isso.

Toda semana

• Atividade → Relatórios traz os últimos 7 dias em linguagem simples: o que avançou, o que ficou pronto, os problemas e o custo. Dá para mandar sozinho, toda segunda de manhã, para o Slack ou o Discord.
• Insights → Custo mostra quanto as sessões custaram, por funcionalidade e por janela de 5 horas.
• Antes de abrir o app ao público, rode /faundr:launch e veja Lançamento e LGPD.