Conceitos e vocabulário

As palavras que aparecem no painel e nos comandos, explicadas uma por uma.

Organização, projeto e sessão

Organização

O grupo de pessoas e projetos. Todo projeto pertence a uma organização, e quem é membro dela vê todos os projetos dela. Veja Organização, time e conta.

Projeto

Um produto que você está construindo: um app, um site, uma API. No painel, cada projeto tem as suas seções (Visão, Funcionalidades, Segurança…).

Pasta ligada

A pasta do código no seu computador que foi conectada a um projeto com /faundr:link. Ela tem um arquivo .faundr.json. O Faundr só age em pastas ligadas.

Sessão

Uma conversa com o agente numa pasta ligada, do momento em que você abre até fechar. Cada sessão aparece em Atividade → Diário de sessões, com os pedidos, os arquivos alterados, os commits e as tarefas concluídas. Os pedidos e as respostas ficam só com quem fez a sessão; o time vê o resumo.

Plugin

A parte do Faundr instalada dentro do agente de IA (Claude Code ou Codex). Observa as sessões, entrega o contexto, roda as checagens e traz os comandos /faundr:… (no Codex, $faundr:…).

Língua do conteúdo

A língua em que o agente escreve tudo o que grava no Faundr para aquele projeto (Visão, Stack, funcionalidades, decisões, achados, bilhetes), seja qual for a língua em que cada pessoa conversa com ele. Fica em Configurações → Geral. Quem lê o painel em outra língua pode usar o botão Traduzir, que usa o tradutor do próprio Chrome, no seu computador, sem gastar tokens.

O trabalho

Funcionalidade

Algo que o produto vai fazer, como "Tela de login" ou "Pagamento com Pix". Tem um checklist de tarefas, um critério de pronto e as decisões ligadas a ela.

Funcionalidade atual

A funcionalidade em que você está trabalhando naquela pasta. Tarefas novas entram nela, e o agente a recebe no início de cada sessão. Para trocar: faundr focus "<nome>".

Dono da funcionalidade

Quem criou ou começou a funcionalidade. As tarefas dela seguem o dono: se o agente de outra pessoa tenta mexer, recebe um aviso e só grava se a pessoa insistir, depois de combinar. Para trocar: faundr own e faundr disown.

Parada

Uma funcionalidade em andamento que ninguém mexe há mais de 14 dias. O /faundr:tidy-board confere as paradas contra os commits e o código e propõe concluir, descartar ou manter.

Descartada

Uma funcionalidade que não vai mais ser feita. Sai das abas (fica em Todas) e do contexto do agente, e volta com Restaurar.

Etapa

Uma fase de um trabalho grande. Cada etapa é uma funcionalidade que "vem depois" de outra. Enquanto nada começou nela, a etapa aparece como Planejada, em Próximas etapas.

Tarefa

Um passo do checklist de uma funcionalidade. Pode estar a fazer, em andamento ou concluída.

Sem commit

Uma tarefa marcada como concluída enquanto havia mudanças que não foram para o git. A marca some sozinha no próximo git commit. Serve para lembrar que o trabalho ainda não está salvo no histórico.

Critério de pronto

A lista do que precisa ser verdade para a funcionalidade estar pronta, como "a pessoa paga com Pix e recebe o e-mail". Quando o checklist termina, o agente confere cada item e marca como atendido ou não.

Planejamento

O que o agente faz antes de construir algo novo (/faundr:planning): poucas perguntas sobre o que só você decide, um "pronto quando" que dá para conferir e um resumo para você aprovar. As suas escolhas viram decisões.

A memória

Regra

Algo que o agente deve seguir sempre, como "toda rota do servidor confere o acesso ao projeto". Vai para ele no início de cada sessão e para os subagentes.

Decisão

Uma escolha técnica já feita, com o porquê, como "pagamentos pelo Stripe porque aceita Pix". Chega ao agente quando importa: no início da sessão (as mais novas e as da funcionalidade atual), quando o pedido fala do mesmo assunto ou antes de editar os arquivos ligados a ela. Assim ele não propõe de novo o que o time já decidiu.

Regra ou decisão ligada a arquivos

Uma regra ou decisão que vale só para alguns arquivos ou pastas. Em vez de ir no início de toda sessão, ela chega ao agente logo antes de ele editar um daqueles arquivos.

Padrão proibido

Um trecho de texto que uma regra diz que o código não pode ter (por exemplo, console.log). O Faundr avisa o agente a cada edição que traga esse texto, e a checagem de qualidade aponta onde ele já existe.

Proposta

Uma regra ou decisão que ainda não foi confirmada. Ela não vai para o agente até alguém clicar em Confirmar.

Obsoleta

