Context Hygiene
A prática mensal de auditar o Context Index para identificar desatualização, redundância e lacunas, a fim de manter a qualidade do conhecimento consumido pelos agentes.
Definição
Context Hygiene é a prática mensal de auditar o Context Index para identificar desatualização, redundância e lacunas. A qualidade da saída dos agentes se degrada quando a base de conhecimento que eles consomem contém informações desatualizadas — schemas de API obsoletos, decisões arquiteturais superadas ou documentação de domínio defasada. O Context Hygiene previne essa degradação por meio de uma revisão sistemática.
A cerimônia é de responsabilidade do Context Architect e geralmente dura de duas a quatro horas, dependendo do tamanho do Context Index.
As atividades incluem:
- Remover conteúdo obsoleto — identificar e arquivar schemas de API para endpoints desativados, documentação de biblioteca desatualizada, registros de decisão arquitetural superados e exemplos de código que referenciam padrões obsoletos. Deixar conteúdo obsoleto no Context Index arrisca que os agentes gerem código contra interfaces que não existem mais.
- Adicionar contexto para novos sistemas — quando novos serviços, APIs ou módulos foram introduzidos desde a última revisão, adicionar seus schemas, documentação e Golden Samples relevantes ao Context Index. Lacunas na cobertura forçam os agentes a inferir comportamentos em vez de referenciar a documentação, aumentando o Correction Ratio.
- Validar referências de Live Spec — verificar se os Live Specs ativos referenciam fontes atuais no Context Index. Um spec que referencia um schema de API desatualizado produzirá uma saída do agente que compila contra a interface errada. Essa verificação cruzada detecta links quebrados entre os specs e o conhecimento do qual dependem.
- Deduplicar e consolidar — identificar entradas redundantes que cobrem a mesma informação em diferentes formatos ou em diferentes granularidades. A redundância desperdiça Token Budget quando os agentes recuperam conteúdo sobreposto e aumenta o risco de informações conflitantes.
A cadência é mensal porque o desvio do Context Index é gradual — entradas individuais não ficam obsoletas da noite para o dia, mas ao longo das semanas o efeito cumulativo é mensurável. Equipes com bases de código em rápida evolução ou mudanças frequentes de API podem se beneficiar de revisões quinzenais.
O Context Hygiene se insere na cadência mensal de cerimônias mais ampla, juntamente com o Boundary Audit e a Revisão FinOps.