Memória

A Memória é o que o agente sabe do seu projeto de uma sessão para a outra: as regras que ele deve seguir, as decisões que o time já tomou e as preocupações que ficaram para revisar.

Sem ela, cada conversa com o agente começaria do zero, e ele poderia propor de novo o que vocês já descartaram ou quebrar um combinado do time.

Abas

Regras e decisões têm os filtros Ativas, Para revisar e Obsoletas. Preocupações têm Abertas e Resolvidas.

A etiqueta agente marca o que vai para o agente. Agente, ao editar marca o que vale só para alguns arquivos e chega antes de ele editar um deles.

Regra ou decisão?

• Regra é uma ordem que vale sempre, em qualquer parte do trabalho: "nunca apague os tokens de outra conta", "auth fica no Supabase". Ela vai para o agente em toda sessão, e também para os subagentes que ele abre.
• Decisão é uma escolha feita num momento, com o motivo: "Inter como fonte de texto porque a do sistema ficou feia". Ela importa quando o trabalho passa por aquele assunto.

Se uma decisão virou algo que deve valer sempre, transforme em regra: faundr memory-edit "<trecho do título>" --rule.

Quando cada uma chega ao agente

O espaço do início da sessão é pequeno, então o Faundr entrega cada coisa na hora certa:

Tudo isso roda no seu computador, sem IA e sem internet: o Faundr guarda uma cópia da memória em .faundr/painel/memory.json no começo da sessão.

Criar pelo painel

Use Nova regra, Nova decisão ou Nova preocupação. No formulário de regra ou decisão:

• Título: a regra em uma frase.
• Detalhes e porquê: o contexto. Uma regra com o porquê é seguida com mais critério.
• Vale só para estes arquivos: um caminho por linha. Pode ser uma pasta (src/server), um arquivo ou um padrão com * e **. Com arquivos, a regra chega ao agente só quando ele for editar um deles, em vez de ocupar espaço em toda sessão.
• Deixar como proposta: a regra fica guardada, mas não vai para o agente até alguém clicar em Confirmar. Use quando quiser discutir com o time antes.

Criar pelo agente

/faundr:rule Toda rota do servidor confere o acesso ao projeto, em src/routes/api
/faundr:decision Pagamentos pelo Stripe porque aceita Pix
/faundr:concern O login pode ficar lento — revisar quando tiver mais usuários

O agente também registra sozinho:

• Decisões enquanto trabalha. Uma decisão nova fica ligada aos arquivos que a sessão editou (quando são poucos), para chegar na próxima vez que alguém mexer neles. Se ela parece com outra que já existe, o Faundr avisa, e o agente pode aposentar a antiga.
• Regras que você diz no chat. Frases como "a partir de agora…", "nunca…" ou "cuidado com…" fazem o Faundr sugerir ao agente registrar uma regra do time. Assim ela não fica só naquela conversa.

Mudar uma decisão

Quando uma decisão substitui outra, a antiga fica obsoleta e as duas ficam ligadas ("substitui"). Pelo agente:

faundr decision "Fonte Geist no lugar da Inter" --why "mais legível" --replaces "Inter como fonte"
faundr memory-edit "<id ou trecho do título>" --obsolete
faundr memory-edit "<id ou trecho do título>" --file "src/styles.css"
faundr memory-edit "<id ou trecho do título>" --global

Os ids aparecem em faundr board --memory.

Regras que o próprio código confere

Algumas regras proíbem algo que dá para achar no texto do código, como "não usar console.log" ou "não usar a biblioteca axios". Para essas, a regra pode ter um padrão proibido. Com ele:

• o Faundr avisa o agente antes de uma edição que traga o padrão;
• a checagem de qualidade aponta onde o padrão já existe no código.

Peça ao agente, por exemplo: /faundr:rule Não usar axios, use o fetch do cliente em src/lib/api.ts. Ele mesmo monta o padrão.

Para as regras que não dá para conferir pelo texto, use /faundr:memory-check: o agente lê o código procurando contradições com as regras e decisões e anota cada uma como preocupação, com o arquivo e o que fazer. Ele também arruma a memória: propõe ligar decisões aos arquivos, juntar as repetidas, aposentar as que foram substituídas e transformar em regra o que vale sempre. Só muda com o seu OK.

O detalhe de um item

Clique num item para abrir o painel lateral. Lá você pode:

• Confirmar uma proposta;
• Editar o texto e os arquivos;
• Ligar a outro item com uma relação (implementa, depende de, justifica, afeta, substitui, faz parte de…);
• Tornar obsoleta quando a regra não vale mais, ou Reativar;
• Excluir.

O detalhe mostra também a confiança (explícita, quando alguém disse; inferida, quando o agente deduziu; ambígua) e a origem.

Numa preocupação, o detalhe tem Marcar como resolvida, Reabrir e o comando para resolver pelo agente (/faundr:resolve P-n).

Boas práticas

• Regras curtas e verificáveis. "Use o componente Button de src/components/ui" funciona melhor que "mantenha o código organizado".
• Sempre com o porquê. O agente segue melhor quando entende o motivo, e o time também.
• Ligue a arquivos o que é local. Uma regra que só importa para o banco não precisa ocupar espaço em toda sessão.
• Regra é para o que vale sempre. Se toda decisão virar regra, o início de cada sessão fica pesado.
• Torne obsoleto em vez de excluir. O histórico de decisões ajuda a entender por que o projeto é como é.

Comandos