Uma regra ou decisão que não vale mais. Fica guardada, mas não vai para o agente.

Preocupação

Algo para revisar depois, que não é regra nem tarefa: "o login pode ficar lento com muitos usuários". Recebe um número P-n e fica em destaque até alguém resolver.

Nota ao agente

Um recado escrito no painel (Atividade → Agora, tipo Aviso para os agentes) que chega ao agente junto com o próximo pedido de quem estiver numa sessão. Exemplo: "não mexa no módulo de pagamento".

Skills e workflows

Skill

Um roteiro que o agente segue para um tipo de tarefa. Os comandos /faundr:… são as skills do Faundr. O projeto, cada pessoa e outros plugins podem ter as suas.

Skill ligada ao projeto

Uma skill que você já usa e que o /faundr:skills leu: o Faundr guarda o nome, a descrição, a origem, quando usar e os assuntos, e lembra o agente dela quando o pedido fala de um desses assuntos. Aparece em Workflows → Skills. Veja Workflows.

Skill conectada

Uma skill ligada ao projeto cujo trabalho é achar problemas: de segurança, de testes, de qualidade do código ou erros. Ela ganha a etiqueta Conectada. Quando ela roda, o agente manda ao Faundr, no fim da resposta, o que ela achou e corrigiu: os problemas viram S-n, Q-n, T-n ou E-n com a marca via /nome. Cada skill só fecha os próprios achados.

Workflow

O roteiro que o time quer que o agente siga num tipo de pedido ("sempre que for design, faça isto e aquilo"). Nasce como rascunho e só vale depois que alguém aprova no painel, em Workflows. Recebe um número W-n.

Continuidade

Bilhete de passagem

De 1 a 3 frases sobre o que ficou pela metade, qual é o próximo passo e os cuidados para quem continuar. O agente escreve no fim das sessões longas. Aparece em Atividade → Onde parei, no card do projeto e no início da próxima sessão.

Pacote de passagem

Um documento completo para um dev assumir o projeto: o que é, onde parou, onde roda, como rodar, regras, decisões, riscos e o mapa do código. Fica em Atividade → Relatórios.

Ponto de volta

Uma foto dos arquivos do projeto, guardada no git, para você voltar a ela se algo der errado. O Faundr salva sozinho antes das mudanças. Não inclui o .env, o node_modules nem o banco de dados. Veja Proteção contra desastres.

O que o Faundr encontra

Tudo o que o Faundr encontra vira um achado com uma letra e um número. O número nunca muda, então você pode citar o achado em qualquer lugar: "corrige o S-3".

Achados que vêm de uma skill conectada levam a marca via /nome da skill.

Os achados têm uma situação:

• Aberto: precisa de atenção.
• Corrigido ou resolvido: o problema sumiu. Na maioria dos casos, o Faundr só fecha depois de refazer a checagem e confirmar que o problema não aparece mais.
• Ignorado: alguém decidiu que não é problema, ou que fica para depois, com um motivo. Alguns voltam sozinhos depois de um prazo.
• Arquivado: não vale para este projeto. Não volta.
• Voltou: foi corrigido e apareceu de novo.

Gravidade

O quanto o achado importa: crítica, alta, média ou baixa. No painel, a gravidade aparece pela intensidade da etiqueta: quanto mais grave, mais clara.

Suprimido

Um achado de segurança que o Faundr considerou ruído, como uma chave de exemplo num arquivo de teste. Fica escondido, mas dá para ver com Mostrar suprimidos.

Como o Faundr checa

Checagem sem IA

A análise automática que roda no seu computador, com regras fixas, sem usar o agente e sem gastar tokens. Roda sozinha no início das sessões e depois das respostas que mudaram arquivos.

Revisão com IA

A análise feita pelo próprio agente, quando você pede (/faundr:security, /faundr:quality, /faundr:design). Lê a lógica do código e acha o que regras fixas não enxergam. Gasta tokens do seu plano de IA.

Mapa do código (ou grafo)

Um índice do projeto montado pelo Faundr: os arquivos, as funções e quem usa quem. Ajuda o agente a achar as coisas lendo menos, e ajuda você a ver como o projeto se organiza. Veja Mapa do código.

design.md

O guia de design do projeto: cores, fontes, componentes e o que evitar. O Faundr confere as telas contra ele.

Visão

O resumo do projeto escrito pelo agente: o que é, para quem, como funciona, as partes e onde vocês estão.

Stack

Onde cada parte do projeto roda e com o quê: hospedagem, banco, login, linguagens, serviços externos e variáveis.

Tokens

A unidade com que a IA mede (e cobra) o texto que lê e escreve. O Insights mostra quantos foram gastos e quanto disso foi do Faundr.