APC deve ser seguro para clonagem, APX deve ser local à máquina
Decida onde os dados pertencem fazendo uma única pergunta.
Estes dados sobreviveriam a uma nova clonagem em outra máquina?
Se sim, coloque no APC. Se não, coloque no APX.
Esta regra mantém sua stack íntegra. O APC permanece portátil. O APX permanece útil na máquina que executa o trabalho. Quando essas camadas se confundem, os projetos tornam-se difíceis de compartilhar e de auditar.
APC é o contrato do projeto. APX é o runtime.
Os dados do APC são seguros para clonagem. Outro desenvolvedor ou máquina deve conseguir lê-los imediatamente após um git checkout. Eles devem ser passíveis de revisão no git.
Bons exemplos de APC: • AGENTS.md para contratos de repositório • .apc/project.json para identidade do projeto • .apc/agents/ para funções de agentes • .apc/skills/ para habilidades reutilizáveis • .apc/mcps.json para dicas compartilhadas
Os dados do APX são locais à máquina. Estes dados permanecem na máquina ou são reconstruídos nela. É o estado de execução, não um contexto portátil.
Bons exemplos de APX: • Configuração de runtime em ~/.apx/config.json • Modos de permissão locais • Sessões e logs de mensagens • Caches locais • Segredos por máquina
Um repositório não deve impor a configuração local de uma pessoa a todos os outros.
Quando o APC permanece seguro para clonagem, você pode revisar a estrutura do projeto sem arquivos ocultos. Você pode comparar (diff) instruções em vez de perseguir efeitos colaterais.
Quando o APX permanece local à máquina, o runtime se adapta sem alterar o projeto. Uma máquina usa um modo de permissão diferente, enquanto outra mantém um histórico mais longo. O contrato do projeto permanece o mesmo.
Antes de adicionar um novo arquivo, faça estas três perguntas:
- Cada ferramenta compatível precisa ler isso? Coloque no APC.
- Isso descreve o projeto em vez da máquina? Coloque no APC.
- Isso depende de credenciais locais ou de uma execução recente? Coloque no APX.
Exemplos: • Uma nova função de agente? APC. • Um token de bot do Telegram? APX. • Uma nota sobre regras de revisão do projeto? APC. • Um log da última conversa? APX.
O APC carrega o que sobrevive a uma clonagem. O APX carrega o que importa apenas na máquina atual. Esta regra simples mantém o sistema saudável.
Fonte: https://dev.to/agentprojectcontext/apc-should-stay-clone-safe-apx-should-stay-machine-local-59n9
Comunidade de aprendizado opcional: https://t.me/GyaanSetuAi