analyze_change_impact“Se eu mexer aqui, o que quebra?”
O QUE COMBINA
Chamadores, telas, parâmetros, regras, invariantes e PJs anteriores.
YZIDRO KNOWLEDGE / API & MCP
Conheça a plataforma que transforma evidências em conhecimento institucional e ajuda seu assistente de IA a investigar bugs, planejar PJs e avaliar o impacto de cada mudança.
CONHECIMENTO OFICIAL / APOIO À DECISÃO / ACESSO CONTROLADO

01 / SOBRE
O Yzidro Knowledge organiza conhecimento institucional e o disponibiliza para consultas por API e por MCP.
MCP significa Model Context Protocol: um protocolo que permite a um assistente compatível consultar ferramentas externas. Aqui, ele conecta o assistente ao conhecimento oficial publicado, suas relações e, quando permitido, às evidências de origem, ao código, ao histórico e aos projetos em andamento.
Entenda o fluxoAPOIO À DECISÃO
Três ferramentas reúnem as fontes em uma resposta com fatos, riscos e lacunas, para você decidir com as evidências à vista.
analyze_change_impactO QUE COMBINA
Chamadores, telas, parâmetros, regras, invariantes e PJs anteriores.
diagnose_issueO QUE COMBINA
Sintoma, tela candidata, mudanças recentes, hotfixes e bugs parecidos.
plan_projectO QUE COMBINA
Requisitos × regras e código, precedentes, riscos e perguntas abertas.
O resultado orienta a análise, não substitui a leitura das fontes. Veja como pedir
02 / O PROCESSO KNOWLEDGE
Explore cada etapa e descubra como as fontes se transformam em conhecimento consultável.
EXPLORE A JORNADA ESCOLHA UMA ETAPA
A partir do código do PJ, a coleta reúne informações disponíveis no ERP, Wiki e histórico de Git/Bitbucket, conforme os conectores configurados. O título e os detalhes do projeto podem ser preenchidos pelos dados encontrados no ERP.
O resultado preserva as fontes e os avisos de cobertura. Uma coleta parcial continua identificada como parcial; coletar, por si só, não cria conhecimento oficial.
As evidências capturadas são preparadas para leitura: o conteúdo é normalizado e recebe índices que apontam para a origem, a coleta e os registros originais. Os arquivos e hashes preservam a rastreabilidade.
Um índice de arquivos ajuda a localizar código para consulta posterior. A referência a um arquivo não comprova, sozinha, seu comportamento.
O sistema seleciona trechos das evidências e prepara uma memória inicial do projeto, com resumo, observações fundamentadas, fontes e limitações. Quando documentadas, versões de saída e eventos da evolução também são registrados.
A seleção tem limites e pode omitir fontes. A memória não transforma cada observação em regra institucional; evidências insuficientes produzem um rascunho para revisão.
A pré-análise pode sugerir classificações com base nas evidências, citando fonte e trecho. O catálogo ajuda a reutilizar nomes; projetos e entidades podem ter várias classificações.
As sugestões passam por decisão autorizada. Apenas tags aprovadas são usadas nos filtros; tags em comum não criam relações entre entidades. O acervo publicado também pode ser classificado por uma execução específica e revisada.
Memórias com confiança média ou alta podem ser revisadas, aprovadas e publicadas automaticamente após validações, desde que o solicitante mantenha as permissões e escopos necessários. Bloqueios impedem a publicação automática.
Confiança baixa ou desconhecida exige revisão manual. Nesse fluxo, a aprovação e a publicação são etapas separadas, com histórico e verificação da prévia.
Após a publicação, a base oficial pode ser consultada pela API e por clientes MCP autorizados. A busca encontra entidades; a leitura de conteúdo, origens e relações ajuda a entender o contexto e a evolução documentada.
Com acesso completo, é possível navegar até fontes da coleta, inclusive as omitidas da pré-análise, consultar a Wiki atual identificada e ler código e histórico do repositório. Também é possível ver requisitos e análise de um PJ ainda não publicado, como dados provisórios. Captura, dado provisório, fonte atual e conhecimento aprovado têm significados diferentes.
A busca e a análise são limitadas: ausência de um resultado não prova que a informação não existe. As consultas MCP não iniciam coleta, análise ou publicação oficial. A única gravação é a v0 candidata, feita a pedido e com permissão específica, que não se torna conhecimento oficial.
VERSÕES E EVOLUÇÃO
O Knowledge preserva a evolução documentada de um recurso para ajudar a entender o que mudou e em qual contexto.
Para o mesmo recurso comprovado, a versão 56 é apresentada primeiro, junto à evolução anterior e aos complementos relevantes.
A versão de saída documentada identifica o contexto do ERP. Já version é a revisão interna da entidade no Knowledge; são informações diferentes.
Na busca MCP, itens que cobrem mais termos da pergunta vêm primeiro. Em caso de empate, a versão de saída numérica documentada desempata, da maior para a menor. Versões ausentes, divergentes ou não comparáveis aparecem depois.
Ao comparar o mesmo recurso, consulte conteúdo, origens e relações. Cite a versão e o PJ de cada evento quando disponíveis. Uma versão posterior não invalida automaticamente todos os detalhes anteriores, e semelhança de texto não comprova que dois registros sejam o mesmo recurso. O histórico de cada entidade mostra o que mudou entre as revisões.
Versões ausentes, conflitantes ou não comparáveis e cobertura parcial devem ser informadas. Uma correção precisa estar documentada: não se presume que ela alcança versões intermediárias ou anteriores. A busca é limitada e não garante encontrar todo o histórico.
03 / POSSIBILIDADES
Da descoberta à decisão, respeitando as permissões da sua conta.
Pergunte em linguagem natural e filtre por regras, decisões ou invariantes, com os resultados mais próximos primeiro.
search_business_knowledgeExplore entidades, processos e relações registradas ou monte um pacote de contexto para uma tarefa.
build_context_packVeja quem alterou um arquivo, os PJs citados e o diff de cada PR, além das fontes de cada coleta.
get_file_historyFontes, pistas e dados provisórios apoiam a decisão; não são, por si só, conhecimento institucional aprovado. Como ler as respostas
PADRÕES DO DESENVOLVIMENTO
O assistente consulta os manuais da Wiki enquanto você implementa e cita a página de cada padrão que aplicar.
get_development_guidesONDE PROCURA
Manuais, Time de Evolução e Time de Sustentação, inclusive no conteúdo das páginas.
implementar-com-padroesO QUE ENTREGA
Checklist dos padrões com links, plano passo a passo, divergências com o código, riscos e passos de commit.
revisar-prO QUE CONFERE
Requisitos do PJ, impacto e desvios dos manuais, com a página de referência de cada ponto.
No Claude Code: /mcp__yzidro-knowledge__implementar-com-padroes. Veja como usar
CASOS DO TIME N3
Os atendimentos do time N3, do Desenvolvimento, no canal do Discord viram casos pesquisáveis: problema, erro exato, causa e solução, sem nomes nem dados de clientes.
search_support_casesONDE PROCURA
Mensagem de erro, código, sintoma ou número do chamado, nos casos destilados de todo o histórico do canal.
read_support_caseO QUE ENTREGA
Causa, solução, passos e ressalvas do caso, e a conversa original higienizada, sem credenciais, acessos nem dados de clientes.
Avaliação automáticaQUEM DECIDE
A IA lê cada atendimento e classifica: resolvido, parcial, não resolvido ou indefinido, com grau de confiança. Ninguém precisa aprovar caso a caso; marcar a solução no Discord é opcional e só reforça.
Casos são precedentes, não regra oficial: confira versão e contexto antes de aplicar. Veja como pedir
04 / COMO FUNCIONA
Conecte um cliente MCP compatível e consulte a base no contexto do seu trabalho.
Configure no cliente o endereço público do servidor MCP, terminado em /mcp. O guia mostra como.
Use OAuth no cliente e aprove os escopos. Também é possível usar uma credencial MCP pessoal. Bugs, planejamento e código exigem todos os escopos.
Peça em linguagem natural ou use os fluxos prontos para investigar um bug, planejar um PJ, avaliar impacto, revisar um PR ou implementar seguindo os padrões do time.
PARA DESENVOLVEDORES
Comece pelo guia do MCP ou consulte os endpoints REST, seus parâmetros e contratos na documentação interativa.