Referência
Comandos do agente
Os comandos /faundr:… são digitados no seu agente de IA, na pasta ligada ao projeto. No Codex, troque a / por $: $faundr:resume. Cada um dá ao agente um roteiro para uma tarefa: revisar a segurança, corrigir um erro, escrever testes, voltar a um ponto anterior.
Como usar
- Digite
/faundr:no agente (no Codex,$faundr) para ver a lista e escolher. - O que vem depois do comando é o pedido, em linguagem normal:
/faundr:undo antes de mexer no login. - Muitos comandos o agente também usa sozinho, quando a situação pede: quando você pergunta "onde paramos?", ele usa o
/faundr:resume. Nas tabelas abaixo, a coluna Sozinho? diz quais. - Os comandos que só você chama são os que mudam algo importante ou que você precisa decidir quando rodar.
Toda seção do painel tem a aba Comandos, com os comandos daquela parte e um exemplo pronto para copiar. Esta página junta todos.
Conexão
| Comando | Sozinho? | O que faz |
|---|---|---|
/faundr:login | não | Conecta o agente à sua conta pelo navegador: confira o código e clique em Autorizar. Os tokens ficam em Minha conta → Token do plugin, onde dá para apagar. |
/faundr:setup [--refresh] | sim | Configura o Faundr de uma vez no projeto: faz o seguro (pasta ligada, mapa, checagens, linha de status, skills) e pergunta o resto (.gitignore, AGENTS.md, token do Supabase, erros do app). Rodar de novo não muda o que já está certo. |
/faundr:link [nome ou id] | não | Liga a pasta atual a um projeto. Sem nada, lista os projetos e pergunta qual. |
/faundr:status | não | Diz se está tudo conectado e o que falta configurar. |
/faundr:statusline [--force] | não | Liga a barra de status do Faundr no rodapé do agente, no terminal. Só no Claude Code. |
/faundr:mod [o que o mod faz] | sim | Cria ou ajusta um mod do agente (painel, faixa acima do prompt, aviso, comando) seguindo as melhores práticas; valida e testa antes de entregar. Só no Claude Code. Veja Mods. |
/faundr:agents-md [--file CLAUDE.md] [--off] | não | Copia as regras e decisões para o AGENTS.md, para agentes que não rodam o plugin (como o Cursor) seguirem a memória do time. |
Trabalho e memória
| Comando | Sozinho? | O que faz |
|---|---|---|
/faundr:track | sim | O roteiro que o agente segue para registrar sozinho o que está construindo: funcionalidade, tarefas, decisões e próximas etapas. Você não precisa chamar. |
/faundr:planning [o que quer construir] | sim | Planeja antes de construir: mede o tamanho, olha o projeto, faz poucas perguntas com recomendação e mostra um resumo (com o que o agente decidiu sozinho) para você aprovar. Com o OK, grava a funcionalidade, as decisões e o critério de pronto. |
/faundr:feature <título> [— descrição] | não | Começa uma funcionalidade, planejando antes como o /faundr:planning, e a torna a atual desta pasta. |
/faundr:inventory | sim | Num projeto que já existia: lista o que o app já faz, a partir do mapa do código, e registra como funcionalidades concluídas, com o seu OK. |
/faundr:task <descrição> | não | Acrescenta uma tarefa à funcionalidade atual. |
/faundr:done <trecho ou nº> | não | Marca uma tarefa como concluída e mostra o que falta. |
/faundr:board | não | Mostra as funcionalidades e o checklist de cada uma, e resume o que está em andamento e o próximo passo. |
/faundr:tidy-board | sim | Arruma o quadro de Funcionalidades: confere cada funcionalidade em andamento e cada próxima etapa contra os commits e o código, e propõe marcar como feito o que já foi feito (com a prova), descartar o que não vai mais ser feito e manter o resto. Só muda o que você aprovar. |
/faundr:decision <decisão> [porque …] | não | Registra uma decisão técnica. A partir da próxima sessão, o agente não a contradiz. |
/faundr:rule <regra> [porque …] [em <arquivos>] | não | Registra uma regra do time. Com arquivos, a regra chega só antes de editar aqueles arquivos. Se dá para conferir pelo texto do código, o Faundr passa a avisar antes de uma edição que a contrarie. |
/faundr:concern <o que preocupa> [— detalhes] | não | Registra uma preocupação (P-n) para revisar depois. Não começa a resolver agora. |
/faundr:resolve [P-n] | não | Marca uma preocupação como resolvida. Sem número, lista as abertas. |
/faundr:memory-check [regra ou área] | sim | Confere se o código ainda segue as regras e decisões, e anota cada contradição como preocupação. Não muda código. |
Continuidade
| Comando | Sozinho? | O que faz |
|---|---|---|
/faundr:resume | sim | "Onde paramos?": a sessão anterior, o que ficou pendente e os cuidados. Pergunta por onde começar, sem começar sozinho. |
/faundr:handoff [o que registrar] | não | Escreve o bilhete de passagem: o que ficou pela metade, o que falta e os cuidados. |
/faundr:undo [quando ou o quê] | sim | Volta os arquivos para um ponto de volta. Mostra o que muda e só volta com o seu OK. O estado de antes também fica salvo. |
/faundr:parallel [etapas] | sim | Constrói várias etapas planejadas ao mesmo tempo: pega as que já podem começar (a anterior está pronta), abre uma mesa de trabalho para cada uma, manda um ajudante construir cada etapa na sua mesa e depois junta tudo no projeto, uma de cada vez, com os testes. Só começa e só junta com o seu OK. |
/faundr:merge [o que foi feito] | sim | Junta o trabalho da sua mesa de trabalho ao projeto principal: pega a versão mais nova, junta, roda os testes, explica os conflitos e envia. Só junta com o seu OK. |
/faundr:inbox | sim | Busca os pedidos que o time escreveu no painel para você, os recados e as notas, e trata cada um. Pedido de outra pessoa só com o seu OK. Com /loop 5m /faundr:inbox, olha sozinho de tempos em tempos. |
Visão, Stack e mapa do código
| Comando | Sozinho? | O que faz |
|---|---|---|
/faundr:overview | sim | Escreve ou atualiza a Visão do projeto. |
/faundr:stack | sim | Escreve ou atualiza a Stack. Conte ao agente o que os arquivos não dizem. |
/faundr:map | não | Gera o mapa do código pela primeira vez, ou refaz agora. |
/faundr:map <pergunta> | não | Pergunta ao mapa ("como o login funciona?", "o que quebra se eu mudar X?", "como A chega em B?"). O agente responde citando arquivo e linha. Ele e os subagentes dele já consultam o mapa sozinhos pelo terminal. |
Design
| Comando | Sozinho? | O que faz |
|---|---|---|
/faundr:design [--files <arquivos>] | sim | Sem design.md, cria o guia, perguntando o que você quer. Com design.md, faz a auditoria completa das telas, medindo no navegador se o servidor estiver rodando. Com --files, faz só a revisão rápida dos arquivos indicados. |
/faundr:design-fix [D-n | --all] | não | Corrige problemas de design seguindo o design.md. Sem número, corrige na ordem do que mais importa, parando ao fim de cada etapa. Com --all, corrige todos sem parar. |
/faundr:design-report <o que você viu> | não | Registra um problema que você viu na tela. Vira um D-n. |
/faundr:design-showcase [componente] | sim | Desenha as réplicas dos componentes na Vitrine. Sem argumento, refaz só as desatualizadas e acrescenta as que faltam. |
Segurança, lançamento e LGPD
| Comando | Sozinho? | O que faz |
|---|---|---|
/faundr:security-scan | não | Roda a checagem sem IA agora e resume o que encontrou. |
/faundr:security [--files <arquivos> | S-n] | sim | Revisão de segurança com IA: quem pode acessar o quê. Cada problema passa por um verificador independente antes de entrar; o que depende de configuração fora do código vira "A conferir". Com S-n, reconfere um "A conferir". Não corrige sem pedido. |
/faundr:security-fix [S-n | pacote | --all] | não | Corrige um problema, ou todos os graves (com --all, todos, sem parar). Só fecha quando a checagem não o encontra mais. Para chave vazada, explica como trocá-la no provedor. |
/faundr:launch [--url <site>] | sim | "Pronto para lançar?": compila o código, roda os testes e a checagem de segurança, testa o banco como visitante, confere o site no ar e termina com Pode lançar: SIM ou NÃO, começando pelo que impede o lançamento. |
/faundr:privacy [política | termos | cookies | exclusão] | sim | Descobre quais leis de privacidade valem (LGPD, GDPR, CCPA/CPRA) pelo lugar onde estão os usuários do app, mostra os dados pessoais que ele coleta e o que essas leis ainda pedem, e escreve os textos com o seu OK. |
Qualidade do código
| Comando | Sozinho? | O que faz |
|---|---|---|
/faundr:quality-scan | não | Roda a checagem sem IA agora e resume por tipo. |
/faundr:quality [--full | --files <arquivos>] | sim | Revisão com IA do que mudou (ou do projeto todo). Só aponta, não muda nada. |
/faundr:quality-fix [Q-n | --all] | não | Corrige sem mudar o que o app faz (com --all, todos os abertos, sem parar). Pede OK antes de mexer em vários arquivos ou remover pacotes. |
Testes e erros
| Comando | Sozinho? | O que faz |
|---|---|---|
/faundr:tests [funcionalidade, arquivo ou T-n] | sim | Pergunta o que não pode quebrar, liga funcionalidades a testes e escreve os que faltam, vendo cada um falhar antes de confiar. Nunca instala nada sem OK. |
/faundr:tests-fix [teste ou arquivo | --all] | não | Conserta testes falhando ou instáveis, sem apagar, pular ou afrouxar o teste. Com --all, todos, sem parar. |
/faundr:error-fix [E-n | --all] | não | Corrige um erro e só dá como resolvido quando o mesmo comando volta a passar. Começa pela receita, se esse erro (ou um igual) já foi consertado antes no projeto, e guarda a receita no fim. Sem número, começa pelos que voltaram. Com --all, todos, sem parar. |
/faundr:errors-setup | não | Liga o app publicado ao Faundr, para os erros de quem usa o app chegarem ao painel. |
/faundr:browse <endereço> <objetivo> | sim | Navegador rápido: faz uma tarefa num site em segundos (clicar, preencher, buscar, abrir telas), sem prints e sem gastar tokens do seu plano a cada clique. Quem escolhe cada passo é o Jev, um serviço de fora, que precisa de uma chave (faundr browse-key). Serve para testar os fluxos do seu app (login, cadastro, navegação depois de um deploy). Senha nunca vai no comando: fica numa variável de ambiente. Para antes do botão final quando a tarefa paga, compra, envia, apaga ou publica. |
Skills e workflows
| Comando | Sozinho? | O que faz |
|---|---|---|
/faundr:skills [nome de uma skill] | sim | Conecta ao Faundr as skills que você já usa (as do repositório, as pessoais e as dos plugins ligados): o agente escreve quando usar cada uma e os assuntos. Elas aparecem em Workflows → Skills e na paleta do canvas, e o agente é lembrado de usá-las quando o pedido fala do assunto. Também marca as que acham problemas (segurança, testes, qualidade, erros) como Conectadas: o que elas acham passa a aparecer no painel. Veja Workflows. |
/faundr:workflow [o que o fluxo faz] | sim | Desenha um workflow do projeto: como o time quer que o agente trabalhe num tipo de pedido ("sempre que for design, faça isto e aquilo"). Grava como rascunho; só vale depois que você aprova no painel, em Workflows, onde dá para editar os passos no canvas. |