M05 — Organizar conhecimento compartilhado, fontes e rotas
Uma fonte entra no sistema pelo julgamento ou pela operação que sustenta. A organização permite chegar ao conteúdo competente, compreender seu alcance e usá-lo na versão adequada. A pasta guarda; a rota conduz; a fonte governa o conteúdo. Essas funções se relacionam sem constituir três cadastros concorrentes.
Use o enquadramento de M01 e o desenho do ambiente de M02. Quando a concepção detalhada do agente for produzida em M03, confronte novamente sua cobertura de conhecimento. Uma reforma focal de acesso pode encerrar aqui, sem redesenhar o agente.
1. Derivar fontes das contribuições
Para cada entrega ou julgamento essencial, identifique o que o agente precisa perceber, saber, distinguir e transformar. Separe quatro contribuições: conhecimento que ensina a julgar; fatos do caso; condição atual que permite continuar; evidência que sustenta uma afirmação. Um manual pode ensinar a avaliar uma entrega, mas não demonstra que ela foi realizada.
Registre as relações necessárias, sem impor uma tabela por arquivo:
| Contribuição do trabalho | Conhecimento e informação requeridos | Fonte ou lacuna | Uso esperado |
|---|---|---|---|
| Comparar alternativas | Critérios, limites e razões | Método suficiente ou conteúdo a desenvolver | Comparação fundamentada |
| Informar situação | Identidade, período e condição vigente | Sistema ou Estado competente | Retrato do recorte consultado |
| Sustentar um efeito | Evento, objeto e resultado observados | Evidência da operação | Alegação limitada ao que foi conferido |
Leia o conteúdo que decide a contribuição. Título semelhante e resultado de busca indicam candidatos, sem provar suficiência. Uma fonte pode sustentar várias operações; uma operação pode exigir fontes com papéis diferentes. Se um julgamento fica sem sustentação, nomeie a lacuna. Se um documento não muda nenhuma contribuição, questione sua presença no contexto.
2. Resolver identidade e autoridade
A autoridade depende do objeto e da afirmação. O regime do contexto deve indicar onde vivem decisões e responsabilidades, originais de conhecimento, dados operacionais e condição atual. Não atribua autoridade a um documento por sua pasta, aparência, posição na busca ou data de modificação.
Antes de combinar retornos, confira: trata-se do mesmo objeto? Qual edição ou período? O texto é original, proposta, histórico ou cópia? Quem tem competência para defini-lo? Qual trecho sustenta a afirmação? Uma decisão aprovada pode prevalecer sobre um rascunho modificado depois; um dado atual do produtor pode superar uma exportação sem alterar o método de interpretação.
Se duas fontes vigentes sustentarem sentidos incompatíveis, exponha a divergência e sua consequência para o trabalho. Resolva pela autoridade competente quando identificável. Se a decisão continuar aberta, preserve o que cada fonte permite afirmar e encaminhe apenas a definição necessária. Não entregue uma mistura aparentemente coerente nem obrigue o destinatário a descobrir o conflito.
Uma fonte inacessível mantém sua identidade e seu papel. A falta de acesso não autoriza recriar o seu conteúdo como se fosse conhecido. Uma alternativa pode permitir parte do trabalho, com a data, cobertura e limitação correspondentes.
3. Distribuir conhecimento comum e específico
Mantenha uma definição comum quando vários agentes precisam do mesmo critério e sua manutenção pertence à mesma origem. Preserve conhecimento específico quando muda a interpretação de um território, usa evidências próprias ou tem atualização independente. A abrangência do uso não define, sozinha, quem mantém.
Por exemplo, um critério comum de clareza pode servir a agentes de atendimento e de conteúdo. A política de resolução de um atendimento pertence ao seu domínio. Reescrever o critério comum em cada kit cria manutenção concorrente; forçar todas as políticas em uma fonte transversal dificulta encontrar o que decide cada caso.
Uma fonte mista pode permanecer inteira se suas partes precisam ser compreendidas juntas. Separe quando houver consumo ou manutenção próprios, conservando as relações. Procedimento, referência e Skill podem compartilhar critérios: o procedimento organiza uma execução determinada; a referência desenvolve o saber; a Skill incorpora uma transformação reutilizável. M04 desenvolve o conteúdo e M09 a transformação em Skill.
4. Declarar a relação com a origem
| Relação | Contrato de conteúdo | Consequência da mudança |
|---|---|---|
| Original | Identidade e conteúdo mantidos na casa competente | Rever consumidores pertinentes ao alcance alterado |
| Cópia | Reprodução declarada, integral ou delimitada | Comparar com a edição de origem e atualizar segundo o contrato |
| Espelho | Cópia com compromisso explícito de fidelidade e sincronização | Conferir fidelidade, edição e cobertura; não editar como original independente |
| Aplicação própria | Usa a inteligência de uma origem com escolhas e forma próprias | Avaliar impacto; adaptar somente o que muda sua aplicação |
| Consulta externa | Recupera conteúdo do produtor no momento pertinente | Conservar identidade, período, acesso e alcance do retorno |
Identifique origem recuperável, relação, edição utilizada e manutenção necessária. Não imponha versionamento numérico ao dado que é identificado por período ou evento. A aplicação tem versão própria e deve permitir reconhecer quais contribuições incorporou. Uma adaptação com alterações substantivas não pode se apresentar como espelho fiel.
Ao corrigir, altere a casa competente. Se a correção está fora da autoridade presente, preserve o diagnóstico e encaminhe o ajuste; pode corrigir a aplicação local autorizada sem falsificar a origem. M13 determina prioridade e propagação gerencial; M07 organiza a presença física das relações.
5. Separar acervo e contexto
O acervo é o conjunto disponível; o contexto é o conteúdo que chega à IA naquela ocorrência. Um arquivo existente não garante leitura. Defina o consumo pela contribuição:
- Permanente: o que deve governar a atuação comum e precisa estar presente desde a entrada.
- Integral sob demanda: um raciocínio ou método cuja unidade é necessária à aplicação.
- Seletivo: trecho que conserva significado, condições e exceções suficientes.
- Consulta atual: fato ou situação a recuperar no produtor no momento pertinente.
Preserve regra, condição, razão e exceção como unidade de interpretação. Um trecho que diz “aprovar quando houver confirmação” perde o sentido se a fonte distingue quem confirma e qual evidência serve. Resumos que eliminam essas relações reduzem o arquivo e empobrecem a decisão.
Quando o ambiente limitar arquivos ou contexto, selecione e exponha conjuntos coerentes. Dividir, consolidar ou recuperar sob demanda são decisões de implementação, a conferir em M11. Mover documentos para uma pasta ou citar seus nomes não cria um mecanismo de recuperação.
6. Escrever uma rota que permita chegar e interpretar
Comece pela pergunta de trabalho. Investigue o percurso com os recursos disponíveis e escreva somente interfaces e propriedades observadas. Uma linha basta para uma fonte inequívoca com leitura direta. Casos com relações, homônimos, períodos ou cobertura parcial exigem transferir a receita.
Uma rota suficiente informa, na medida da dificuldade:
- A necessidade atendida e a identidade do objeto, incluindo como separar edições e homônimos.
- A fonte competente, o ponto de entrada e o papel de cada fonte auxiliar.
- O percurso de consulta, filtros ou vínculos, o cadastro que armazena a ligação e a cobertura necessária.
- O conteúdo a ler e a interpretação que autoriza a conclusão.
- A alternativa praticável, seu limite e a condição que exige recuperar a fonte principal.
- A mudança que pede revisão e onde preservar a evidência ou a condição atual.
Não congele resultados voláteis dentro da receita. Se o sistema exige paginação, cubra o recorte antes de concluir sobre o conjunto. Se a ligação está registrada apenas no cadastro de origem, consulte esse cadastro. Exemplo ilustrativo: se cada demanda registra quais agentes participam dela, consulte as demandas para descobrir os trabalhos de um agente; o cadastro do agente pode não conter a lista inversa. O percurso depende da estrutura encontrada, não de uma relação presumida no template. Uma associação entre recursos não prova seu uso; para alegar uso, procure evento ou registro correspondente ao mesmo objeto e período.
Um retorno vazio informa o que a consulta encontrou. Confira identidade, filtro, cobertura e acesso antes de inferir ausência no recorte. Mesmo uma busca adequada não demonstra inexistência universal.
7. Tratar mudança e insuficiência
Quando mudar fonte compartilhada, identifique consumidores conhecidos e a parte que cada um usa. Diferencie relação direta, cópia e aplicação própria. Compare conteúdo material, atualize o que cabe e confira a edição recebida e sua aplicação no consumidor; a data do arquivo distribuído não comprova isso. M13 — Operar, gerir e evoluir o conjunto define como conduzir pendências e M15 como ensaiar a propagação.
Classifique a insuficiência pelo próximo trabalho que resolve:
| Situação | Próxima operação |
|---|---|
| Fonte conhecida, acesso ausente | Recuperar acesso ou usar alternativa com limite explícito |
| Busca sem identidade ou cobertura suficientes | Corrigir o percurso antes de concluir |
| Elementos suficientes, distribuídos | Compor a contribuição e preservar papéis e origens |
| Conhecimento não encontrado no recorte examinado | Especificar conteúdo a desenvolver em M04 — Desenvolver a inteligência do trabalho |
| Autoridades em conflito material | Confrontar e resolver a definição competente |
| Fonte histórica | Conservar função histórica e localizar a aplicável ao caso |
A passagem para desenvolver conteúdo deve explicar contribuição faltante, materiais lidos, fatos sustentados, hipóteses, conceitos ou critérios necessários e resultado que demonstraria suficiência. Uma especificação de conhecimento ainda não é o conteúdo produzido.
8. Exemplo e conferência independente
Exemplo ilustrativo: um agente prepara a revisão de uma edição de oficina. O cadastro resolve identidade; o contrato aprovado define condições; o método ensina a revisão; os vínculos identificam recursos associados; os eventos indicam execução no período. A rota localiza a edição, lê o contrato, consulta o cadastro que registra quais recursos estão associados à oficina e confronta eventos pelo mesmo identificador. Se a exportação termina antes do período final, limita a conclusão à cobertura disponível. Não substitui o contrato por uma proposta mais recente nem transforma recursos associados em recursos usados.
Um consumidor deve conseguir partir da entrada normal, descobrir a rota, recuperar a fonte correta e aplicar seu conteúdo sem o construtor, o plugin de autoria ou uma explicação adicional do autor. Confira os riscos materiais do caso: edição, autoridade, vínculo, cobertura, conflito ou indisponibilidade. Não é preciso fabricar todos os riscos em toda consulta.
Preserve fora da fonte operacional a pergunta, os recursos disponíveis, a versão recebida, o percurso, o resultado, a intervenção e o limite. Se falhar, corrija a camada responsável: conteúdo, rota, presença, acesso ou interpretação. A arquitetura está suficiente quando os julgamentos essenciais têm sustentação ou dependência específica e o consumidor consegue usá-la no recorte declarado.
9. Aplicação por arquivos: um original, dois consumidores
No exemplo de conhecimento compartilhado, a triagem consulta um original e a comunicação usa uma cópia declarada. Ambos aplicam a distinção entre data desejada, estimativa e compromisso, com formatos locais diferentes. O catálogo registra a relação e cada entrada leva à rota que permite descobrir o conteúdo sem a conversa de autoria.
O arranjo usa catálogo, demanda e melhoria já previstos em M02 — Desenhar o ambiente e o modelo de gestão. Uma única demanda recebe as contribuições e aponta para sua entrega; a melhoria liga origem, consumidores e conferência. Se essas funções já estiverem no template ou em outro sistema suficiente, use-as. Não se cria uma quarta base para fontes nem outra situação por agente.
Para manter o original, examine a mudança autorizada na casa competente. Para consulta direta, confira a edição recuperada numa ocorrência nova; para cópia, substitua a parte declarada e releia o destino. Compare personalizações com sua condição anterior. Registre qual ação foi manual e qual mecanismo foi observado. Uma aplicação própria recebe análise de impacto, mesmo que use a mesma origem.
A prova deve separar: caminho alcançável, conteúdo lido, aplicação correta e operação na plataforma. Um ensaio por arquivos pode conferir os primeiros aspectos no contexto em que foi realizado; dois projetos nativos precisam ser abertos e testados pelo mecanismo efetivo de M11 — Implementar e instalar em cada ambiente. Autorrevisão não é consumo independente. M15 — Conferir o sistema em uso conserva os critérios de aceitação e M13 — Operar, gerir e evoluir o conjunto a pendência de quem ainda não recebeu.