> ## 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.

# Planejamento e permissões

> Planeje antes de editar e escolha como o agente solicita aprovação para ferramentas.

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>;

Use o planejamento para combinar uma abordagem antes da implementação e as permissões para decidir quais ações exigem aprovação. Na primeira tarefa, escolha **Sempre perguntar** para examinar alterações de arquivos e comandos quando forem solicitados.

## Planeje antes de editar

Para combinar uma abordagem antes de alterar arquivos, abra o menu **+** e escolha **Rascunhar um plano** antes de enviar a solicitação. O agente pode investigar o projeto e propor um plano, mas o modo de planejamento restringe a edição. Refine o plano na conversa e escolha **Implementar o plano** para prosseguir. Para o [exemplo de checkout](/pt/docs/mka1-code/first-task), você pode pedir:

> Identifique os arquivos e testes afetados pela inclusão de suporte a quantidades. Proponha um plano antes de editar.

### Revise o plano

Um plano útil identifica arquivos afetados, comportamento a alterar e verificações do resultado. Para o checkout, deve localizar cálculo e testes, explicar o efeito da quantidade e propor o mesmo teste de regressão antes e depois da edição.

Resolva premissas antes de escolher **Implementar o plano**. Por exemplo:

> Preserve a representação de preços e o nome da função exportada. Cubra quantidades de um e três. Não altere a integração de pagamentos nem adicione dependências.

O plano define o que fazer; o modo de permissão controla aprovações quando o agente tenta usar ferramentas na implementação.

## Escolha um modo de permissão

O seletor de permissões controla como as solicitações de aprovação são tratadas:

| Modo | Comportamento |
| - | - |
| **Sempre perguntar** | Exige sua decisão quando uma ferramenta solicita permissão para alterar arquivos ou executar um comando. |
| **Automático** | Permite editar arquivos dentro do projeto e executar comandos simples reconhecidos como somente leitura. Outras ações exigem aprovação. |
| **Aceitar arquivos** | Permite editar arquivos dentro do projeto. Solicitações de aprovação de comandos ainda exigem sua decisão. |
| **Ignorar permissões** | Permite ações sem as solicitações habituais de aprovação. O aplicativo pede confirmação ao ativar esse modo, pois ele permite edições, comandos e instalação de dependências sem novas confirmações. |

Regras de permissão salvas também podem afetar as decisões. O modo de planejamento restringe a edição, e hooks de plugins exigem consentimento separado. Os modos de permissão controlam as ações do agente; as permissões do sistema operacional ou do contêiner determinam o que um comando executado pode acessar.

<Frame caption="O menu de permissões explica o que cada modo permite. Sempre perguntar está selecionado.">
  <ScreenshotCrop src="/images/mka1-code/guides/pt/permissions.jpg" alt="Quatro modos de permissão com Sempre perguntar selecionado" width={2720} height={1660} x={810} y={1156} cropWidth={479} cropHeight={395} maxWidth="400px" />
</Frame>

## Responda a uma solicitação de aprovação

O cartão de aprovação identifica a ação proposta. Leia o comando, arquivo ou recurso externo e compare com a tarefa solicitada. Executar um teste é diferente de instalar pacotes ou publicar um resultado, embora ambos possam aparecer no terminal.

1. Expanda a solicitação e confira destino e argumentos.
2. Aprove se a ação corresponder à tarefa ou negue se o escopo estiver errado.
3. Explique na conversa a abordagem desejada caso precise mudá-la.
4. Confira o resultado da ferramenta. Aprovar permite a tentativa; não demonstra que ela funcionou.

O agente também pode parar com uma pergunta de múltipla escolha. Responda para continuar. Uma pergunta ou aprovação pendente pode fazer uma execução agendada mostrar **Precisa de atenção**.

## Reutilize decisões de aprovação

Ao aprovar repetidamente o mesmo comando, o aplicativo pode oferecer uma regra para o repositório ou a conta. Confira o escopo: uma regra do repositório vale para aquele projeto; uma regra da conta pode afetar outros trabalhos locais.

Comece com **Sempre perguntar** para examinar solicitações de alteração e confira regras existentes se uma ação tiver comportamento inesperado. Use **Aceitar arquivos** quando aceitar edições do projeto, mas quiser decidir sobre comandos. Regras salvas e modos mais amplos não substituem a revisão final do diff.

Continue com [Início rápido](/pt/docs/mka1-code/first-task).