O Contexto Global Pertence Fora do APC

O APC é a camada de contexto portátil. O APX é a camada de runtime local.

Para mantê-los saudáveis, siga uma regra. Se algo deve sobreviver a um novo clone, coloque no APC. Se depender de um usuário, máquina ou processo específico, mantenha fora do APC.

Os projetos crescem e a tentação vem junto. Você pode querer adicionar mais uma configuração ou um caminho local. Se você não for rigoroso, seu repositório se tornará um depósito de dados de máquina. Isso torna o repositório frágil.

O APC contém o significado de propriedade do projeto. É o contrato compartilhado que um repositório carrega.

Um bom conteúdo de APC inclui:

  • Identidade do projeto
  • Papéis de agentes
  • Habilidades reutilizáveis
  • Memória de projeto curada
  • Dicas de MCP em nível de projeto
  • Instruções para todo o repositório no AGENTS.md

Um colega de equipe ou uma nova máquina deve ler esses fatos logo após um checkout.

O contexto global é diferente. Ele pertence a um usuário ou a uma estação de trabalho.

Exemplos de contexto global:

  • Chaves de API
  • Preferências do editor
  • Aliases locais
  • Caminhos de ferramentas específicos da máquina
  • Memória de runtime privada
  • Caches
  • Transcrições de sessão
  • Logs de mensagens

O APX mantém esse estado local. Ele armazena o estado de runtime em ~/.apx/. Isso mantém o projeto compartilhável.

Misturar essas camadas causa três problemas:

  1. A portabilidade quebra. Um repositório que depende de configurações locais é difícil de confiar.
  2. As revisões ficam ruidosas. Pull requests devem mostrar decisões do projeto, não bagagens da estação de trabalho.
  3. Segredos vazam. Armazenar detalhes locais torna fácil commitar os arquivos errados.

Antes de adicionar uma configuração, pergunte isto: Outro colaborador precisaria disso imediatamente após o clone?

Se sim, use APC.

  • Um agente revisor para cada clone? APC.
  • Uma chave de API pessoal? Não é APC.
  • Uma decisão de projeto sobre permissões? APC.
  • Um caminho de navegador local? Não é APC.
  • Uma dica de MCP compartilhada? APC.
  • Um cache de execução? Não é APC.

Esta regra torna a automação duradoura. O APC oferece significado portátil. O APX oferece estado local.

Mantenha essa distinção clara. Isso torna sua stack mais fácil de depurar, compartilhar e mover entre ferramentas.

Use o APC para o contexto que viaja com o repositório. Se for pessoal ou transitório, mantenha-o local.

Source: https://dev.to/agentprojectcontext/global-context-belongs-outside-apc-4fg8

Optional learning community: https://t.me/GyaanSetuAi