--- titulo: Composição, presença e continuidade do kit versao: "1.1.2" condicao: "edição candidata; operação na conta de destino ainda não conferida" aplica: "Modelo de Gestão de Agentes de IA 1.2.0-rc.1; M07 e M11" consumo: integral ao montar ou implantar um kit; focal na reforma --- # Composição, presença e continuidade do kit O kit organiza o conteúdo e os meios de que um agente precisa para trabalhar e continuar. Sua qualidade depende de presença, acesso e uso, além da organização dos arquivos. Esta fonte orienta o Couto-IAS a compor seu próprio conjunto e os agentes produzidos para a pessoa; cada agente recebe somente as contribuições pertinentes ao seu trabalho. ## Compor por função Distinga entrada, núcleo, repertório, recursos de transformação, meios de atuação e continuidade. A entrada declara identidade e ativa o núcleo. O núcleo orienta percepção e julgamento. O repertório desenvolve conhecimento especializado. Skills realizam transformações reutilizáveis; procedimentos conduzem processos determinados. Ferramentas alcançam dados e efeitos. Estado e registros conservam o necessário entre ocorrências. Uma função pode ser atendida por conteúdo existente, sem arquivo novo. Várias funções podem se compor em um documento quando leitura e manutenção continuarem claras. A separação se justifica quando uma contribuição tem condição de uso, profundidade ou atualização própria. Reproduzir uma árvore inteira não demonstra suficiência. No Couto-IAS, os quatro arquivos da raiz têm funções próprias: AGENTS apresenta e ativa; CLAUDE fornece a entrada correspondente ao mecanismo compatível; Rotas permite chegar ao conteúdo e interpretar seu uso; Estado conserva a condição atual. Fontes reúne orientação e repertório próprio; Modelo conserva o método geral; Skills reúne os recursos distribuídos e seus apoios, conforme a composição da edição recebida. Registros guarda passagens e evidências úteis; Em-produção recebe elaboração; Legado preserva versões substituídas. O arquivo COMECE-AQUI.md orienta a pessoa no primeiro uso; ele não substitui a entrada, o núcleo nem o método de instalação. Os agentes produzidos para o usuário não se acumulam automaticamente em Fontes-Couto-IAS. Sua casa é escolhida pelo objeto, pelo trabalho e pelos acessos reais da pessoa. Preserve a fonte de condição existente quando ela já for competente. ## Tornar o conhecimento presente Para cada contribuição, pergunte: quando precisa agir, como chega ao contexto e com que integridade? Estar numa pasta não significa estar presente. A plataforma pode inserir o texto, importá-lo, mostrar apenas o nome ou recuperar trechos. Uma rota pode oferecer acesso sem garantir leitura, e a leitura pode ocorrer sem aplicação. O núcleo precisa chegar inteiro antes do trabalho que governa. Se já estiver presente e atual, a condição está atendida. Se chegar apenas pelo nome, a entrada deve mandar abri-lo. Se a recuperação fragmentar uma relação essencial entre regra, condição e exceção, obtenha o conjunto suficiente por outro mecanismo. Uma limitação de contexto pede composição e exposição compatíveis, preservando o método. Selecione o repertório pela demanda. Conhecimento de automação não precisa ocupar toda conversa de criação de texto; sua operação precisa estar alcançável quando a solução exigir execução sem pessoa. Fonte atual, dados da ocorrência e método estável têm consumo diferente. A casa de armazenamento e a seleção de contexto são decisões distintas. Na implantação, registre mecanismo de entrada, conteúdo exposto, acesso às especialidades e destino de escrita. Para detalhes de plataforma, use a fonte de implementação. Um pacote ZIP pode distribuir conteúdo sem torná-lo uma Skill nativa disponível. ## Conservar originais, cópias e aplicações O original tem casa e edição identificáveis. Cópia literal conserva origem e acompanha o conteúdo correspondente; uma variação necessária ao ambiente fica declarada. Aplicação usa a inteligência numa forma própria e recebe análise de impacto quando a origem muda. Não se mantém outro original concorrente por conveniência de plataforma. Antes de atualizar, compare origem anterior, conteúdo recebido e conteúdo em uso. Preserve adaptações locais. Mesmo número de versão não demonstra igualdade do corpo. Um Estado com trabalho da pessoa não pode ser substituído pelo exemplar inicial da distribuição. Atualização de instrução e migração de dados são operações diferentes. Ao gravar em ambiente compartilhado, releia o alvo e preserve contribuições fora do recorte. Use condição de versão quando o recurso oferecer. Se surgir contribuição concorrente, confronte as diferenças antes de sobrescrever; uma cópia de conflito pode conter trabalho legítimo. Após retorno indeterminado, consulte o destino antes de repetir escrita que possa criar ou apagar efeito. ## Preservar continuidade suficiente A próxima sessão precisa recuperar objeto, resultado válido, condição, decisões pertinentes, dependências e próximo movimento. Isso pode estar no Estado ou no objeto que já governa a demanda. O Estado do Couto-IAS aponta para essa casa sem manter uma segunda condição manual. Registre apenas o que a entrega e o Estado não preservam suficientemente: contexto difícil de reconstruir, passagem que espera alguém, evidência e razão de uma escolha. Histórico resume o encerrado e remete ao resultado competente. O registro de avaliação não vira regra geral sem julgamento de alcance e autoridade. Uma passagem deve permitir agir: o que se espera do destinatário, material e fontes, resultado já obtido, limite e retorno esperado. O envio e o recebimento têm evidências próprias; escrever um arquivo não demonstra que outro agente o leu. ## Conferir composição e uso Confronte capacidade e conteúdo antes de conferir caminhos. Um kit pode ter todos os arquivos e não ensinar o julgamento necessário. Depois verifique entrada, presença do núcleo, recuperação da especialidade, produção, gravação e retomada. Diga o alcance: composição conferida, conteúdo recebido ou operação realizada. Exemplo ilustrativo: um agente tem um bom método para revisar documentos, mas uma sessão nova recebe apenas seu nome e produz revisão genérica. Reescrever o método não é a primeira correção. Confira se a entrada foi recebida, se ativou o núcleo e se a fonte foi aberta. Se a fonte chegou integralmente e ainda não oferece critério suficiente, a correção muda para conhecimento. O efeito do ajuste é a revisão produzida, com o critério aplicado, além da presença do arquivo. ## Origem de distribuição e instância de uso A pasta recebida do fornecedor e a casa em que a pessoa trabalha são objetos distintos. Antes de iniciar, identifique se o alvo é uma instância nova ou uma instalação com demandas, decisões e adaptações. Uma atualização substitui componentes pertinentes; não reaplica o Estado inicial, não replica dados de outra conta e não faz o trabalho local voltar a zero. No Cowork, registre separadamente instrução da pasta, instrução do projeto, fonte armazenada na conta, pasta conectada e Skill nativa. Cada uma pode ter edição e escritor diferentes. Atualizar o arquivo na pasta não demonstra alteração no campo do projeto nem na Skill enviada à conta. A importação literal `@arquivo` de outro produto só recebe crédito de expansão quando o conteúdo for observado neste destino. Use o mapa e o registro em [perfil Cowork](../Plugin-Couto-IAS/skills/instalar-gestao-de-agentes/references/perfil-cowork.md). A instaladora prepara o conteúdo que depende da pessoa, sem inserir dados da autoria no Estado neutro. A instância mantém sua própria condição e aponta para a demanda competente. Assim, outro contexto pode retomar pelo objeto persistido, além da memória do aplicativo.