> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mka1.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Memória do projeto

> Salve e aprove preferências do projeto para futuras sessões locais.

export const ScreenshotCrop = ({src, alt, width, height, x = 0, y = 0, cropWidth = width, cropHeight = height, maxWidth = "100%"}) => <div className="not-prose" style={{
  position: "relative",
  overflow: "hidden",
  width: "100%",
  maxWidth,
  margin: "0 auto",
  aspectRatio: `${cropWidth} / ${cropHeight}`
}}>
    <img src={src} alt={alt} width={width} height={height} style={{
  position: "absolute",
  display: "block",
  margin: 0,
  maxWidth: "none",
  width: `${width / cropWidth * 100}%`,
  height: "auto",
  left: `${-x / cropWidth * 100}%`,
  top: `${-y / cropHeight * 100}%`
}} />
  </div>;

A memória do projeto salva instruções para sessões futuras em um projeto local. Ela fica desativada por padrão, e você escreve e aprova cada preferência. Por exemplo, salve uma instrução para incluir um teste de regressão sempre que o agente corrigir um erro.

## Escolha o que lembrar

Use memória para instruções válidas entre tarefas do mesmo projeto: comando de testes, restrição de compatibilidade ou convenção de revisão. Deixe um bug específico ou investigação temporária na sessão. Ativar memória não extrai preferências de conversas anteriores; você escreve e aprova cada texto.

| Preferência | Utilidade |
| - | - |
| “Use o framework de testes existente. Não introduza outro para corrigir um bug.” | Mantém as convenções de testes. |
| “Explique mudanças nas assinaturas públicas antes de editá-las.” | Torna mudanças de interface explícitas. |
| “Se não conseguir executar uma verificação, informe o comando e motivo, sem marcá-la como aprovada.” | Define o conteúdo do relatório de verificação. |

Salve apenas instruções aplicáveis ao projeto. Não inclua chaves de API ou senhas: preferências ativadas são enviadas nas solicitações ao modelo.

## Salve uma preferência do projeto

Com uma conta verificada conectada, abra **Ajustes → Projetos**, selecione a pasta e ative **Memória neste projeto**. Escreva uma preferência, revise-a e escolha **Aprovar e salvar**. Cada conta e pasta tem suas próprias preferências; worktrees separados também têm memórias separadas.

Para um projeto com testes, uma preferência útil especifica a verificação esperada:

> Ao corrigir um erro, adicione um teste de regressão que o reproduza. Execute os testes relevantes após a correção e informe o comando e o resultado.

Salve preferências específicas do projeto. Uma convenção de testes pode orientar sessões futuras, mas você ainda deve conferir a saída real antes de aceitar uma alteração. Para reutilizar a preferência em outro worktree, configure a memória dessa pasta também.

<Frame caption="Uma preferência aprovada do projeto pede um teste de regressão e o resultado real dos testes após cada correção.">
  <ScreenshotCrop src="/images/mka1-code/guides/pt/memory.jpg" alt="Memória do projeto ativada com uma preferência de testes aprovada" width={2720} height={1800} x={975} y={210} cropWidth={1300} cropHeight={1060} maxWidth="100%" />
</Frame>

## Configure o padrão e a exceção do projeto

Em **Ajustes → Projetos**, selecione uma pasta ou use **Adicionar pasta…**. Essa seleção pode ser diferente do projeto aberto em Código: confira a pasta antes de salvar.

Em **Todos os projetos**, a opção de memória por padrão define o estado inicial dos projetos locais da conta. **Memória neste projeto** oferece:

| Opção | Efeito |
| - | - |
| **Padrão (Ativada)** ou **Padrão (Desativada)** | Segue o padrão da conta e mostra seu estado. |
| **Ativada** | Mantém a memória ativa nessa pasta mesmo se o padrão mudar. |
| **Desativada** | Mantém a memória desativada mesmo se o padrão mudar. |

O padrão compartilha a configuração de ativação, não o texto. Um projeto novo começa com uma lista vazia. Worktrees separados também têm listas distintas.

## Edite ou remova preferências

Confira preferências e datas de aprovação nos ajustes do projeto. Edite e aprove novamente quando uma convenção mudar. Use **Buscar preferências** quando a busca aparecer para uma lista maior.

Excluir remove uma entrada. **Limpar memória do projeto** remove todas as preferências da conta e pasta após confirmação, sem mudar a ativação. Desativar preserva a lista e permite revisar ou excluir; adicionar ou editar exige ativar novamente.

Um projeto aceita até 50 preferências, 2.000 caracteres por entrada e 12.000 no total. Ao atingir um limite, reduza ou remova uma entrada em vez de duplicar a mesma instrução.

## Como as preferências são usadas

As preferências ficam no armazenamento local e são incluídas nas solicitações ao modelo enquanto a memória está ativada. Desativá-la mantém as preferências salvas, mas deixa de adicioná-las às solicitações futuras. As conversas anteriores mantêm o texto das preferências que já receberam. O recurso exige login com uma conta e um projeto local; acesso apenas por chave de API e ambientes remotos não oferecem suporte a ele.

### Confira as preferências utilizadas

Se uma preferência esperada não aparecer, confira conta, gateway, pasta e estado efetivo. Outro worktree do mesmo repositório não herda as preferências da pasta original.

Mudar a memória pode interromper um turno local; reenvie a solicitação se necessário. Excluir uma preferência não reescreve conversas que já a contêm. Inicie uma sessão nova se precisar deixar de reutilizar esse texto anterior.

Continue com [Sessões e contexto do projeto](/pt/docs/mka1-code/sessions).