Manutenção de Instruções de Agentes
Visão Geral
Mantenha a orientação dos agentes escopada, descobrível e derivada de uma única fonte canônica. Aplique a política de manutenção compartilhada antes de alterar o conteúdo da instrução, adaptadores, implantação ou verificação.
Uso
Use esta habilidade para alterações em instruções globais ou de projeto, arquivos de regras específicos de agentes e a configuração que os expõe. Por exemplo: $agent-instructions add a Codex instruction source.
Passos
- Leia
references/maintenance.mdcompletamente. - Inspecione a hierarquia de instruções existente e todos os caminhos de descoberta afetados pela mudança.
- Escolha uma fonte canônica e mantenha locais específicos do agente como projeções ou adaptadores.
- Atualize todos os instaladores, arquivos gerados, índices e barreiras de verificação que consomem a fonte.
- Verifique cada projeção de agente afetada de forma independente.
Armadilhas
- Colocar orientação condicional em instruções sempre carregadas — toda tarefa paga o custo de contexto; exponha-a como uma habilidade para agentes que suportam divulgação progressiva.
- Tratar mecanismos com nomes idênticos como equivalentes — regras de Markdown do Claude e regras de comando do Codex têm semânticas diferentes; verifique o contrato de descoberta do consumidor.
- Atualizar apenas uma projeção — outro agente mantém silenciosamente comportamento desatualizado; enumere cada consumidor declarado e teste seu destino real.
Restrições
- Mantenha uma fonte canônica para o comportamento de instrução compartilhado.
- Nunca injete uma regra condicional em um arquivo de instrução sempre carregado como um shim de compatibilidade.
- Nunca relate uma projeção como saudável a menos que seu destino real de implantação tenha sido verificado.