# Atualizar ou migrar preservando o trabalho

Atualização aplica uma diferença a componentes existentes. Migração muda seu destino ou mecanismo, preservando identidade, contribuição e continuidade. Não são reinstalações cegas. Comece pela diferença pedida, origem competente e alvo autorizado; mantenha o que continua válido.

## Distinguir o que mudou

Recupere edição de origem, registro da instalação anterior, conteúdo atual e novo conteúdo quando houver. Compare corpo e relações, além do cabeçalho. Versão igual pode esconder alteração local; versão diferente pode mudar apenas uma parte. Fonte atual inacessível não prova que a antiga é vigente nem autoriza apagar trabalho.

A comparação útil tem três pontos: origem anterior aplicada; conteúdo atual no destino, com mudanças locais; origem nova. Quando faltar um ponto, registre o limite e confronte a diferença possível, sem inventar histórico. Para cópia literal, igualdade de bytes/conteúdo demonstra correspondência; para adaptação, examine variação declarada e função.

| Classe | Tratamento |
|---|---|
| Componente estático idêntico à origem pretendida | Preservar; não regravar por ritual nem criar outra unidade |
| Estático sem mudança local, com edição nova pertinente | Preservar anterior útil e aplicar diferença autorizada, conferindo consumidores |
| Conteúdo adaptado ou alterado localmente | Mostrar diferença e origem; reconciliar no alcance, mantendo contribuição válida e variação reconhecível |
| Estado, demanda, resultado, registro ou dado corrente | Preservar condição e patrimônio; mudar somente o que o próprio trabalho exigir |
| Arquivo novo com nome de componente já usado | Investigar identidade/colisão antes de criar outro original ou sobrescrever |
| Origem/efeito indeterminado | Consultar e delimitar a dependência; não presumir sincronização ou repetir ação às cegas |

Não preencha a tabela inteira em toda operação. Use as distinções para produzir uma decisão e ação proporcionais. Pedido de atualizar não exige transferir novamente o conjunto que já está correspondente.

## Preparar e aplicar a diferença

Identifique contribuição afetada, componentes/cópias e consumidores materiais. Preserve captura anterior útil com origem e edição, fora da condição vigente. Defina conferência e retorno possíveis antes da substituição relevante; não confunda guardar anterior com manter duas fontes atuais.

Aplique no alvo autorizado, sem ampliar responsabilidade, preferências globais ou efeito externo. Atualize referências relativas, identidades, entradas e instruções pertinentes; não considere arquivo novo suficiente se a entrada continua usando o antigo. No perfil Codex, confronte `Plugin-Couto-IAS/skills` e suas cópias em `.agents/skills`: origem distribuída e cópia nativa precisam conservar correspondência ou variação explícita. Modificação só numa cópia não se resolve apagando-a em silêncio.

Se houver conflito de mandato ou política, prepare alternativa concreta para a competência correspondente. Conflito puramente técnico que a ordem já cobre pode ser reconciliado preservando conteúdo e registrando a variação, sem reconfirmação genérica. Se não houver condição para integrar um componente, conclua os independentes e mantenha o resultado válido, com uso assistido quando suficiente.

No nosso conjunto, o Estado inicial da distribuição não substitui o Estado em uso. Dados das demandas e registros não são regenerados do pacote. Uma correção de método pode exigir corrigir também um produto errado ou condição falsa; execute essa consequência somente no alcance coberto, preservando o ocorrido. Não apague evidência para fazer parecer que nunca houve falha.

## Migrar sem perder identidade

Confirme origem, destino e o significado da mudança: nova casa de manutenção, cópia de distribuição, ambiente de uso ou histórico. Mover uma pasta por si só não muda autoridade nem função do agente. Preserve IDs, fontes competentes e a relação entre estado e resultados.

Mapeie entrada, núcleo, conhecimento, Skills, acesso, persistência e consumidores para o novo mecanismo. Copie/adapte e confira o destino antes de retirar qualquer aplicação antiga. Exclusão ou mudança de acesso exige autoridade correspondente; não são consequência automática da cópia. Atualize as rotas cobertas e identifique o que permanece histórico, cópia ou dependência externa. Um arquivo novo no destino não prova que todos os consumidores antigos foram atualizados.

Não leve credenciais ou dados de outro contexto sem necessidade e autorização. Preserve separação de pessoas/projetos. Quando o meio muda de suporte nativo para leitura assistida, declare a realização e esforço; não mantenha rótulo de automatismo que deixou de corresponder.

## Conferir, retornar e registrar

Leia o salvo, confronte composição e faça a operação material afetada. Se mudou uma regra comum, identifique edição recebida e resultado que demonstra aplicação, além de hash/cabeçalho. Retomada deve recuperar último resultado válido e decisões; não escolher apenas o arquivo mais recente por data de gravação.

Se a atualização falhar, preserve a última condição válida e registre diferença/causa sustentada ou hipótese. O retorno restaura componentes estáticos pertinentes quando isso for seguro, sem apagar demandas, decisões ou resultados novos que surgiram depois. Um retorno que criaria perda pede reconciliação localizada.

Atualize o registro de instalação com origem/edição anterior e atual, destinos, variações, classes preservadas, resultado, conferência e dependência. Registros históricos conservam o que efetivamente examinaram; não são reescritos para fingir edição nova no passado. Encerre no alcance comprovado. A possibilidade de melhorar outros agentes não autoriza propagação universal nem obriga repetir exames suficientes sem nova razão.

## Reconciliar os destinos Cowork

Consulte o mapa do [registro de instalação](registro-instalacao-cowork.md): arquivo local, campo do projeto, conhecimento adicionado e Skill enviada são destinos distintos. Compare cada cópia afetada com a origem anterior e a nova. Uma Skill atualizada na pasta não atualiza por si o exemplar da conta; um projeto listado na conta não prova a mesma edição dos arquivos locais.

Na falta da origem anterior, preserve a adaptação e apresente a diferença possível. Reaplique somente componentes abrangidos, confira o salvo e repita a operação material afetada e a retomada. Não reverta Estado ou resultado novo junto com componente estático. Se o projeto exige que a pessoa adicione uma fonte, entregue a fonte completa e seu destino; mantenha essa passagem pendente até observação correspondente.

## Ambiente da instalação completa

Na instalação completa do Couto-IAS, este perfil é uma parte da entrega. Reproduza também o [template exato](reproduzir-template-exato.md): IAs, cadastro Agentes com Auditoria dos componentes, Tarefas dos agentes, melhorias e Sistemas e Produtos vazias. Confira separadamente a presença dos componentes, o plugin, o Notion e o primeiro uso. Uma solicitação focal conserva seu alcance. Em ambiente existente, preserve os IDs, registros, fontes e adaptações e registre o que foi acrescentado ou ficou diferente.