O painel do projeto
Configurações
Tudo o que dá para ligar e desligar no projeto fica em Configurações, no fim do menu do projeto. São quatro abas: Geral, Automações, Barra de status e Design. Cada interruptor é o mesmo da tela de origem: mudar aqui muda lá. Só quem edita o projeto muda as configurações; quem tem o papel Leitura só vê.
Geral
- Língua do conteúdo: tudo o que o Faundr registra neste projeto (Visão, Stack, funcionalidades, decisões, achados, bilhetes de passagem) é escrito nesta língua, seja qual for a língua em que cada pessoa conversa. Enquanto ninguém escolhe, aparece Ainda não definida e ela fica definida na próxima sessão do agente, pela língua de quem estiver trabalhando. Ao trocar, o painel pergunta antes ("Escrever em English daqui para frente?"): só o conteúdo novo segue a língua nova, e o aviso lembra que refazer o que já existe (Visão, Stack, Arquitetura, guia de design, Vitrine) gasta tokens do seu plano de IA, com o comando de cada um e quanto ele gastou da última vez. Quem lê o painel em outra língua pode usar o Traduzir no topo da página. Veja Visão e Stack.
- Modo econômico: a auditoria rápida de design e a atualização da Visão e da Stack deixam de rodar sozinhas no fim das respostas e ficam só para quando você pedir. O cartão mostra quanto o fim das respostas custou nos últimos 30 dias (a porcentagem do que as sessões gastaram, quantas vezes e quantos tokens cada uma). Prova, bilhete de passagem e segurança continuam sempre. É o mesmo que
faundr setup --economy allno terminal, e os passos que ele desliga aparecem em Automações com "Faz parte do modo econômico". - Comportamento do agente:
- Lembrete para não escrever código demais (o mesmo de Qualidade): no início de cada sessão, 6 linhas para o agente reaproveitar o que já existe, não criar abstração antes da hora e nunca cortar validação, tratamento de erro importante, segurança ou testes. Custa um pouco de contexto. Só liga depois de a checagem de qualidade rodar uma vez (
/faundr:quality-scan). - Encaixar pastas novas na arquitetura sozinho (o mesmo de Arquitetura → Fora do plano): ligado, o agente põe a pasta nova na parte mais provável e avisa onde pôs; desligado, ele sugere e espera o seu OK.
- Conectar ao agente de IA: o comando
/faundr:linkcom o identificador deste projeto, pronto para copiar. Rode uma vez no agente aberto na pasta do código: depois disso, cada sessão aberta nessa pasta aparece em Atividade, na hora.
Automações
O que o Faundr faz sozinho em cada momento (início da sessão, cada pedido, fim da resposta e dentro das skills do Faundr), com um interruptor por passo. Desligado, o passo para de rodar para todo o time a partir do próximo pedido (os do início da sessão, na próxima sessão). São os mesmos interruptores do desenho de cada um em Workflows → Do Faundr. Ficam sempre ligados: as checagens de segurança e as perguntas ao dono antes de mudar algo importante.
Barra de status
A barra de status é a linha que o Faundr mostra embaixo do agente, no terminal. Ela diz o que está sendo construído e, se você quiser, quanto do contexto da conversa e dos limites do seu plano já foi usado. Ela existe só no Claude Code: o Codex não deixa um plugin mudar a tela dele.
> _ Faundr · Lojinha · Frete grátis 2/5 · agora: Testes do frete · ctx ███░░ 42% · 5h ████░ 84% zera 18:40 · sem ████░ 61%
Para ligar neste computador: !faundr statusline-install (se você já usa outra barra, ela só é trocada com --force).
O que pode aparecer
| Item | O que mostra |
|---|---|
| Projeto | O nome do projeto ligado à pasta. |
| Funcionalidade atual | O que está sendo construído e quantos passos já foram (2/5). |
| Passo atual | O passo em andamento ou o próximo. |
| Mapa do código | Se o mapa está em dia ou atualizando. |
| Preocupações | Quantas estão abertas. |
Contexto (ctx) | Quanto da memória da conversa já foi usado. Perto do fim, a IA resume a conversa e esquece detalhes: é a hora de /compact ou de uma sessão nova. |
Janela de 5 horas (5h) | Quanto do limite de uso das 5 horas já foi e quando ele zera, nos planos Pro e Max. |
Semana (sem) | Quanto do limite semanal já foi e quando ele zera, nos planos Pro e Max. |
| Custo da sessão | Quanto a sessão custaria pela API. Desligado por padrão: em plano Pro ou Max não é o que você paga. |
| Faixa acima do prompt | As barras de contexto e de limites também numa faixa logo acima de onde você digita. Desligado por padrão e precisa do mod do Faundr (veja abaixo). |
Cada barra tem 5 blocos, e cada bloco vale 20%. Contexto e limites só aparecem depois da primeira resposta da sessão.
Escolher o que aparece
Em Configurações → Barra de status, cada item tem um interruptor e a prévia Como fica mostra a linha. Clique em Salvar para gravar, ou em Desfazer para voltar ao que estava. A escolha vale para todo mundo do projeto, a partir da próxima mensagem de cada pessoa, sem reiniciar. O que não couber na largura do terminal desce para uma segunda linha.
Avisos
Com Avisar quando estiver alto ligado:
- em 80%, o item fica em negrito e ganha a dica: "hora de /compact" no contexto, o horário em que a janela zera nos limites;
- em 95%, o item fica em destaque (fundo invertido): "use /compact já", ou que o limite está no fim.
A barra se atualiza sozinha depois de cada resposta do agente, sem gastar tokens nem rede.
O mod do Faundr (opcional)
O faundr-mod é um complemento do próprio Claude Code. Ele mostra um aviso rápido no terminal quando o contexto ou um limite passa de 80% e de 95% (uma vez cada) e desenha a Faixa acima do prompt, quando ela está ligada. Para instalar, no agente: /plugin install faundr-mod@faundr. Veja Mods.
Design
O escopo do design (se precisa funcionar no celular, o tipo de produto, o tema e o movimento), as exceções decididas e as regras desligadas, com o botão Religar. É o mesmo da seção Design.
A barra do terminal é a linha que o Faundr mostra embaixo do agente no terminal: o que está sendo construído e, se você ligar, o contexto da conversa e os limites de uso do plano. O que aparece se escolhe na aba Barra de status. Use estes comandos no seu agente de IA, na pasta ligada ao projeto.
A barra se atualiza sozinha depois de cada resposta da IA, sem gastar tokens nem rede: lê o que o agente já sabe e o resumo que o Faundr guarda na pasta.
/faundr:setup [--refresh]Configura o Faundr no projeto de uma vez: confere Node, git e login, liga a pasta, gera de graça (sem IA) o mapa do código, a Stack e as primeiras checagens, liga a barra e as skills e mostra quanto custa cada item com IA para você escolher. --refresh refaz o mapa e as checagens.
ex.: /faundr:setup --refresh
/faundr:statusline [--force]Pede à IA para ligar a barra do Faundr (o mesmo que o comando abaixo).
!faundr config lang [en|pt|auto]Escolhe a língua do que o plugin mostra para você (setup, barra de status, achados). Sem valor, mostra a atual; auto segue a língua do computador.
ex.: !faundr config lang pt
!faundr statusline-install [--force]Liga a barra do Faundr no agente deste computador. Se já existe outra barra, só troca com --force.
/faundr:mod [o que o mod faz]Cria ou ajusta um mod do agente de programação (painel, faixa acima do prompt, aviso, comando, regra que barra uma ferramenta) seguindo as melhores práticas: pergunta o essencial, valida, checa os tipos e testa antes de entregar.
ex.: /faundr:mod um aviso quando eu ficar mais de 30 minutos sem rodar os testes
/plugin install faundr-mod@faundrInstala o mod do Faundr: aviso em 80% e 95% do contexto e dos limites, e a faixa acima do prompt (se ligada aqui).